BLE নিরাপদ
এই মডিউলটিতে এমন ফাংশন রয়েছে যা BLE সিকিউর (TLS ওভার BLE) যোগাযোগ নিয়ন্ত্রণ করে।
সারসংক্ষেপ
এই মডিউলটিতে এমন ফাংশন রয়েছে যা TCAT যোগাযোগ বাস্তবায়ন করে।
BLE সিকিউর এপিআই বৈশিষ্ট্য ( OPENTHREAD_CONFIG_BLE_TCAT_ENABLE
) সক্ষম হলে এই মডিউলের ফাংশনগুলি উপলব্ধ।
TCAT বৈশিষ্ট্য ( OPENTHREAD_CONFIG_BLE_TCAT_ENABLE
) সক্ষম হলে এই মডিউলের ফাংশনগুলি উপলব্ধ।
গণনা | |
---|---|
otTcatApplicationProtocol { | enum TCAT অ্যাপ্লিকেশন প্রোটোকল প্রতিনিধিত্ব করে। |
otTcatCommandClass { | enum একটি TCAT কমান্ড ক্লাস প্রতিনিধিত্ব করে। |
otTcatStatusCode { | enum TCAT স্ট্যাটাস কোড প্রতিনিধিত্ব করে। |
Typedefs | |
---|---|
otHandleBleSecureConnect )(otInstance *aInstance, bool aConnected, bool aBleConnectionOpen, void *aContext) | typedefvoid(* ble সুরক্ষিত সংযোগের অবস্থা পরিবর্তন হলে কল করার জন্য পয়েন্টার। |
otHandleBleSecureReceive | typedef BLE সিকিউর TLS সংযোগের মাধ্যমে ডেটা প্রাপ্ত হলে কল করার নির্দেশক৷ |
otHandleTcatApplicationDataReceive )(otInstance *aInstance, const otMessage *aMessage, int32_t aOffset, otTcatApplicationProtocol aTcatApplicationProtocol, const char *aServiceName, void *aContext) | typedefvoid(* একটি TCAT TLS সংযোগের মাধ্যমে অ্যাপ্লিকেশন ডেটা প্রাপ্ত হলে কল করার নির্দেশক৷ |
otHandleTcatJoin )(otError aError, void *aContext) | typedefvoid(* একটি যোগদান অপারেশন সমাপ্তির বিজ্ঞপ্তি কল করার জন্য পয়েন্টার. |
otTcatApplicationProtocol | typedef TCAT অ্যাপ্লিকেশন প্রোটোকল প্রতিনিধিত্ব করে। |
otTcatCommandClass | typedefenum otTcatCommandClass একটি TCAT কমান্ড ক্লাস প্রতিনিধিত্ব করে। |
otTcatStatusCode | typedefenum otTcatStatusCode TCAT স্ট্যাটাস কোড প্রতিনিধিত্ব করে। |
otTcatVendorInfo | typedefstruct otTcatVendorInfo এই কাঠামোটি একটি TCAT বিক্রেতার তথ্য উপস্থাপন করে। |
ফাংশন | |
---|---|
otBleSecureConnect ( otInstance *aInstance) | ইতিমধ্যে খোলা BLE সংযোগ ব্যবহার করে একজন সহকর্মীর সাথে TLS সেশন শুরু করে। |
otBleSecureDisconnect ( otInstance *aInstance) | void BLE এবং TLS সংযোগ বন্ধ করে। |
otBleSecureFlush ( otInstance *aInstance) | পাঠান বাফার ফ্লাশ করে। |
otBleSecureGetPeerCertificateBase64 ( otInstance *aInstance, unsigned char *aPeerCert, size_t *aCertLength) | এনকোড করা পিয়ার x509 শংসাপত্র base64 প্রদান করে। |
otBleSecureGetPeerSubjectAttributeByOid ( otInstance *aInstance, const char *aOid, size_t aOidLength, uint8_t *aAttributeBuffer, size_t *aAttributeLength, int *aAsn1Type) | পিয়ার x509 শংসাপত্রের বিষয় থেকে এর OID দ্বারা চিহ্নিত একটি বৈশিষ্ট্যের মান প্রদান করে। |
otBleSecureGetThreadAttributeFromOwnCertificate ( otInstance *aInstance, int aThreadOidDescriptor, uint8_t *aAttributeBuffer, size_t *aAttributeLength) | নিজস্ব x509 সার্টিফিকেটের v3 এক্সটেনশন থেকে OID 1.3.6.1.4.1.44970.x-এর জন্য একটি অ্যাট্রিবিউট মান প্রদান করে, যেখানে শেষ সংখ্যা x aThreadOidDescriptor-এ সেট করা আছে। |
otBleSecureGetThreadAttributeFromPeerCertificate ( otInstance *aInstance, int aThreadOidDescriptor, uint8_t *aAttributeBuffer, size_t *aAttributeLength) | পিয়ার x509 সার্টিফিকেটের v3 এক্সটেনশন থেকে OID 1.3.6.1.4.1.44970.x-এর জন্য একটি অ্যাট্রিবিউট মান প্রদান করে, যেখানে শেষ সংখ্যা 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) | একটি নিরাপদ BLE ডেটা প্যাকেট পাঠায়। |
otBleSecureSendApplicationTlv ( otInstance *aInstance, uint8_t *aBuf, uint16_t aLength) | একটি নিরাপদ BLE ডেটা প্যাকেট পাঠায় যাতে একটি TCAT Send Application Data TLV রয়েছে৷ |
otBleSecureSendMessage ( otInstance *aInstance, otMessage *aMessage) | একটি নিরাপদ BLE বার্তা পাঠায়। |
otBleSecureSetCaCertificateChain ( otInstance *aInstance, const uint8_t *aX509CaCertificateChain, uint32_t aX509CaCertChainLength) | void বিশ্বস্ত শীর্ষ স্তরের CA সেট করে৷ |
otBleSecureSetCertificate ( otInstance *aInstance, const uint8_t *aX509Cert, uint32_t aX509Length, const uint8_t *aPrivateKey, uint32_t aPrivateKeyLength) | void TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 এর সাথে TLS সেশনের জন্য সংশ্লিষ্ট ব্যক্তিগত কী সহ স্থানীয় ডিভাইসের X509 শংসাপত্র সেট করে৷ |
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) | BLE সিকিউর পরিষেবা শুরু করে। |
otBleSecureStop ( otInstance *aInstance) | void BLE সিকিউর সার্ভার বন্ধ করে। |
otBleSecureTcatStart ( otInstance *aInstance, const otTcatVendorInfo *aVendorInfo, otHandleTcatJoin aHandler) | BLE সিকিউর এর উপর TCAT প্রোটোকল সক্ষম করে। |
কাঠামো | |
---|---|
otTcatVendorInfo | এই কাঠামোটি একটি TCAT বিক্রেতার তথ্য উপস্থাপন করে। |
গণনা
otTcatApplicationProtocol
otTcatApplicationProtocol
otTcatCommandClass
otTcatCommandClass
একটি TCAT কমান্ড ক্লাস প্রতিনিধিত্ব করে।
otTcatStatusCode
otTcatStatusCode
TCAT স্ট্যাটাস কোড প্রতিনিধিত্ব করে।
Typedefs
otHandleBleSecureConnect
void(* otHandleBleSecureConnect)(otInstance *aInstance, bool aConnected, bool aBleConnectionOpen, void *aContext)
ble সুরক্ষিত সংযোগের অবস্থা পরিবর্তন হলে কল করার জন্য পয়েন্টার।
বিস্তারিত | |||||||||
---|---|---|---|---|---|---|---|---|---|
পরামিতি |
|
otHandleBleSecureReceive
otHandleTcatApplicationDataReceive otHandleBleSecureReceive
BLE সিকিউর TLS সংযোগের মাধ্যমে ডেটা প্রাপ্ত হলে কল করার নির্দেশক৷
otHandleTcatApplicationDataReceive
void(* otHandleTcatApplicationDataReceive)(otInstance *aInstance, const otMessage *aMessage, int32_t aOffset, otTcatApplicationProtocol aTcatApplicationProtocol, const char *aServiceName, void *aContext)
একটি TCAT TLS সংযোগের মাধ্যমে অ্যাপ্লিকেশন ডেটা প্রাপ্ত হলে কল করার নির্দেশক৷
বিস্তারিত | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
পরামিতি |
|
otHandleTcatJoin
void(* otHandleTcatJoin)(otError aError, void *aContext)
একটি যোগদান অপারেশন সমাপ্তির বিজ্ঞপ্তি কল করার জন্য পয়েন্টার.
বিস্তারিত | |||||
---|---|---|---|---|---|
পরামিতি |
|
otTcatApplicationProtocol
enum otTcatApplicationProtocol otTcatApplicationProtocol
TCAT অ্যাপ্লিকেশন প্রোটোকল প্রতিনিধিত্ব করে।
otTcatCommandClass
enum otTcatCommandClass otTcatCommandClass
একটি TCAT কমান্ড ক্লাস প্রতিনিধিত্ব করে।
otTcatVendorInfo
struct otTcatVendorInfo otTcatVendorInfo
এই কাঠামোটি একটি TCAT বিক্রেতার তথ্য উপস্থাপন করে।
একটি TCAT সেশন চলাকালীন এই কাঠামোর বিষয়বস্তু অবশ্যই টিকে থাকতে হবে এবং অপরিবর্তিত থাকতে হবে।
ফাংশন
otBleSecureConnect
otError otBleSecureConnect( otInstance *aInstance )
ইতিমধ্যে খোলা BLE সংযোগ ব্যবহার করে একজন সহকর্মীর সাথে TLS সেশন শুরু করে।
বিস্তারিত | |||
---|---|---|---|
পরামিতি |
| ||
রিটার্ন মান |
|
otBleSecureDisconnect
void otBleSecureDisconnect( otInstance *aInstance )
BLE এবং TLS সংযোগ বন্ধ করে।
বিস্তারিত | |||
---|---|---|---|
পরামিতি |
|
otBleSecureFlush
otError otBleSecureFlush( otInstance *aInstance )
পাঠান বাফার ফ্লাশ করে।
বিস্তারিত | |||||||
---|---|---|---|---|---|---|---|
পরামিতি |
| ||||||
রিটার্ন মান |
|
otBleSecureGetPeerCertificateBase64
otError otBleSecureGetPeerCertificateBase64( otInstance *aInstance, unsigned char *aPeerCert, size_t *aCertLength )
এনকোড করা পিয়ার x509 শংসাপত্র base64 প্রদান করে।
বিস্তারিত | |||||||||
---|---|---|---|---|---|---|---|---|---|
পরামিতি |
| ||||||||
রিটার্ন মান |
|
otBleSecureGetPeerSubjectAttributeByOid
otError otBleSecureGetPeerSubjectAttributeByOid( otInstance *aInstance, const char *aOid, size_t aOidLength, uint8_t *aAttributeBuffer, size_t *aAttributeLength, int *aAsn1Type )
পিয়ার x509 শংসাপত্রের বিষয় থেকে এর OID দ্বারা চিহ্নিত একটি বৈশিষ্ট্যের মান প্রদান করে।
পিয়ার OID বাইনারি বিন্যাসে প্রদান করা হয়. অ্যাট্রিবিউটের দৈর্ঘ্য সেট করা হয় যদি অ্যাট্রিবিউটটি সফলভাবে পড়া হয় বা ব্যর্থ হলে শূন্য হয়। ASN.1 প্রকারটি ITU-T X.690 স্ট্যান্ডার্ডে সংজ্ঞায়িত হিসাবে সেট করা হয়েছে যদি অ্যাট্রিবিউটটি সফলভাবে পড়া হয়।
বিস্তারিত | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
পরামিতি |
| ||||||||||||
রিটার্ন মান |
|
otBleSecureGetThreadAttributeFromOwnCertificate
otError otBleSecureGetThreadAttributeFromOwnCertificate( otInstance *aInstance, int aThreadOidDescriptor, uint8_t *aAttributeBuffer, size_t *aAttributeLength )
নিজস্ব x509 সার্টিফিকেটের v3 এক্সটেনশন থেকে OID 1.3.6.1.4.1.44970.x-এর জন্য একটি অ্যাট্রিবিউট মান প্রদান করে, যেখানে শেষ সংখ্যা x aThreadOidDescriptor-এ সেট করা আছে।
অ্যাট্রিবিউটের দৈর্ঘ্য সেট করা হয় যদি অ্যাট্রিবিউটটি সফলভাবে পড়া হয় বা ব্যর্থ হলে শূন্য হয়। সক্রিয় হতে একটি সংযোগ প্রয়োজন.
বিস্তারিত | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
পরামিতি |
| ||||||||||||||
রিটার্ন মান |
|
otBleSecureGetThreadAttributeFromPeerCertificate
otError otBleSecureGetThreadAttributeFromPeerCertificate( otInstance *aInstance, int aThreadOidDescriptor, uint8_t *aAttributeBuffer, size_t *aAttributeLength )
পিয়ার x509 সার্টিফিকেটের v3 এক্সটেনশন থেকে OID 1.3.6.1.4.1.44970.x-এর জন্য একটি অ্যাট্রিবিউট মান প্রদান করে, যেখানে শেষ সংখ্যা x aThreadOidDescriptor-এ সেট করা আছে।
অ্যাট্রিবিউটের দৈর্ঘ্য সেট করা হয় যদি অ্যাট্রিবিউটটি সফলভাবে পড়া হয় বা ব্যর্থ হলে শূন্য হয়। সক্রিয় হতে একটি সংযোগ প্রয়োজন.
বিস্তারিত | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
পরামিতি |
| ||||||||||||||
রিটার্ন মান |
|
#BleSecureIsCommandClassঅনুমোদিত
bool otBleSecureIsCommandClassAuthorized( otInstance *aInstance, otTcatCommandClass aCommandClass )
একটি TCAT কমান্ড ক্লাস অনুমোদিত কিনা তা নির্দেশ করে।
বিস্তারিত | |||||
---|---|---|---|---|---|
পরামিতি |
| ||||
রিটার্ন মান |
|
otBleSecureIsConnected
bool otBleSecureIsConnected( otInstance *aInstance )
TLS সেশন সংযুক্ত কিনা তা নির্দেশ করে।
বিস্তারিত | |||||
---|---|---|---|---|---|
পরামিতি |
| ||||
রিটার্ন মান |
|
otBleSecureIsConnectionActive
bool otBleSecureIsConnectionActive( otInstance *aInstance )
TLS সেশন সক্রিয় কিনা তা নির্দেশ করে (সংযুক্ত বা সংযুক্ত)।
বিস্তারিত | |||||
---|---|---|---|---|---|
পরামিতি |
| ||||
রিটার্ন মান |
|
otBleSecureIsTcatEnabled
bool otBleSecureIsTcatEnabled( otInstance *aInstance )
TCAT এজেন্ট সক্ষম কিনা তা নির্দেশ করে।
বিস্তারিত | |||||
---|---|---|---|---|---|
রিটার্ন মান |
|
otBleSecureSend
otError otBleSecureSend( otInstance *aInstance, uint8_t *aBuf, uint16_t aLength )
একটি নিরাপদ BLE ডেটা প্যাকেট পাঠায়।
বিস্তারিত | |||||||
---|---|---|---|---|---|---|---|
পরামিতি |
| ||||||
রিটার্ন মান |
|
otBleSecureSendApplicationTlv
otError otBleSecureSendApplicationTlv( otInstance *aInstance, uint8_t *aBuf, uint16_t aLength )
একটি নিরাপদ BLE ডেটা প্যাকেট পাঠায় যাতে একটি TCAT Send Application Data TLV রয়েছে৷
বিস্তারিত | |||||||
---|---|---|---|---|---|---|---|
পরামিতি |
| ||||||
রিটার্ন মান |
|
otBleSecureSendMessage
otError otBleSecureSendMessage( otInstance *aInstance, otMessage *aMessage )
একটি নিরাপদ BLE বার্তা পাঠায়।
রিটার্ন মান OT_ERROR_NONE হলে, OpenThread aMessage
এর মালিকানা নেয় এবং কলারকে আর aMessage
উল্লেখ করা উচিত নয়। যদি ফেরত মান OT_ERROR_NONE না হয়, কলকারী aMessage
এর মালিকানা ধরে রাখে, যদি বার্তা বাফারের আর প্রয়োজন না হয় তাহলে aMessage
মুক্ত করা সহ।
বিস্তারিত | |||||
---|---|---|---|---|---|
পরামিতি |
|
বিস্তারিত | |||||||
---|---|---|---|---|---|---|---|
রিটার্ন মান |
|
otBleSecureSetCaCertificateChain
void otBleSecureSetCaCertificateChain( otInstance *aInstance, const uint8_t *aX509CaCertificateChain, uint32_t aX509CaCertChainLength )
বিশ্বস্ত শীর্ষ স্তরের CA সেট করে৷
পিয়ার সার্টিফিকেট যাচাই করার জন্য এটি প্রয়োজন।
নিরাপদ BLE এর জন্য TLS মোড "ECDHE ECDSA with AES 128 CCM 8"।
বিস্তারিত | |||||||
---|---|---|---|---|---|---|---|
পরামিতি |
|
otBleSecureSetCertificate
void otBleSecureSetCertificate( otInstance *aInstance, const uint8_t *aX509Cert, uint32_t aX509Length, const uint8_t *aPrivateKey, uint32_t aPrivateKeyLength )
TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 এর সাথে TLS সেশনের জন্য সংশ্লিষ্ট ব্যক্তিগত কী সহ স্থানীয় ডিভাইসের X509 শংসাপত্র সেট করে৷
বিস্তারিত | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
পরামিতি |
|
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 সেট করে৷
বিস্তারিত | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
পরামিতি |
|
otBleSecureSetSslAuthMode
void otBleSecureSetSslAuthMode( otInstance *aInstance, bool aVerifyPeerCertificate )
BLE সুরক্ষিত সংযোগের জন্য প্রমাণীকরণ মোড সেট করে।
পিয়ার সার্টিফিকেট যাচাইকরণ নিষ্ক্রিয় বা সক্ষম করুন। শুরু করার আগে অবশ্যই কল করতে হবে।
বিস্তারিত | |||||
---|---|---|---|---|---|
পরামিতি |
|
otBleSecureStart
otError otBleSecureStart( otInstance *aInstance, otHandleBleSecureConnect aConnectHandler, otHandleBleSecureReceive aReceiveHandler, bool aTlvMode, void *aContext )
BLE সিকিউর পরিষেবা শুরু করে।
যখন TLV মোড সক্রিয় থাকে, একটি সম্পূর্ণ TLV প্রাপ্ত হওয়ার পরে aReceiveHandler
ফাংশনটিকে কল করা হবে এবং বার্তাটি TLV মানকে অফসেট নির্দেশ করে।
বিস্তারিত | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
পরামিতি |
| ||||||||||
রিটার্ন মান |
|
otBleSecureStop
void otBleSecureStop( otInstance *aInstance )
BLE সিকিউর সার্ভার বন্ধ করে।
বিস্তারিত | |||
---|---|---|---|
পরামিতি |
|
otBleSecureTcatStart
otError otBleSecureTcatStart( otInstance *aInstance, const otTcatVendorInfo *aVendorInfo, otHandleTcatJoin aHandler )
BLE সিকিউর এর উপর TCAT প্রোটোকল সক্ষম করে।
বিস্তারিত | |||||||
---|---|---|---|---|---|---|---|
পরামিতি |
| ||||||
রিটার্ন মান |
|
ম্যাক্রো
OT_TCAT_MAX_SERVICE_NAME_LENGTH
OT_TCAT_MAX_SERVICE_NAME_LENGTH 15
একটি UDP বা TCP পরিষেবা নামের সর্বাধিক স্ট্রিং দৈর্ঘ্য (নাল অক্ষর অন্তর্ভুক্ত নয়)।
সম্পদ
OpenThread API রেফারেন্স বিষয়গুলি উৎস কোড থেকে উদ্ভূত হয়, যা GitHub- এ উপলব্ধ। আরও তথ্যের জন্য, বা আমাদের ডকুমেন্টেশনে অবদান রাখতে, সম্পদ দেখুন।