nl::Weave::Crypto

इस नेमस्पेस में, शेयर किए गए क्रिप्टोग्राफ़िक सपोर्ट के लिए Weave के सभी इंटरफ़ेस शामिल हैं.

खास जानकारी

इन्यूमरेशन

X963EncodedPointFormat enum

टाइपडिफ़

AES128CTRDRBG टाइपडिफ़
AES128CTRMode टाइपडिफ़
AES256CTRMode टाइपडिफ़
EntropyFunct)(uint8_t *buf, size_t bufSize) टाइपडिफ़
int(*
किसी एंट्रॉपी सोर्स से रैंडम डेटा इकट्ठा करने के लिए इस्तेमाल किए जाने वाले फ़ंक्शन का हस्ताक्षर.
HKDFSHA1 टाइपडिफ़
HKDFSHA256 टाइपडिफ़
HMACSHA1 टाइपडिफ़
HMACSHA256 टाइपडिफ़

फ़ंक्शन

ClearSecretData(uint8_t *buf, uint32_t len)
NL_DLL_EXPORT void
मेमोरी क्षेत्र के पहले len बाइट buf साफ़ करता है.
ConstantTimeCompare(const uint8_t *buf1, const uint8_t *buf2, uint16_t len)
bool
मेमोरी एरिया buf1 और मेमोरी एरिया buf2 के पहले len बाइट की तुलना करता है.
DecodeBIGNUMValueLE(BIGNUM & val, uint16_t size, const uint8_t *& p)
DecodeECDSASignature(const EncodedECDSASignature & encodedSig, ECDSA_SIG *& sig)
DecodeECKey(OID curveOID, const EncodedECPrivateKey *encodedPrivKey, const EncodedECPublicKey *encodedPubKey, EC_KEY *& ecKey)
NL_DLL_EXPORT WEAVE_ERROR
DecodeX962ECPoint(const uint8_t *encodedPoint, uint16_t encodedPointLen, EC_GROUP *group, EC_POINT *& point)
NL_DLL_EXPORT WEAVE_ERROR
DecodeX962ECPoint(const uint8_t *encodedPoint, uint16_t encodedPointLen, BIGNUM *& x, BIGNUM *& y)
ECDHComputeSharedSecret(OID curveOID, const EC_GROUP *ecGroup, const EC_POINT *pubKeyPoint, const BIGNUM *privKeyBN, uint8_t *sharedSecretBuf, uint16_t sharedSecretBufSize, uint16_t & sharedSecretLen)
NL_DLL_EXPORT WEAVE_ERROR
ECDHComputeSharedSecret(OID curveOID, const EncodedECPublicKey & encodedPubKey, const EncodedECPrivateKey & encodedPrivKey, uint8_t *sharedSecretBuf, uint16_t sharedSecretBufSize, uint16_t & sharedSecretLen)
ECDSASigToFixedLenSig(OID curveOID, const ECDSA_SIG *ecSig, uint8_t *fixedLenSig)
ECDSA_SIG_get0(const ECDSA_SIG *sig, const BIGNUM **pr, const BIGNUM **ps)
void
ECDSA_SIG_set0(ECDSA_SIG *sig, BIGNUM *r, BIGNUM *s)
int
EncodeBIGNUMValueLE(const BIGNUM & val, uint16_t size, uint8_t *& p)
EncodeECDSASignature(const ECDSA_SIG *sig, EncodedECDSASignature & encodedSig)
EncodeX962ECPoint(OID curveOID, EC_GROUP *ecGroup, const EC_POINT *point, uint8_t *buf, uint16_t bufSize, uint16_t & encodedPointLen)
NL_DLL_EXPORT WEAVE_ERROR
FixedLenSigToECDSASig(OID curveOID, const uint8_t *fixedLenSig, ECDSA_SIG *& ecSig)
GenerateAndEncodeWeaveHMACSignature(OID sigAlgoOID, TLVWriter & writer, uint64_t tag, const uint8_t *data, uint16_t dataLen, const uint8_t *key, uint16_t keyLen)
Weave HMAC हस्ताक्षर जनरेट करें और उसे कोड में बदलें.
GenerateAndEncodeWeaveRSASignature(OID sigAlgoOID, TLVWriter & writer, uint64_t tag, const uint8_t *hash, uint8_t hashLen, const uint8_t *keyDER, uint16_t keyDERLen)
Weave आरएसए हस्ताक्षर जनरेट करें और कोड में बदलें.
GenerateECDHKey(OID curveOID, EncodedECPublicKey & encodedPubKey, EncodedECPrivateKey & encodedPrivKey)
GenerateECDSASignature(OID curveOID, const uint8_t *msgHash, uint8_t msgHashLen, const EncodedECPrivateKey & encodedPrivKey, EncodedECDSASignature & encodedSig)
GenerateECDSASignature(OID curveOID, const uint8_t *msgHash, uint8_t msgHashLen, const EncodedECPrivateKey & encodedPrivKey, uint8_t *fixedLenSig)
GetCurveG(OID curveOID, EncodedECPublicKey & encodedPubKey)
GetCurveSize(const OID curveOID, const EC_GROUP *ecGroup)
int
GetCurveSize(const OID curveOID)
int
इलिप्टिक कर्व का साइज़ (बाइट में) पाएं.
GetECGroupForCurve(OID curveOID, EC_GROUP *& ecGroup)
NL_DLL_EXPORT WEAVE_ERROR
ReverseBytes(uint8_t *buf, size_t len)
void
ShaNIDFromSigAlgoOID(OID sigAlgoOID)
int
VerifyECDSASignature(OID curveOID, const uint8_t *msgHash, uint8_t msgHashLen, const EncodedECDSASignature & encodedSig, const EncodedECPublicKey & encodedPubKey)
VerifyECDSASignature(OID curveOID, const uint8_t *msgHash, uint8_t msgHashLen, const uint8_t *fixedLenSig, const EncodedECPublicKey & encodedPubKey)
VerifyHMACSignature(OID sigAlgoOID, const uint8_t *data, uint16_t dataLen, const EncodedHMACSignature & sig, const uint8_t *key, uint16_t keyLen)
वीव HMAC हस्ताक्षर की पुष्टि करें.
VerifyRSASignature(OID sigAlgoOID, const uint8_t *hash, uint8_t hashLen, const EncodedRSASignature & sig, const uint8_t *certDER, uint16_t certDERLen)
Weave आरएसए हस्ताक्षर की पुष्टि करें.

क्लास

nl::Weave::Crypto::CTRMode
nl::Weave::Crypto::CTR_DRBG
nl::Weave::Crypto::EncodedECDSASignature
nl::Weave::Crypto::EncodedECPrivateKey
nl::Weave::Crypto::EncodedECPublicKey
nl::Weave::Crypto::EncodedHMACSignature
nl::Weave::Crypto::EncodedRSAKey
nl::Weave::Crypto::EncodedRSASignature
nl::Weave::Crypto::HKDF
nl::Weave::Crypto::HKDFSHA1Or256
nl::Weave::Crypto::HMAC

इन्यूमरेशन

X963EncodedPointFormat

 X963EncodedPointFormat

टाइपडिफ़

एईएस128 सीटीआरडीआरबीजी

CTR_DRBG< Platform::Security::AES128BlockCipherEnc > AES128CTRDRBG

AES128 सीटीआर मोड

CTRMode< Platform::Security::AES128BlockCipherEnc > AES128CTRMode

AES256 सीटीआर मोड

CTRMode< Platform::Security::AES256BlockCipherEnc > AES256CTRMode

EntropyFunct

int(* EntropyFunct)(uint8_t *buf, size_t bufSize)

किसी एंट्रॉपी सोर्स से रैंडम डेटा इकट्ठा करने के लिए इस्तेमाल किए जाने वाले फ़ंक्शन का हस्ताक्षर.

HKDFSHA1

HKDF< Platform::Security::SHA1 > HKDFSHA1

HKDFSHA256

HKDF< Platform::Security::SHA256 > HKDFSHA256

HMACSHA1

HMAC< Platform::Security::SHA1 > HMACSHA1

HMACSHA256

HMAC< Platform::Security::SHA256 > HMACSHA256

फ़ंक्शन

ClearSecretData

NL_DLL_EXPORT void ClearSecretData(
  uint8_t *buf,
  uint32_t len
)

मेमोरी क्षेत्र के पहले len बाइट buf साफ़ करता है.

इसे लागू करने पर, मेमोरी एरिया buf के पहले len बाइट में शून्य भर जाते हैं.

ब्यौरा
पैरामीटर
[in] buf
उस मेमोरी बफ़र की ओर इशारा करता है जिसमें गुप्त डेटा है, जिसे साफ़ किया जाना चाहिए.
[in] len
यह नीति सीक्रेट डेटा का साइज़ बाइट में तय करती है.

ConstantTimeCompare

bool ConstantTimeCompare(
  const uint8_t *buf1,
  const uint8_t *buf2,
  uint16_t len
)

मेमोरी एरिया buf1 और मेमोरी एरिया buf2 के पहले len बाइट की तुलना करता है.

इस फ़ंक्शन में लगने वाला समय, buf1 और buf2 की मेमोरी वाली जगहों के डेटा पर निर्भर नहीं करता है.

ब्यौरा
पैरामीटर
[in] buf1
किसी मेमोरी ब्लॉक पर कर्सर ले जाएं.
[in] buf2
किसी मेमोरी ब्लॉक पर कर्सर ले जाएं.
[in] len
बाइट में तुलना करने के लिए, मेमोरी एरिया का साइज़.
रिटर्न वैल्यू
true
अगर मेमोरी एरिया buf1 और buf2 के पहले len बाइट बराबर हैं.
false
नहीं तो.

DecodeBIGNUMValueLE

WEAVE_ERROR DecodeBIGNUMValueLE(
  BIGNUM & val,
  uint16_t size,
  const uint8_t *& p
)

DecodeECDSASignature

WEAVE_ERROR DecodeECDSASignature(
  const EncodedECDSASignature & encodedSig,
  ECDSA_SIG *& sig
)

DecodeECKey

NL_DLL_EXPORT WEAVE_ERROR DecodeECKey(
  OID curveOID,
  const EncodedECPrivateKey *encodedPrivKey,
  const EncodedECPublicKey *encodedPubKey,
  EC_KEY *& ecKey
)

DecodeX962ECPoint

NL_DLL_EXPORT WEAVE_ERROR DecodeX962ECPoint(
  const uint8_t *encodedPoint,
  uint16_t encodedPointLen,
  EC_GROUP *group,
  EC_POINT *& point
)

DecodeX962ECPoint

WEAVE_ERROR DecodeX962ECPoint(
  const uint8_t *encodedPoint,
  uint16_t encodedPointLen,
  BIGNUM *& x,
  BIGNUM *& y
)

ECDHComputeSharedSecret

NL_DLL_EXPORT WEAVE_ERROR ECDHComputeSharedSecret(
  OID curveOID,
  const EC_GROUP *ecGroup,
  const EC_POINT *pubKeyPoint,
  const BIGNUM *privKeyBN,
  uint8_t *sharedSecretBuf,
  uint16_t sharedSecretBufSize,
  uint16_t & sharedSecretLen
)

ECDHComputeSharedSecret

WEAVE_ERROR ECDHComputeSharedSecret(
  OID curveOID,
  const EncodedECPublicKey & encodedPubKey,
  const EncodedECPrivateKey & encodedPrivKey,
  uint8_t *sharedSecretBuf,
  uint16_t sharedSecretBufSize,
  uint16_t & sharedSecretLen
)

ECDSASigToFixedLenSig

WEAVE_ERROR ECDSASigToFixedLenSig(
  OID curveOID,
  const ECDSA_SIG *ecSig,
  uint8_t *fixedLenSig
)

ECDSA_SIG_get0

void ECDSA_SIG_get0(
  const ECDSA_SIG *sig,
  const BIGNUM **pr,
  const BIGNUM **ps
)

ECDSA_SIG_set0

int ECDSA_SIG_set0(
  ECDSA_SIG *sig,
  BIGNUM *r,
  BIGNUM *s
)

EncodeBIGNUMValueLE

WEAVE_ERROR EncodeBIGNUMValueLE(
  const BIGNUM & val,
  uint16_t size,
  uint8_t *& p
)

EncodeECDSASignature

WEAVE_ERROR EncodeECDSASignature(
  const ECDSA_SIG *sig,
  EncodedECDSASignature & encodedSig
)

EncodeX962ECPoint

NL_DLL_EXPORT WEAVE_ERROR EncodeX962ECPoint(
  OID curveOID,
  EC_GROUP *ecGroup,
  const EC_POINT *point,
  uint8_t *buf,
  uint16_t bufSize,
  uint16_t & encodedPointLen
)

FixedLenSigToECDSASig

WEAVE_ERROR FixedLenSigToECDSASig(
  OID curveOID,
  const uint8_t *fixedLenSig,
  ECDSA_SIG *& ecSig
)

GenerateAndEncodeWeaveHMACSignature

WEAVE_ERROR GenerateAndEncodeWeaveHMACSignature(
  OID sigAlgoOID,
  TLVWriter & writer,
  uint64_t tag,
  const uint8_t *data,
  uint16_t dataLen,
  const uint8_t *key,
  uint16_t keyLen
)

Weave HMAC हस्ताक्षर जनरेट करें और उसे कोड में बदलें.

सीक्रेट कुंजी का इस्तेमाल करके, दिए गए डेटा के लिए HMAC हस्ताक्षर की गणना करता है. साथ ही, दिए गए टैग के साथ तय किए गए TLV राइटर के लिए, हस्ताक्षर को Weave HMACSignature स्ट्रक्चर के तौर पर लिखता है.

ब्यौरा
पैरामीटर
[in] sigAlgoOID
HMAC हस्ताक्षर जनरेट करने के लिए इस्तेमाल किया जाने वाला एल्गोरिदम OID.
[in] writer
TLVWriter ऑब्जेक्ट, जिस पर कोड में बदले गए हस्ताक्षर लिखे जाने चाहिए.
[in] tag
कोड में बदले गए हस्ताक्षर के स्ट्रक्चर से जोड़ने के लिए TLV टैग.
[in] data
एक बफ़र, जिसमें हस्ताक्षर किया जाने वाला डेटा होता है.
[in] dataLen
डेटा की लंबाई (बाइट में).
[in] key
सीक्रेट कुंजी वाला बफ़र, जिसका इस्तेमाल HMAC हस्ताक्षर जनरेट करने के लिए किया जाता है.
[in] keyLen
सीक्रेट कुंजी की लंबाई बाइट में.
रिटर्न वैल्यू
WEAVE_NO_ERROR
अगर कार्रवाई पूरी हो गई.
other
हस्ताक्षर एन्कोडिंग से संबंधित अन्य Weave गड़बड़ी कोड.

GenerateAndEncodeWeaveRSASignature

WEAVE_ERROR GenerateAndEncodeWeaveRSASignature(
  OID sigAlgoOID,
  TLVWriter & writer,
  uint64_t tag,
  const uint8_t *hash,
  uint8_t hashLen,
  const uint8_t *keyDER,
  uint16_t keyDERLen
)

Weave आरएसए हस्ताक्षर जनरेट करें और कोड में बदलें.

यह X509 कोड में बदली गई आरएसए निजी कुंजी और मैसेज हैश का इस्तेमाल करके, आरएसए सिग्नेचर की गणना करता है. साथ ही, दिए गए टैग के साथ, तय किए गए TLV राइटर के लिए, हस्ताक्षर को Weave RSASignature स्ट्रक्चर के तौर पर लिखता है.

ब्यौरा
पैरामीटर
[in] sigAlgoOID
आरएसए सिग्नेचर जनरेट करने के लिए, OID एल्गोरिदम OID का इस्तेमाल किया गया.
[in] writer
TLVWriter ऑब्जेक्ट, जिस पर कोड में बदले गए हस्ताक्षर लिखे जाने चाहिए.
[in] tag
कोड में बदले गए हस्ताक्षर के स्ट्रक्चर से जोड़ने के लिए TLV टैग.
[in] hash
एक बफ़र, जिसमें हस्ताक्षर किए जाने वाले डेटा का हैश मौजूद होता है.
[in] hashLen
डेटा हैश की लंबाई बाइट में.
[in] keyDER
निजी पासकोड वाला बफ़र, जिसका इस्तेमाल हस्ताक्षर जनरेट करने के लिए किया जाता है. निजी कुंजी को X509 आरएसए निजी कुंजी के स्ट्रक्चर के तौर पर एन्कोड करना चाहिए.
[in] keyDERLen
कोड में बदले गए निजी पासकोड की लंबाई बाइट में.
रिटर्न वैल्यू
WEAVE_NO_ERROR
अगर कार्रवाई पूरी हो गई.
other
निजी पासकोड को डिकोड करने, सिग्नेचर जनरेट करने या सिग्नेचर को कोड में बदलने से जुड़े अन्य Weave गड़बड़ी कोड.

GenerateECDHKey

WEAVE_ERROR GenerateECDHKey(
  OID curveOID,
  EncodedECPublicKey & encodedPubKey,
  EncodedECPrivateKey & encodedPrivKey
)

GenerateECDSASignature

WEAVE_ERROR GenerateECDSASignature(
  OID curveOID,
  const uint8_t *msgHash,
  uint8_t msgHashLen,
  const EncodedECPrivateKey & encodedPrivKey,
  EncodedECDSASignature & encodedSig
)

GenerateECDSASignature

WEAVE_ERROR GenerateECDSASignature(
  OID curveOID,
  const uint8_t *msgHash,
  uint8_t msgHashLen,
  const EncodedECPrivateKey & encodedPrivKey,
  uint8_t *fixedLenSig
)

GetCurveG

WEAVE_ERROR GetCurveG(
  OID curveOID,
  EncodedECPublicKey & encodedPubKey
)

GetCurveSize

int GetCurveSize(
  const OID curveOID,
  const EC_GROUP *ecGroup
)

GetCurveSize

int GetCurveSize(
  const OID curveOID
)

इलिप्टिक कर्व का साइज़ (बाइट में) पाएं.

ब्यौरा
पैरामीटर
[in] curveOID
तय इलिप्टिक कर्व OID.
रिटर्न वैल्यू
Returns
0, अगर बताया गया OID काम नहीं करता है. ऐसा न होने पर, बाइट में कर्व का साइज़ दिखाता है.

GetECGroupForCurve

NL_DLL_EXPORT WEAVE_ERROR GetECGroupForCurve(
  OID curveOID,
  EC_GROUP *& ecGroup
)

ReverseBytes

void ReverseBytes(
  uint8_t *buf,
  size_t len
)

ShaNIDFromSigAlgoOID

int ShaNIDFromSigAlgoOID(
  OID sigAlgoOID
)

VerifyECDSASignature

WEAVE_ERROR VerifyECDSASignature(
  OID curveOID,
  const uint8_t *msgHash,
  uint8_t msgHashLen,
  const EncodedECDSASignature & encodedSig,
  const EncodedECPublicKey & encodedPubKey
)

VerifyECDSASignature

WEAVE_ERROR VerifyECDSASignature(
  OID curveOID,
  const uint8_t *msgHash,
  uint8_t msgHashLen,
  const uint8_t *fixedLenSig,
  const EncodedECPublicKey & encodedPubKey
)

VerifyHMACSignature

WEAVE_ERROR VerifyHMACSignature(
  OID sigAlgoOID,
  const uint8_t *data,
  uint16_t dataLen,
  const EncodedHMACSignature & sig,
  const uint8_t *key,
  uint16_t keyLen
)

वीव HMAC हस्ताक्षर की पुष्टि करें.

दिए गए डेटा का इस्तेमाल करके HMAC हस्ताक्षर की पुष्टि करता है. साथ ही, हस्ताक्षर की पुष्टि करने के लिए इस्तेमाल की जाने वाली सीक्रेट कुंजी की पुष्टि करता है.

ब्यौरा
पैरामीटर
[in] sigAlgoOID
HMAC हस्ताक्षर जनरेट करने के लिए इस्तेमाल किया जाने वाला एल्गोरिदम OID.
[in] data
एक बफ़र, जिसमें हस्ताक्षर किया जाने वाला डेटा होता है.
[in] dataLen
डेटा की लंबाई (बाइट में).
[in] sig
पुष्टि के लिए, HMAC हस्ताक्षर को कोड में बदला गया है.
[in] key
सीक्रेट कुंजी वाला बफ़र, जिसका इस्तेमाल HMAC हस्ताक्षर जनरेट करने के लिए किया जाता है.
[in] keyLen
सीक्रेट कुंजी की लंबाई बाइट में.
रिटर्न वैल्यू
WEAVE_NO_ERROR
अगर HMAC हस्ताक्षर की पुष्टि हो गई है.
WEAVE_ERROR_INVALID_SIGNATURE
अगर HMAC हस्ताक्षर की पुष्टि नहीं हो सकी.

VerifyRSASignature

WEAVE_ERROR VerifyRSASignature(
  OID sigAlgoOID,
  const uint8_t *hash,
  uint8_t hashLen,
  const EncodedRSASignature & sig,
  const uint8_t *certDER,
  uint16_t certDERLen
)

Weave आरएसए हस्ताक्षर की पुष्टि करें.

दिए गए डेटा हैश का इस्तेमाल करके आरएसए सिग्नेचर की पुष्टि करता है. साथ ही, X509 कोड में बदले गए आरएसए सर्टिफ़िकेट की पुष्टि करता है, जिसमें सार्वजनिक पासकोड मौजूद होता है. इस सर्टिफ़िकेट का इस्तेमाल हस्ताक्षर की पुष्टि करने के लिए किया जाता है.

ब्यौरा
पैरामीटर
[in] sigAlgoOID
आरएसए सिग्नेचर जनरेट करने के लिए, OID एल्गोरिदम OID का इस्तेमाल किया गया.
[in] hash
एक बफ़र, जिसमें हस्ताक्षर किए जाने वाले डेटा का हैश मौजूद होता है.
[in] hashLen
डेटा हैश की लंबाई बाइट में.
[in] sig
कोड में बदले गए आरएसए हस्ताक्षर की पुष्टि की जानी है.
[in] certDER
एक बफ़र, जिसमें हस्ताक्षर की पुष्टि करने के लिए सार्वजनिक पासकोड वाला सर्टिफ़िकेट होता है. इस सर्टिफ़िकेट के लिए X509 आरएसए स्ट्रक्चर को DER एन्कोड करने की उम्मीद की जाती है.
[in] certDERLen
कोड में बदले गए सर्टिफ़िकेट की लंबाई बाइट में.
रिटर्न वैल्यू
WEAVE_NO_ERROR
अगर कार्रवाई पूरी हो गई.