CoAP সিকিউর

এই মডিউলটিতে এমন ফাংশন রয়েছে যা CoAP সিকিউর (CoAP over DTLS) যোগাযোগ নিয়ন্ত্রণ করে।

সারসংক্ষেপ

CoAP সিকিউর এপিআই বৈশিষ্ট্য ( OPENTHREAD_CONFIG_COAP_SECURE_API_ENABLE ) সক্রিয় থাকলে এই মডিউলের ফাংশনগুলি উপলব্ধ।

Typedefs

otHandleCoapSecureClientConnect )(bool aConnected, void *aContext) typedef
void(*
পয়েন্টার বলা হয় যখন DTLS সংযোগের অবস্থা পরিবর্তিত হয়।

ফাংশন

otCoapSecureAddBlockWiseResource ( otInstance *aInstance, otCoapBlockwiseResource *aResource)
void
CoAP সিকিউর সার্ভারে একটি ব্লক-ভিত্তিক সম্পদ যোগ করে।
otCoapSecureAddResource ( otInstance *aInstance, otCoapResource *aResource)
void
CoAP সিকিউর সার্ভারে একটি সম্পদ যোগ করে।
otCoapSecureConnect ( otInstance *aInstance, const otSockAddr *aSockAddr, otHandleCoapSecureClientConnect aHandler, void *aContext)
একজন সহকর্মীর সাথে DTLS সেশন শুরু করে।
otCoapSecureDisconnect ( otInstance *aInstance)
void
DTLS সংযোগ বন্ধ করে।
otCoapSecureGetPeerCertificateBase64 ( otInstance *aInstance, unsigned char *aPeerCert, size_t *aCertLength, size_t aCertBufferSize)
এনকোড করা পিয়ার x509 শংসাপত্র base64 প্রদান করে।
otCoapSecureIsConnected ( otInstance *aInstance)
bool
DTLS সেশন সংযুক্ত কিনা তা নির্দেশ করে।
otCoapSecureIsConnectionActive ( otInstance *aInstance)
bool
DTLS সেশন সক্রিয় কিনা তা নির্দেশ করে।
otCoapSecureRemoveBlockWiseResource ( otInstance *aInstance, otCoapBlockwiseResource *aResource)
void
CoAP সিকিউর সার্ভার থেকে একটি ব্লক-ভিত্তিক সংস্থান সরিয়ে দেয়।
otCoapSecureRemoveResource ( otInstance *aInstance, otCoapResource *aResource)
void
CoAP সিকিউর সার্ভার থেকে একটি সংস্থান সরিয়ে দেয়।
otCoapSecureSendRequest ( otInstance *aInstance, otMessage *aMessage, otCoapResponseHandler aHandler, void *aContext)
নিরাপদ DTLS সংযোগের মাধ্যমে একটি CoAP অনুরোধ পাঠায়।
otCoapSecureSendRequestBlockWise ( otInstance *aInstance, otMessage *aMessage, otCoapResponseHandler aHandler, void *aContext, otCoapBlockwiseTransmitHook aTransmitHook, otCoapBlockwiseReceiveHook aReceiveHook)
নিরাপদ DTLS সংযোগের মাধ্যমে ব্লক অনুযায়ী একটি CoAP অনুরোধ পাঠায়।
otCoapSecureSendResponse ( otInstance *aInstance, otMessage *aMessage, const otMessageInfo *aMessageInfo)
CoAP সিকিউর সার্ভার থেকে একটি CoAP প্রতিক্রিয়া পাঠায়।
otCoapSecureSendResponseBlockWise ( otInstance *aInstance, otMessage *aMessage, const otMessageInfo *aMessageInfo, void *aContext, otCoapBlockwiseTransmitHook aTransmitHook)
CoAP সিকিউর সার্ভার থেকে ব্লক অনুযায়ী একটি CoAP প্রতিক্রিয়া পাঠায়।
otCoapSecureSetCaCertificateChain ( otInstance *aInstance, const uint8_t *aX509CaCertificateChain, uint32_t aX509CaCertChainLength)
void
বিশ্বস্ত শীর্ষ স্তরের CA সেট করে৷
otCoapSecureSetCertificate ( otInstance *aInstance, const uint8_t *aX509Cert, uint32_t aX509Length, const uint8_t *aPrivateKey, uint32_t aPrivateKeyLength)
void
DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 এর সাথে DTLS সেশনের জন্য সংশ্লিষ্ট ব্যক্তিগত কী সহ স্থানীয় ডিভাইসের X509 শংসাপত্র সেট করে৷
otCoapSecureSetClientConnectedCallback ( otInstance *aInstance, otHandleCoapSecureClientConnect aHandler, void *aContext)
void
একটি ক্লায়েন্ট যখন CoAP সিকিউর সার্ভারের সাথে সংযুক্ত হয় তখন নির্দেশিত করার জন্য সংযুক্ত কলব্যাক সেট করে।
otCoapSecureSetDefaultHandler ( otInstance *aInstance, otCoapRequestHandler aHandler, void *aContext)
void
নিয়ন্ত্রণহীন CoAP সিকিউর অনুরোধের জন্য ডিফল্ট হ্যান্ডলার সেট করে।
otCoapSecureSetPsk ( otInstance *aInstance, const uint8_t *aPsk, uint16_t aPskLength, const uint8_t *aPskIdentity, uint16_t aPskIdLength)
void
প্রি-শেয়ারড কী (PSK) এবং সাইফার স্যুট DTLS_PSK_WITH_AES_128_CCM_8 সেট করে৷
otCoapSecureSetSslAuthMode ( otInstance *aInstance, bool aVerifyPeerCertificate)
void
কোপ সুরক্ষিত সংযোগের জন্য প্রমাণীকরণ মোড সেট করে।
otCoapSecureStart ( otInstance *aInstance, uint16_t aPort)
CoAP সিকিউর পরিষেবা শুরু করে৷
otCoapSecureStop ( otInstance *aInstance)
void
CoAP সিকিউর সার্ভার বন্ধ করে।

Typedefs

otHandleCoapSecureClientConnect

void(* otHandleCoapSecureClientConnect)(bool aConnected, void *aContext)

পয়েন্টার বলা হয় যখন DTLS সংযোগের অবস্থা পরিবর্তিত হয়।

বিস্তারিত
পরামিতি
[in] aConnected
সত্য, যদি একটি সংযোগ প্রতিষ্ঠিত হয়, অন্যথায় মিথ্যা।
[in] aContext
নির্বিচারে প্রসঙ্গ তথ্যের একটি পয়েন্টার।

ফাংশন

otCoapSecureAddBlockWiseResource

void otCoapSecureAddBlockWiseResource(
  otInstance *aInstance,
  otCoapBlockwiseResource *aResource
)

CoAP সিকিউর সার্ভারে একটি ব্লক-ভিত্তিক সম্পদ যোগ করে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aResource
সম্পদ একটি পয়েন্টার.

otCoapSecureAddResource

void otCoapSecureAddResource(
  otInstance *aInstance,
  otCoapResource *aResource
)

CoAP সিকিউর সার্ভারে একটি সম্পদ যোগ করে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aResource
সম্পদ একটি পয়েন্টার.

otCoapSecureConnect

otError otCoapSecureConnect(
  otInstance *aInstance,
  const otSockAddr *aSockAddr,
  otHandleCoapSecureClientConnect aHandler,
  void *aContext
)

একজন সহকর্মীর সাথে DTLS সেশন শুরু করে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aSockAddr
দূরবর্তী সকেট ঠিকানার একটি পয়েন্টার।
[in] aHandler
একটি ফাংশনের একটি পয়েন্টার যা DTLS সংযোগের অবস্থা পরিবর্তিত হলে কল করা হবে।
[in] aContext
নির্বিচারে প্রসঙ্গ তথ্যের একটি পয়েন্টার।
রিটার্ন মান
OT_ERROR_NONE
সফলভাবে DTLS সংযোগ শুরু হয়েছে৷

otCoapSecureDisconnect

void otCoapSecureDisconnect(
  otInstance *aInstance
)

DTLS সংযোগ বন্ধ করে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.

otCoapSecureGetPeerCertificateBase64

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

এনকোড করা পিয়ার x509 শংসাপত্র base64 প্রদান করে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[out] aPeerCert
বেস64 এনকোডেড সার্টিফিকেট বাফারের একটি পয়েন্টার।
[out] aCertLength
বেস64 এনকোডেড পিয়ার সার্টিফিকেটের দৈর্ঘ্য।
[in] aCertBufferSize
aPeerCert এর বাফার আকার।
রিটার্ন মান
OT_ERROR_INVALID_STATE
এখনো সংযোগ নেই.
OT_ERROR_NONE
সফলভাবে পিয়ার সার্টিফিকেট পেতে.
OT_ERROR_NO_BUFS
শংসাপত্রের জন্য মেমরি বরাদ্দ করা যাবে না।

otCoapSecureIsConnected

bool otCoapSecureIsConnected(
  otInstance *aInstance
)

DTLS সেশন সংযুক্ত কিনা তা নির্দেশ করে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
রিটার্ন মান
TRUE
DTLS অধিবেশন সংযুক্ত আছে.
FALSE
DTLS অধিবেশন সংযুক্ত নয়.

otCoapSecureIsConnectionActive

bool otCoapSecureIsConnectionActive(
  otInstance *aInstance
)

DTLS সেশন সক্রিয় কিনা তা নির্দেশ করে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
রিটার্ন মান
TRUE
যদি DTLS সেশন সক্রিয় থাকে।
FALSE
যদি DTLS সেশন সক্রিয় না হয়।

otCoapSecureRemoveBlockWiseResource

void otCoapSecureRemoveBlockWiseResource(
  otInstance *aInstance,
  otCoapBlockwiseResource *aResource
)

CoAP সিকিউর সার্ভার থেকে একটি ব্লক-ভিত্তিক সংস্থান সরিয়ে দেয়।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aResource
সম্পদ একটি পয়েন্টার.

otCoapSecureRemoveResource

void otCoapSecureRemoveResource(
  otInstance *aInstance,
  otCoapResource *aResource
)

CoAP সিকিউর সার্ভার থেকে একটি সংস্থান সরিয়ে দেয়।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aResource
সম্পদ একটি পয়েন্টার.

otCoapSecureSendRequest

otError otCoapSecureSendRequest(
  otInstance *aInstance,
  otMessage *aMessage,
  otCoapResponseHandler aHandler,
  void *aContext
)

নিরাপদ DTLS সংযোগের মাধ্যমে একটি CoAP অনুরোধ পাঠায়।

যদি একটি অনুরোধের জন্য একটি প্রতিক্রিয়া প্রত্যাশিত হয়, সংশ্লিষ্ট ফাংশন এবং প্রসঙ্গ তথ্য প্রদান করা উচিত। যদি কোন প্রতিক্রিয়া প্রত্যাশিত না হয়, এই আর্গুমেন্টগুলি NULL পয়েন্টার হওয়া উচিত। যদি হেডারে মেসেজ আইডি সেট করা না থাকে (0 এর সমান), এই ফাংশনটি মেসেজে অনন্য মেসেজ আইডি বরাদ্দ করবে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aMessage
পাঠানোর জন্য বার্তার একটি রেফারেন্স।
[in] aHandler
একটি ফাংশন পয়েন্টার যা রেসপন্স রিসেপশন বা টাইম-আউটে কল করা হবে।
[in] aContext
নির্বিচারে প্রসঙ্গ তথ্যের একটি পয়েন্টার।
রিটার্ন মান
OT_ERROR_NONE
সফলভাবে CoAP বার্তা পাঠানো হয়েছে৷
OT_ERROR_NO_BUFS
রিট্রান্সমিশন ডেটা বরাদ্দ করতে ব্যর্থ হয়েছে৷
OT_ERROR_INVALID_STATE
DTLS সংযোগ আরম্ভ করা হয়নি।

otCoapSecureSendRequestBlockWise

otError otCoapSecureSendRequestBlockWise(
  otInstance *aInstance,
  otMessage *aMessage,
  otCoapResponseHandler aHandler,
  void *aContext,
  otCoapBlockwiseTransmitHook aTransmitHook,
  otCoapBlockwiseReceiveHook aReceiveHook
)

নিরাপদ DTLS সংযোগের মাধ্যমে ব্লক অনুযায়ী একটি CoAP অনুরোধ পাঠায়।

OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE কনফিগারেশন সক্ষম হলে উপলব্ধ।

যদি একটি অনুরোধের জন্য একটি প্রতিক্রিয়া প্রত্যাশিত হয়, সংশ্লিষ্ট ফাংশন এবং প্রসঙ্গ তথ্য প্রদান করা উচিত। যদি কোন প্রতিক্রিয়া প্রত্যাশিত না হয়, এই আর্গুমেন্টগুলি NULL পয়েন্টার হওয়া উচিত। যদি হেডারে মেসেজ আইডি সেট করা না থাকে (0 এর সমান), এই ফাংশনটি মেসেজে অনন্য মেসেজ আইডি বরাদ্দ করবে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aMessage
পাঠানোর জন্য বার্তার একটি রেফারেন্স।
[in] aHandler
একটি ফাংশন পয়েন্টার যা রেসপন্স রিসেপশন বা টাইম-আউটে কল করা হবে।
[in] aContext
নির্বিচারে প্রসঙ্গ তথ্যের একটি পয়েন্টার।
[in] aTransmitHook
একটি ফাংশন পয়েন্টার যা Block1 প্রতিক্রিয়া রিসেপশনে বলা হয়।
[in] aReceiveHook
একটি ফাংশন পয়েন্টার যা Block2 প্রতিক্রিয়া রিসেপশনে বলা হয়।
রিটার্ন মান
OT_ERROR_NONE
সফলভাবে CoAP বার্তা পাঠানো হয়েছে৷
OT_ERROR_NO_BUFS
রিট্রান্সমিশন ডেটা বরাদ্দ করতে ব্যর্থ হয়েছে৷
OT_ERROR_INVALID_STATE
DTLS সংযোগ আরম্ভ করা হয়নি।

otCoapSecureSendResponse

otError otCoapSecureSendResponse(
  otInstance *aInstance,
  otMessage *aMessage,
  const otMessageInfo *aMessageInfo
)

CoAP সিকিউর সার্ভার থেকে একটি CoAP প্রতিক্রিয়া পাঠায়।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aMessage
পাঠানোর জন্য CoAP প্রতিক্রিয়ার একটি নির্দেশক৷
[in] aMessageInfo
aMessage এর সাথে যুক্ত বার্তার তথ্যের একটি পয়েন্টার।
রিটার্ন মান
OT_ERROR_NONE
CoAP প্রতিক্রিয়া বার্তা সফলভাবে সারিবদ্ধ করা হয়েছে৷
OT_ERROR_NO_BUFS
CoAP প্রতিক্রিয়া পাঠানোর জন্য অপর্যাপ্ত বাফার উপলব্ধ।

otCoapSecureSendResponseBlockWise

otError otCoapSecureSendResponseBlockWise(
  otInstance *aInstance,
  otMessage *aMessage,
  const otMessageInfo *aMessageInfo,
  void *aContext,
  otCoapBlockwiseTransmitHook aTransmitHook
)

CoAP সিকিউর সার্ভার থেকে ব্লক অনুযায়ী একটি CoAP প্রতিক্রিয়া পাঠায়।

OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE কনফিগারেশন সক্ষম হলে উপলব্ধ।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aMessage
পাঠানোর জন্য CoAP প্রতিক্রিয়ার একটি নির্দেশক৷
[in] aMessageInfo
aMessage এর সাথে যুক্ত বার্তার তথ্যের একটি পয়েন্টার।
[in] aContext
নির্বিচারে প্রসঙ্গ তথ্যের একটি পয়েন্টার। ব্যবহার না করলে NULL হতে পারে।
[in] aTransmitHook
একটি ফাংশন পয়েন্টার যা Block1 অনুরোধ রিসেপশনে বলা হয়।
রিটার্ন মান
OT_ERROR_NONE
CoAP প্রতিক্রিয়া বার্তা সফলভাবে সারিবদ্ধ করা হয়েছে৷
OT_ERROR_NO_BUFS
CoAP প্রতিক্রিয়া পাঠানোর জন্য অপর্যাপ্ত বাফার উপলব্ধ।

otCoapSecureSetCaCertificateChain

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

বিশ্বস্ত শীর্ষ স্তরের CA সেট করে৷

পিয়ার সার্টিফিকেট যাচাই করার জন্য এটি প্রয়োজন।

DTLS মোড "ECDHE ECDSA with AES 128 CCM 8" অ্যাপ্লিকেশন CoAPS এর জন্য।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aX509CaCertificateChain
PEM ফর্ম্যাট X509 CA চেইনের একটি পয়েন্টার৷
[in] aX509CaCertChainLength
চেইনের দৈর্ঘ্য।

otCoapSecureSetCertificate

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

DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 এর সাথে DTLS সেশনের জন্য সংশ্লিষ্ট ব্যক্তিগত কী সহ স্থানীয় ডিভাইসের X509 শংসাপত্র সেট করে৷

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aX509Cert
PEM ফর্ম্যাট X509 শংসাপত্রের একটি পয়েন্টার৷
[in] aX509Length
শংসাপত্রের দৈর্ঘ্য।
[in] aPrivateKey
PEM ফরম্যাট করা ব্যক্তিগত কী-এর একটি পয়েন্টার।
[in] aPrivateKeyLength
ব্যক্তিগত কীটির দৈর্ঘ্য।

otCoapSecureSetClientConnectedCallback

void otCoapSecureSetClientConnectedCallback(
  otInstance *aInstance,
  otHandleCoapSecureClientConnect aHandler,
  void *aContext
)

একটি ক্লায়েন্ট যখন CoAP সিকিউর সার্ভারের সাথে সংযুক্ত হয় তখন নির্দেশিত করার জন্য সংযুক্ত কলব্যাক সেট করে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aHandler
একটি ফাংশনের একটি পয়েন্টার যা একবার DTLS সংযোগ প্রতিষ্ঠিত হলে বলা হবে।
[in] aContext
নির্বিচারে প্রসঙ্গ তথ্যের একটি পয়েন্টার। ব্যবহার না করলে NULL হতে পারে।

otCoapSecureSetDefaultHandler

void otCoapSecureSetDefaultHandler(
  otInstance *aInstance,
  otCoapRequestHandler aHandler,
  void *aContext
)

নিয়ন্ত্রণহীন CoAP সিকিউর অনুরোধের জন্য ডিফল্ট হ্যান্ডলার সেট করে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aHandler
একটি ফাংশন পয়েন্টার যেটিকে কল করা হবে যখন একটি আন-হ্যান্ডেলড অনুরোধ আসে।
[in] aContext
নির্বিচারে প্রসঙ্গ তথ্যের একটি পয়েন্টার। ব্যবহার না করলে NULL হতে পারে।

otCoapSecureSetPsk

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

প্রি-শেয়ারড কী (PSK) এবং সাইফার স্যুট DTLS_PSK_WITH_AES_128_CCM_8 সেট করে৷

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aPsk
পিএসকে একটি নির্দেশক।
[in] aPskLength
পিএসকে দৈর্ঘ্য।
[in] aPskIdentity
PSK-এর পরিচয়ের নাম।
[in] aPskIdLength
পিএসকে আইডেন্টিটি দৈর্ঘ্য।

otCoapSecureSetSslAuthMode

void otCoapSecureSetSslAuthMode(
  otInstance *aInstance,
  bool aVerifyPeerCertificate
)

কোপ সুরক্ষিত সংযোগের জন্য প্রমাণীকরণ মোড সেট করে।

পিয়ার সার্টিফিকেট যাচাইকরণ নিষ্ক্রিয় বা সক্ষম করুন। শুরু করার আগে অবশ্যই কল করতে হবে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aVerifyPeerCertificate
সত্য, পিয়ার সার্টিফিকেট যাচাই করতে।

otCoapSecureStart

otError otCoapSecureStart(
  otInstance *aInstance,
  uint16_t aPort
)

CoAP সিকিউর পরিষেবা শুরু করে৷

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.
[in] aPort
স্থানীয় UDP পোর্ট যা আবদ্ধ করতে হবে।
রিটার্ন মান
OT_ERROR_NONE
CoAP সিকিউর সার্ভার সফলভাবে শুরু হয়েছে৷

otCoapSecureStop

void otCoapSecureStop(
  otInstance *aInstance
)

CoAP সিকিউর সার্ভার বন্ধ করে।

বিস্তারিত
পরামিতি
[in] aInstance
একটি OpenThread উদাহরণের একটি পয়েন্টার.

ম্যাক্রো

OT_DEFAULT_COAP_SECURE_PORT

 OT_DEFAULT_COAP_SECURE_PORT 5684

ডিফল্ট CoAP সিকিউর পোর্ট, যেমন RFC 7252 এ উল্লেখ করা হয়েছে।

সম্পদ

OpenThread API রেফারেন্স বিষয়গুলি উৎস কোড থেকে উদ্ভূত হয়, যা GitHub- এ উপলব্ধ। আরও তথ্যের জন্য, বা আমাদের ডকুমেন্টেশনে অবদান রাখতে, সম্পদ দেখুন।