تقنية BLE الآمنة

تتضمَّن هذه الوحدة وظائف تتحكّم في اتصال BLE Secure (بروتوكول أمان طبقة النقل (TLS) عبر BLE).

ملخّص

تتضمن هذه الوحدة وظائف تقوم بتنفيذ اتصال TCAT.

تتوفر الوظائف في هذه الوحدة عند تفعيل ميزة BLE Secure API (OPENTHREAD_CONFIG_BLE_TCAT_ENABLE).

تتوفر الدوالّ في هذه الوحدة عند تفعيل ميزة TCAT (OPENTHREAD_CONFIG_BLE_TCAT_ENABLE).

عمليات التعداد
otTcatApplicationProtocol{   OT_TCAT_APPLICATION_PROTOCOL_NONE = 0,   OT_TCAT_APPLICATION_PROTOCOL_STATUS = 1,   OT_TCAT_APPLICATION_PROTOCOL_TCP = 2 }	تعداد يمثل بروتوكول تطبيق TCAT.
otTcatCommandClass{   OT_TCAT_COMMAND_CLASS_GENERAL = 0,   OT_TCAT_COMMAND_CLASS_COMMISSIONING = 1,   OT_TCAT_COMMAND_CLASS_EXTRACTION = 2,   OT_TCAT_COMMAND_CLASS_DECOMMISSIONING = 3,   OT_TCAT_COMMAND_CLASS_APPLICATION = 4 }	تعداد يمثل فئة أمر TCAT.
otTcatStatusCode{   OT_TCAT_STATUS_SUCCESS = 0,   OT_TCAT_STATUS_UNSUPPORTED = 1,   OT_TCAT_STATUS_PARSE_ERROR = 2,   OT_TCAT_STATUS_VALUE_ERROR = 3,   OT_TCAT_STATUS_GENERAL_ERROR = 4,   OT_TCAT_STATUS_BUSY = 5,   OT_TCAT_STATUS_UNDEFINED = 6,   OT_TCAT_STATUS_HASH_ERROR = 7,   OT_TCAT_STATUS_UNAUTHORIZED = 16 }	تعداد يُمثِّل رمز حالة TCAT.

تحديدات النوع
otHandleBleSecureConnect)(otInstance *aInstance, bool aConnected, bool aBleConnectionOpen, void *aContext)	typedef void(* مؤشر للاتصال عند تغيير حالة الاتصال الآمن "بلي".
otHandleBleSecureReceive	typedef otHandleTcatApplicationDataReceive مؤشر للاتصال عند استلام البيانات عبر اتصال بروتوكول أمان طبقة النقل (TLS) بتقنية BLE.
otHandleTcatApplicationDataReceive)(otInstance *aInstance, const otMessage *aMessage, int32_t aOffset, otTcatApplicationProtocol aTcatApplicationProtocol, const char *aServiceName, void *aContext)	typedef void(* مؤشر للاتصال عند استلام بيانات التطبيق من خلال اتصال بروتوكول أمان طبقة النقل (TLS) لبروتوكول TCAT.
otHandleTcatJoin)(otError aError, void *aContext)	typedef void(* مؤشر للاتصال للإعلام باكتمال عملية الانضمام.
otTcatApplicationProtocol	typedef enum otTcatApplicationProtocol يمثل بروتوكول تطبيق TCAT.
otTcatCommandClass	typedef enum otTcatCommandClass يمثل فئة أمر TCAT.
otTcatStatusCode	typedef enum otTcatStatusCode يُمثِّل رمز حالة TCAT.
otTcatVendorInfo	typedef struct otTcatVendorInfo يمثل هذا الهيكل معلومات مورّد TCAT.

الدوال
otBleSecureConnect(otInstance *aInstance)	otError يؤدي هذا الخيار إلى إعداد جلسة بروتوكول أمان طبقة النقل (TLS) مع نظير باستخدام اتصال BLE مفتوح حاليًا.
otBleSecureDisconnect(otInstance *aInstance)	void يوقف الاتصال عبر تقنية BLE وبروتوكول أمان طبقة النقل (TLS).
otBleSecureFlush(otInstance *aInstance)	otError تنظيف المخزن المؤقت للإرسال
otBleSecureGetPeerCertificateBase64(otInstance *aInstance, unsigned char *aPeerCert, size_t *aCertLength)	otError لعرض النظير x509 لشهادة base64 المشفرة.
otBleSecureGetPeerSubjectAttributeByOid(otInstance *aInstance, const char *aOid, size_t aOidLength, uint8_t *aAttributeBuffer, size_t *aAttributeLength, int *aAsn1Type)	otError لعرض قيمة سمة تم تحديدها بواسطة OID من موضوع شهادة x509 من الأقران.
otBleSecureGetThreadAttributeFromOwnCertificate(otInstance *aInstance, int aThreadOidDescriptor, uint8_t *aAttributeBuffer, size_t *aAttributeLength)	otError تعرض قيمة سمة لـ OID 1.3.6.1.4.1.44970.x من الامتدادات v3 لشهادة x509 الخاصة، حيث يتم تعيين الرقم الأخير x على aThreadOidDescriptor.
otBleSecureGetThreadAttributeFromPeerCertificate(otInstance *aInstance, int aThreadOidDescriptor, uint8_t *aAttributeBuffer, size_t *aAttributeLength)	otError تعرض قيمة سمة لـ OID 1.3.6.1.4.1.44970.x من الامتدادات v3 لشهادة x509 من النظير، حيث يتم تعيين الرقم الأخير x على aThreadOidDescriptor.
otBleSecureIsCommandClassAuthorized(otInstance *aInstance, otTcatCommandClass aCommandClass)	bool يشير إلى ما إذا كان مسموحًا لفئة أوامر TCAT بإدراجها.
otBleSecureIsConnected(otInstance *aInstance)	bool يشير إلى ما إذا كانت جلسة بروتوكول أمان طبقة النقل (TLS) متصلة أم لا.
otBleSecureIsConnectionActive(otInstance *aInstance)	bool يشير إلى ما إذا كانت جلسة TLS نشطة (متصلة أو متصلة).
otBleSecureIsTcatEnabled(otInstance *aInstance)	bool يشير إلى ما إذا كان وكيل TCAT مفعَّلاً أم لا.
otBleSecureSend(otInstance *aInstance, uint8_t *aBuf, uint16_t aLength)	otError يتم إرسال حزمة بيانات BLE آمنة.
otBleSecureSendApplicationTlv(otInstance *aInstance, uint8_t *aBuf, uint16_t aLength)	otError يرسل حزمة بيانات BLE آمنة تحتوي على TLV (ملف TLV) لإرسال بيانات التطبيق.
otBleSecureSendMessage(otInstance *aInstance, otMessage *aMessage)	otError لإرسال رسالة BLE آمنة.
otBleSecureSetCaCertificateChain(otInstance *aInstance, const uint8_t *aX509CaCertificateChain, uint32_t aX509CaCertChainLength)	void لضبط مراجع التصديق ذات المستوى الأعلى الموثوق بها
otBleSecureSetCertificate(otInstance *aInstance, const uint8_t *aX509Cert, uint32_t aX509Length, const uint8_t *aPrivateKey, uint32_t aPrivateKeyLength)	void لضبط شهادة X509 للجهاز المحلي باستخدام المفتاح الخاص المقابل لجلسة بروتوكول أمان طبقة النقل (TLS)، باستخدام TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8.
otBleSecureSetPsk(otInstance *aInstance, const uint8_t *aPsk, uint16_t aPskLength, const uint8_t *aPskIdentity, uint16_t aPskIdLength)	void تُعيِّن المفتاح المشترك مسبقًا (PSK) ومجموعة التشفير TLS_PSK_WITH_AES_128_CCM_8.
otBleSecureSetSslAuthMode(otInstance *aInstance, bool aVerifyPeerCertificate)	void تحدِّد هذه السياسة وضع المصادقة للاتصال الآمن بتقنية BLE.
otBleSecureStart(otInstance *aInstance, otHandleBleSecureConnect aConnectHandler, otHandleBleSecureReceive aReceiveHandler, bool aTlvMode, void *aContext)	otError يؤدي هذا الإجراء إلى بدء تشغيل خدمة BLE Secure.
otBleSecureStop(otInstance *aInstance)	void تؤدي إلى إيقاف خادم BLE Secure.
otBleSecureTcatStart(otInstance *aInstance, const otTcatVendorInfo *aVendorInfo, otHandleTcatJoin aHandler)	otError تفعيل بروتوكول TCAT عبر بروتوكول BLE Secure.

الهياكل
otTcatVendorInfo	يمثل هذا الهيكل معلومات مورّد TCAT.

عمليات التعداد

otTcatApplicationProtocol

 otTcatApplicationProtocol

يمثل بروتوكول تطبيق TCAT.

أماكن إقامة
OT_TCAT_APPLICATION_PROTOCOL_NONE	الرسالة التي تم إرسالها بدون تفعيل وكيل TCAT.
OT_TCAT_APPLICATION_PROTOCOL_STATUS	تم توجيه الرسالة إلى خدمة UDP.
OT_TCAT_APPLICATION_PROTOCOL_TCP	رسالة موجهة إلى خدمة TCP.

otTcatCommandClass

 otTcatCommandClass

يمثل فئة أمر TCAT.

أماكن إقامة
OT_TCAT_COMMAND_CLASS_APPLICATION	أوامر TCAT المرتبطة بطبقة التطبيق.
OT_TCAT_COMMAND_CLASS_COMMISSIONING	أوامر TCAT المتعلقة بالتكليف.
OT_TCAT_COMMAND_CLASS_DECOMMISSIONING	أوامر TCAT المتعلقة بإنهاء الخدمة.
OT_TCAT_COMMAND_CLASS_EXTRACTION	أوامر TCAT المرتبطة باستخراج المفاتيح.
OT_TCAT_COMMAND_CLASS_GENERAL	أوامر TCAT المتعلقة بالعمليات العامة.

otTcatStatusCode

 otTcatStatusCode

يُمثِّل رمز حالة TCAT.

أماكن إقامة
OT_TCAT_STATUS_BUSY	لا يمكن تنفيذ الأمر لأن المورد مشغول.
OT_TCAT_STATUS_GENERAL_ERROR	حدث خطأ لا يطابق أي فئة أخرى.
OT_TCAT_STATUS_HASH_ERROR	قيمة التجزئة التي قدّمها المفوَّض غير صحيحة.
OT_TCAT_STATUS_PARSE_ERROR	تعذَّر تحليل الطلب / الأمر بشكل صحيح.
OT_TCAT_STATUS_SUCCESS	تمت معالجة الأمر أو الطلب بنجاح.
OT_TCAT_STATUS_UNAUTHORIZED	لا يمتلك المُرسِل إذنًا كافيًا للأمر المحدد.
OT_TCAT_STATUS_UNDEFINED	القيمة المطلوبة أو البيانات أو الخدمة المطلوبة غير محدَّدة (في الوقت الحالي) أو غير موجودة.
OT_TCAT_STATUS_UNSUPPORTED	الطلب المطلوب أو النص الذي تم استلامه غير متوافق.
OT_TCAT_STATUS_VALUE_ERROR	هناك خطأ في قيمة TLV الذي تم نقله.

تحديدات النوع

otHandleBleSecureConnect

void(* otHandleBleSecureConnect)(otInstance *aInstance, bool aConnected, bool aBleConnectionOpen, void *aContext)

مؤشر للاتصال عند تغيير حالة الاتصال الآمن "بلي".

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aConnected TRUE، إذا تم إنشاء اتصال آمن، وFALSE في الحالات الأخرى. [in] aBleConnectionOpen TRUE إذا تم إنشاء اتصال BLE لنقل مصدر بيانات TLS، وبخلاف ذلك، FALSE. [in] aContext يشير إلى معلومات سياق عشوائية.

otHandleBleSecureReceive

otHandleTcatApplicationDataReceive otHandleBleSecureReceive

مؤشر للاتصال عند استلام البيانات عبر اتصال بروتوكول أمان طبقة النقل (TLS) بتقنية BLE.

otHandleTcatApplicationDataReceive

void(* otHandleTcatApplicationDataReceive)(otInstance *aInstance, const otMessage *aMessage, int32_t aOffset, otTcatApplicationProtocol aTcatApplicationProtocol, const char *aServiceName, void *aContext)

مؤشر للاتصال عند استلام بيانات التطبيق من خلال اتصال بروتوكول أمان طبقة النقل (TLS) لبروتوكول TCAT.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aMessage مؤشر للرسالة. [in] aOffset التعويض حيث تبدأ بيانات التطبيق. [in] aTcatApplicationProtocol نوع بروتوكول الرسالة التي تم استلامها. [in] aServiceName اسم الخدمة التي يتم توجيه الرسالة إليها. [in] aContext يشير إلى معلومات سياق عشوائية.

otHandleTcatJoin

void(* otHandleTcatJoin)(otError aError, void *aContext)

مؤشر للاتصال للإعلام باكتمال عملية الانضمام.

التفاصيل
المَعلمات	[in] aError OT_ERROR_NONE إذا نجحت عملية الانضمام. OT_ERROR_ حين فشل عملية الانضمام بسبب بيانات اعتماد الأمان. [in] aContext يشير إلى معلومات سياق عشوائية.

otTcatApplicationProtocol

enum otTcatApplicationProtocol otTcatApplicationProtocol

يمثل بروتوكول تطبيق TCAT.

otTcatCommandClass

enum otTcatCommandClass otTcatCommandClass

يمثل فئة أمر TCAT.

otTcatStatusCode

enum otTcatStatusCode otTcatStatusCode

يُمثِّل رمز حالة TCAT.

otTcatVendorInfo

struct otTcatVendorInfo otTcatVendorInfo

يمثل هذا الهيكل معلومات مورّد TCAT.

يجب أن يستمر محتوى هذه البنية ويظل بدون تغيير أثناء تشغيل جلسة TCAT.

الدوال

otBleSecureConnect

otError otBleSecureConnect(
  otInstance *aInstance
)

يؤدي هذا الخيار إلى إعداد جلسة بروتوكول أمان طبقة النقل (TLS) مع نظير باستخدام اتصال BLE مفتوح حاليًا.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
قيم الإرجاع	OT_ERROR_NONE تم بدء اتصال بروتوكول أمان طبقة النقل (TLS) بنجاح.

otBleSecureDisconnect

void otBleSecureDisconnect(
  otInstance *aInstance
)

يوقف الاتصال عبر تقنية BLE وبروتوكول أمان طبقة النقل (TLS).

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.

otBleSecureFlush

otError otBleSecureFlush(
  otInstance *aInstance
)

تنظيف المخزن المؤقت للإرسال

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
قيم الإرجاع	OT_ERROR_NONE تم محو المخزن المؤقت للمخرجات بنجاح. OT_ERROR_NO_BUFS تعذّر تخصيص ذاكرة المخزن المؤقت. OT_ERROR_INVALID_STATE لم يتم إعداد اتصال بروتوكول أمان طبقة النقل (TLS).

otBleSecureGetPeerCertificateBase64

otError otBleSecureGetPeerCertificateBase64(
  otInstance *aInstance,
  unsigned char *aPeerCert,
  size_t *aCertLength
)

لعرض النظير x509 لشهادة base64 المشفرة.

ملاحظة: يتطلّب ذلك تفعيل ميزات وقت الإصدار MBEDTLS_BASE64_C وMBEDTLS_SSL_KEEP_PEER_CERTIFICATE.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [out] aPeerCert يشير هذا المصطلح إلى المخزن المؤقت للشهادة المشفّرة بترميز base64. [in,out] aCertLength عند الإدخال، يكون الحجم الأقصى هو aPeerCert. عند الإخراج، يمثل طول شهادة النظير المشفرة لـ base64.
قيم الإرجاع	OT_ERROR_NONE الحصول على شهادة الزملاء بنجاح. OT_ERROR_INVALID_ARGS aInstance أو aCertLength غير صالح. OT_ERROR_INVALID_STATE لم يتم الربط بعد. OT_ERROR_NO_BUFS يتعذّر تخصيص ذاكرة للشهادة.

otBleSecureGetPeerSubjectAttributeByOid

otError otBleSecureGetPeerSubjectAttributeByOid(
  otInstance *aInstance,
  const char *aOid,
  size_t aOidLength,
  uint8_t *aAttributeBuffer,
  size_t *aAttributeLength,
  int *aAsn1Type
)

لعرض قيمة سمة تم تحديدها بواسطة OID من موضوع شهادة x509 من الأقران.

يتم توفير معرّف الجهاز النظير (OID) في تنسيق ثنائي. يتم ضبط طول السمة إذا تمت قراءتها بنجاح أو صفرًا في حال عدم النجاح. نوع ASN.1 كما يتم تحديده في معيار ITU-T X.690 إذا تمت قراءة السمة بنجاح.

ملاحظة: يتطلّب ذلك تفعيل ميزة وقت الإصدار MBEDTLS_SSL_KEEP_PEER_CERTIFICATE.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aOid مؤشر يشير إلى كائن OID الذي يتم العثور عليه. [in] aOidLength طول معرّف الكائن الفريد (OID). [out] aAttributeBuffer يشير إلى المخزن المؤقت للسمات. [in,out] aAttributeLength عند الإدخال، يكون الحجم الأقصى هو aAttributeBuffer. عند الإخراج، يمثل طول السمة المكتوبة في المخزن المؤقت. [out] aAsn1Type يشير هذا المصطلح إلى نوع ASN.1 للسمة المكتوبة في المخزن المؤقت.
قيم الإرجاع	OT_ERROR_INVALID_STATE لم يتم الربط بعد. OT_ERROR_INVALID_ARGS طول السمة غير صالح. OT_ERROR_NONE تمت قراءة السمة بنجاح. OT_ERROR_NO_BUFS الذاكرة غير كافية لتخزين قيمة السمة.

otBleSecureGetThreadAttributeFromOwnCertificate

otError otBleSecureGetThreadAttributeFromOwnCertificate(
  otInstance *aInstance,
  int aThreadOidDescriptor,
  uint8_t *aAttributeBuffer,
  size_t *aAttributeLength
)

تعرض قيمة سمة لـ OID 1.3.6.1.4.1.44970.x من الامتدادات v3 لشهادة x509 الخاصة، حيث يتم تعيين الرقم الأخير x على aThreadOidDescriptor.

يتم ضبط طول السمة إذا تمت قراءتها بنجاح أو صفرًا في حال عدم النجاح. يجب الاتصال بالإنترنت لتفعيل الميزة.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aThreadOidDescriptor الرقم الأخير من OID لسمة Thread. [out] aAttributeBuffer يشير إلى المخزن المؤقت للسمات. [in,out] aAttributeLength عند الإدخال، يكون الحجم الأقصى هو aAttributeBuffer. عند الإخراج، يمثل طول السمة المكتوبة في المخزن المؤقت.
قيم الإرجاع	OT_ERROR_NONE تمت قراءة السمة بنجاح. OT_ERROR_INVALID_ARGS طول السمة غير صالح. OT_NOT_FOUND لم يتم العثور على السمة المطلوبة. OT_ERROR_NO_BUFS الذاكرة غير كافية لتخزين قيمة السمة. OT_ERROR_INVALID_STATE لم يتم الربط بعد. OT_ERROR_NOT_IMPLEMENTED قيمة aThreadOidDescriptor هي >127. OT_ERROR_PARSE تعذّر تحليل إضافات الشهادات.

otBleSecureGetThreadAttributeFromPeerCertificate

otError otBleSecureGetThreadAttributeFromPeerCertificate(
  otInstance *aInstance,
  int aThreadOidDescriptor,
  uint8_t *aAttributeBuffer,
  size_t *aAttributeLength
)

تعرض قيمة سمة لـ OID 1.3.6.1.4.1.44970.x من الامتدادات v3 لشهادة x509 من النظير، حيث يتم تعيين الرقم الأخير x على aThreadOidDescriptor.

يتم ضبط طول السمة إذا تمت قراءتها بنجاح أو صفرًا في حال عدم النجاح. يجب الاتصال بالإنترنت لتفعيل الميزة.

ملاحظة: يتطلّب ذلك تفعيل ميزة وقت الإصدار MBEDTLS_SSL_KEEP_PEER_CERTIFICATE.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aThreadOidDescriptor الرقم الأخير من OID لسمة Thread. [out] aAttributeBuffer يشير إلى المخزن المؤقت للسمات. [in,out] aAttributeLength عند الإدخال، يكون الحجم الأقصى هو aAttributeBuffer. عند الإخراج، يمثل طول السمة المكتوبة في المخزن المؤقت.
قيم الإرجاع	OT_ERROR_NONE تمت قراءة السمة بنجاح. OT_ERROR_INVALID_ARGS طول السمة غير صالح. OT_NOT_FOUND لم يتم العثور على السمة المطلوبة. OT_ERROR_NO_BUFS الذاكرة غير كافية لتخزين قيمة السمة. OT_ERROR_INVALID_STATE لم يتم الربط بعد. OT_ERROR_NOT_IMPLEMENTED قيمة aThreadOidDescriptor هي >127. OT_ERROR_PARSE تعذّر تحليل إضافات الشهادات.

otBleSecureIsCommandClassAuthorized

bool otBleSecureIsCommandClassAuthorized(
  otInstance *aInstance,
  otTcatCommandClass aCommandClass
)

يشير إلى ما إذا كان مسموحًا لفئة أوامر TCAT بإدراجها.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aCommandClass فئة أوامر يجب التحقق منها.
قيم الإرجاع	TRUE فئة الأمر معتمَد. FALSE فئة الأمر غير مسموح بها.

otBleSecureIsConnected

bool otBleSecureIsConnected(
  otInstance *aInstance
)

يشير إلى ما إذا كانت جلسة بروتوكول أمان طبقة النقل (TLS) متصلة أم لا.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
قيم الإرجاع	TRUE جلسة بروتوكول أمان طبقة النقل (TLS) متصلة. FALSE جلسة بروتوكول أمان طبقة النقل (TLS) غير متصلة.

otBleSecureIsConnectionActive

bool otBleSecureIsConnectionActive(
  otInstance *aInstance
)

يشير إلى ما إذا كانت جلسة TLS نشطة (متصلة أو متصلة).

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
قيم الإرجاع	TRUE إذا كانت جلسة بروتوكول أمان طبقة النقل (TLS) نشطة. FALSE في حال كانت جلسة بروتوكول أمان طبقة النقل (TLS) غير نشطة.

otBleSecureIsTcatEnabled

bool otBleSecureIsTcatEnabled(
  otInstance *aInstance
)

يشير إلى ما إذا كان وكيل TCAT مفعَّلاً أم لا.

التفاصيل
قيم الإرجاع	TRUE وكيل TCAT مفعَّل. FALSE وكيل TCAT غير مفعَّل.

otBleSecureSend

otError otBleSecureSend(
  otInstance *aInstance,
  uint8_t *aBuf,
  uint16_t aLength
)

يتم إرسال حزمة بيانات BLE آمنة.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aBuf مؤشر إلى البيانات المراد إرسالها باعتبارها قيمة TLV (قيمة TLV) لإرسال بيانات التطبيق. [in] aLength رقم يشير إلى طول المخزن المؤقت للبيانات.
قيم الإرجاع	OT_ERROR_NONE تم إرسال البيانات بنجاح. OT_ERROR_NO_BUFS تعذّر تخصيص ذاكرة المخزن المؤقت. OT_ERROR_INVALID_STATE لم يتم إعداد اتصال بروتوكول أمان طبقة النقل (TLS).

otBleSecureSendApplicationTlv

otError otBleSecureSendApplicationTlv(
  otInstance *aInstance,
  uint8_t *aBuf,
  uint16_t aLength
)

يرسل حزمة بيانات BLE آمنة تحتوي على TLV (ملف TLV) لإرسال بيانات التطبيق.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aBuf مؤشر إلى البيانات المراد إرسالها باعتبارها قيمة TLV (قيمة TLV) لإرسال بيانات التطبيق. [in] aLength رقم يشير إلى طول المخزن المؤقت للبيانات.
قيم الإرجاع	OT_ERROR_NONE تم إرسال البيانات بنجاح. OT_ERROR_NO_BUFS تعذّر تخصيص ذاكرة المخزن المؤقت. OT_ERROR_INVALID_STATE لم يتم إعداد اتصال بروتوكول أمان طبقة النقل (TLS).

otBleSecureSendMessage

otError otBleSecureSendMessage(
  otInstance *aInstance,
  otMessage *aMessage
)

لإرسال رسالة BLE آمنة.

إذا كانت القيمة المعروضة هي OT_ERROR_NONE، سيحصل OpenThread على ملكية aMessage، ويجب ألا يشير المتصل إلى aMessage بعد ذلك. وإذا لم تكن القيمة المعروضة OT_ERROR_NONE، يحتفظ المتصل بملكية aMessage، بما في ذلك تحرير aMessage إذا لم تعد هناك حاجة إلى المخزن المؤقت للرسائل.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aMessage مؤشر للرسالة المطلوب إرسالها

التفاصيل
قيم الإرجاع	OT_ERROR_NONE تم إرسال الرسالة بنجاح. OT_ERROR_NO_BUFS تعذّر تخصيص ذاكرة المخزن المؤقت. OT_ERROR_INVALID_STATE لم يتم إعداد اتصال بروتوكول أمان طبقة النقل (TLS).

otBleSecureSetCaCertificateChain

void otBleSecureSetCaCertificateChain(
  otInstance *aInstance,
  const uint8_t *aX509CaCertificateChain,
  uint32_t aX509CaCertChainLength
)

لضبط مراجع التصديق ذات المستوى الأعلى الموثوق بها

وهي مطلوبة للتحقق من صحة شهادة الزميل.

وضع بروتوكول أمان طبقة النقل (TLS) هو "ECDHE ECDSA مع AES 128 CCM 8" للحصول على تقنية BLE آمنة.

ملاحظة: يجب توفّر MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED=1.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aX509CaCertificateChain مؤشر لسلسلة X509 CA بتنسيق PEM. [in] aX509CaCertChainLength طول السلسلة.

otBleSecureSetCertificate

void otBleSecureSetCertificate(
  otInstance *aInstance,
  const uint8_t *aX509Cert,
  uint32_t aX509Length,
  const uint8_t *aPrivateKey,
  uint32_t aPrivateKeyLength
)

لضبط شهادة X509 للجهاز المحلي باستخدام المفتاح الخاص المقابل لجلسة بروتوكول أمان طبقة النقل (TLS)، باستخدام TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8.

ملاحظة: يجب توفّر MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED=1.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aX509Cert مؤشر لشهادة X509 بتنسيق PEM. [in] aX509Length طول الشهادة. [in] aPrivateKey مؤشر للمفتاح الخاص الذي تم تنسيقه بواسطة PEM. [in] aPrivateKeyLength طول المفتاح الخاص.

otBleSecureSetPsk

void otBleSecureSetPsk(
  otInstance *aInstance,
  const uint8_t *aPsk,
  uint16_t aPskLength,
  const uint8_t *aPskIdentity,
  uint16_t aPskIdLength
)

تُعيِّن المفتاح المشترك مسبقًا (PSK) ومجموعة التشفير TLS_PSK_WITH_AES_128_CCM_8.

ملاحظة: يتطلّب ذلك تفعيل ميزة وقت الإصدار MBEDTLS_KEY_EXCHANGE_PSK_ENABLED.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aPsk مؤشر PSK. [in] aPskLength طول PSK. [in] aPskIdentity اسم الهوية لـ PSK [in] aPskIdLength طول هوية PSK

otBleSecureSetSslAuthMode

void otBleSecureSetSslAuthMode(
  otInstance *aInstance,
  bool aVerifyPeerCertificate
)

تحدِّد هذه السياسة وضع المصادقة للاتصال الآمن بتقنية BLE.

يمكنك إيقاف التحقّق من الشهادة النظير أو تفعيله. يجب الاتصال قبل البدء.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aVerifyPeerCertificate صحيح، للتحقق من شهادة الزميل.

otBleSecureStart

otError otBleSecureStart(
  otInstance *aInstance,
  otHandleBleSecureConnect aConnectHandler,
  otHandleBleSecureReceive aReceiveHandler,
  bool aTlvMode,
  void *aContext
)

يؤدي هذا الإجراء إلى بدء تشغيل خدمة BLE Secure.

عندما يكون وضع TLV مفعَّلاً، سيتم استدعاء الدالة "aReceiveHandler" بعد استلام رسالة TLV كاملة وتشير إزاحة الرسالة إلى قيمة TLV.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aConnectHandler يشير ذلك المصطلح إلى دالة يتم استدعاؤها عند تغيير حالة الاتصال. [in] aReceiveHandler يشير ذلك المصطلح إلى مؤشر يشير إلى دالة سيتم استدعاؤها بعد تلقّي البيانات من خلال اتصال بروتوكول أمان طبقة النقل (TLS). [in] aTlvMode قيمة منطقية تشير إلى ما إذا كان سيتم تفعيل وضع الخط. [in] aContext يشير إلى معلومات سياق عشوائية. قد تكون فارغة إذا لم يتم استخدامها.
قيم الإرجاع	OT_ERROR_NONE تم تشغيل خادم BLE Secure بنجاح. OT_ERROR_ALREADY سبق أن تم ذكر الخدمة.

otBleSecureStop

void otBleSecureStop(
  otInstance *aInstance
)

تؤدي إلى إيقاف خادم BLE Secure.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.

otBleSecureTcatStart

otError otBleSecureTcatStart(
  otInstance *aInstance,
  const otTcatVendorInfo *aVendorInfo,
  otHandleTcatJoin aHandler
)

تفعيل بروتوكول TCAT عبر بروتوكول BLE Secure.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aVendorInfo المؤشر إلى "معلومات البائع" (يجب أن يظل صالحًا بعد استدعاء الطريقة، وقد يكون فارغًا). [in] aHandler يشير هذا المصطلح إلى مؤشر لدالة يتم استدعاؤها عند اكتمال عملية الدمج.
قيم الإرجاع	OT_ERROR_NONE تم بدء دور "الانضمام الآمن" في BLE بنجاح. OT_ERROR_INVALID_ARGS aElevationPsk أو aVendorInfo غير صالح. OT_ERROR_INVALID_STATE لم يتم تشغيل دالة BLE أو لم يتم اختيار وضع الخط.

وحدات ماكرو

OT_TCAT_MAX_SERVICE_NAME_LENGTH

 OT_TCAT_MAX_SERVICE_NAME_LENGTH 15

الحد الأقصى لطول السلسلة لاسم خدمة UDP أو TCP (لا يتضمن حرفًا فارغًا).

المراجِع

تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.