Google is committed to advancing racial equity for Black communities. See how.

本頁面由 Cloud Translation API 翻譯而成。

nl::編織::Crypto

此命名空間包含 Weave 內所有支援共用加密支援的介面。

總結

列舉
`X963EncodedPointFormat`	列舉

Typedefs
`AES128CTRDRBG`	typedef `CTR_DRBG< Platform::Security::AES128BlockCipherEnc >`
`AES128CTRMode`	typedef `CTRMode< Platform::Security::AES128BlockCipherEnc >`
`AES256CTRMode`	typedef `CTRMode< Platform::Security::AES256BlockCipherEnc >`
`EntropyFunct)(uint8_t *buf, size_t bufSize)`	typedef `int(*` 用來收集熵來源隨機資料的函式簽章。
`HKDFSHA1`	typedef `HKDF< Platform::Security::SHA1 >`
`HKDFSHA256`	typedef `HKDF< Platform::Security::SHA256 >`
`HMACSHA1`	typedef `HMAC< Platform::Security::SHA1 >`
`HMACSHA256`	typedef `HMAC< Platform::Security::SHA256 >`

函式
`ClearSecretData(uint8_t *buf, uint32_t len)`	`NL_DLL_EXPORT void` 清除記憶體區域「`buf`」的前 `len` 個位元組。
`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)`	`WEAVE_ERROR`
`DecodeECDSASignature(const EncodedECDSASignature & encodedSig, ECDSA_SIG *& sig)`	`WEAVE_ERROR`
`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)`	`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)`	`NL_DLL_EXPORT WEAVE_ERROR`
`ECDHComputeSharedSecret(OID curveOID, const EncodedECPublicKey & encodedPubKey, const EncodedECPrivateKey & encodedPrivKey, uint8_t *sharedSecretBuf, uint16_t sharedSecretBufSize, uint16_t & sharedSecretLen)`	`WEAVE_ERROR`
`ECDSASigToFixedLenSig(OID curveOID, const ECDSA_SIG ecSig, uint8_t fixedLenSig)`	`WEAVE_ERROR`
`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)`	`WEAVE_ERROR`
`EncodeECDSASignature(const ECDSA_SIG *sig, EncodedECDSASignature & encodedSig)`	`WEAVE_ERROR`
`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)`	`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_ERROR` 產生並編碼 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_ERROR` 產生並對 Weave RSA 簽名進行編碼。
`GenerateECDHKey(OID curveOID, EncodedECPublicKey & encodedPubKey, EncodedECPrivateKey & encodedPrivKey)`	`WEAVE_ERROR`
`GenerateECDSASignature(OID curveOID, const uint8_t *msgHash, uint8_t msgHashLen, const EncodedECPrivateKey & encodedPrivKey, EncodedECDSASignature & encodedSig)`	`WEAVE_ERROR`
`GenerateECDSASignature(OID curveOID, const uint8_t msgHash, uint8_t msgHashLen, const EncodedECPrivateKey & encodedPrivKey, uint8_t fixedLenSig)`	`WEAVE_ERROR`
`GetCurveG(OID curveOID, EncodedECPublicKey & encodedPubKey)`	`WEAVE_ERROR`
`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)`	`WEAVE_ERROR`
`VerifyECDSASignature(OID curveOID, const uint8_t msgHash, uint8_t msgHashLen, const uint8_t fixedLenSig, const EncodedECPublicKey & encodedPubKey)`	`WEAVE_ERROR`
`VerifyHMACSignature(OID sigAlgoOID, const uint8_t data, uint16_t dataLen, const EncodedHMACSignature & sig, const uint8_t key, uint16_t keyLen)`	`WEAVE_ERROR` 驗證 Weave HMAC 簽名。
`VerifyRSASignature(OID sigAlgoOID, const uint8_t hash, uint8_t hashLen, const EncodedRSASignature & sig, const uint8_t certDER, uint16_t certDERLen)`	`WEAVE_ERROR` 驗證 Weave RSA 簽名。

類別
nl::Weave::Crypto::CTRMode
nl::編織::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::編織::Crypto::HKDF
nl::Weave::Crypto::HKDFSHA1Or256
nl::Weave::Crypto::HMAC

列舉

X963EncodedPointFormat

 X963EncodedPointFormat

Typedefs

AES128CTRDRBG

CTR_DRBG< Platform::Security::AES128BlockCipherEnc > AES128CTRDRBG

AES128CTRMode

CTRMode< Platform::Security::AES128BlockCipherEnc > AES128CTRMode

AES256CTRMode

CTRMode< Platform::Security::AES256BlockCipherEnc > AES256CTRMode

熵

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

函式

ClearSecret 資料

NL_DLL_EXPORT void ClearSecretData(
  uint8_t *buf,
  uint32_t len
)

清除記憶體區域「buf」的前 len 個位元組。

在此實作中，記憶體區域「buf」的前 len 個位元組有零。

詳細資料

參數

`[in] buf`	指向應清除快取的記憶體緩衝區。
`[in] len`	指定密鑰資料大小 (以位元組為單位)。

常數時間比較

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`	。

解碼 BIGNUMValueLE

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

DecodeECDSA 簽名

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

解碼碼

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
)

編碼 BIGNUMValueLE

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

EncodeECDSA 簽名

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
)

已修正：LenSigToECDSASig

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

產生 AndEncodeWeaveHMAC 簽名

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 簽名，並將簽名做為 Weave HMACSignature 結構寫入指定的 TLV 寫入器和指定標記。

詳細資料

參數

`[in] sigAlgoOID`	用來產生 HMAC 簽名的演算法 OID。
`[in] writer`	要寫入編碼簽名的 TLVWriter 物件。
`[in] tag`	TLV 標記，以便與編碼的簽名結構建立關聯。
`[in] data`	包含要簽署資料的緩衝區。
`[in] dataLen`	資料的長度 (以位元組為單位)。
`[in] key`	包含用來產生 HMAC 簽章的密鑰的緩衝區。
`[in] keyLen`	密鑰長度 (以位元組為單位)。

傳回值

`WEAVE_NO_ERROR`	如果作業成功，
`other`	其他與簽名編碼相關的 Weave 錯誤代碼。

產生及編碼 WeaveRSASignature

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 RSA 簽名進行編碼。

使用指定的 X509 編碼 RSA 私密金鑰和郵件雜湊來計算 RSA 簽名，並將簽名以 Weave RSASignature 結構寫入指定的標記 TLV 寫入器中。

詳細資料

參數

`[in] sigAlgoOID`	用來產生 RSA 簽名的演算法 OID。
`[in] writer`	要寫入編碼簽名的 TLVWriter 物件。
`[in] tag`	TLV 標記，以便與編碼的簽名結構建立關聯。
`[in] hash`	包含待簽署資料的雜湊的緩衝區。
`[in] hashLen`	資料雜湊的位元組長度。
`[in] keyDER`	包含用來產生簽章的私密金鑰的緩衝區。私密金鑰預計會編碼為 X509 RSA 私密金鑰結構。
`[in] keyDERLen`	編碼私密金鑰的長度 (以位元組為單位)。

傳回值

`WEAVE_NO_ERROR`	如果作業成功，
`other`	其他與解碼私密金鑰、產生簽章或為簽名編碼相關的 Weave 錯誤代碼。

產生 ECDHKey

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

GenerateECDSA 簽名

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

GenerateECDSA 簽名

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

如果指定的曲線 OID 不支援橢圓曲線，則為 0。否則，會傳回以位元組為單位的曲線大小。

GetECGroupForCurve

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

反向位元組數

void ReverseBytes(
  uint8_t *buf,
  size_t len
)

ShaNIDFromSigAlgoOID

int ShaNIDFromSigAlgoOID(
  OID sigAlgoOID
)

驗證 ECDSA 簽名

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

驗證 ECDSA 簽名

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

驗證 HMAC 簽名

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

驗證 Weave 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 簽名驗證失敗，

驗證 RSA 簽名

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

驗證 Weave RSA 簽名。

使用指定的資料雜湊和 X509 編碼的 RSA 憑證，驗證要用於驗證簽章的 RSA 簽名。

詳細資料

參數

`[in] sigAlgoOID`	用來產生 RSA 簽名的演算法 OID。
`[in] hash`	包含待簽署資料的雜湊的緩衝區。
`[in] hashLen`	資料雜湊的位元組長度。
`[in] sig`	經過編碼的 RSA 簽名，以便驗證。
`[in] certDER`	緩衝區，其中的憑證包含用來驗證簽名的公開金鑰。憑證預期使用 DER 編碼為 X509 RSA 結構。
`[in] certDERLen`	編碼憑證的位元組長度。

傳回值

WEAVE_NO_ERROR

如果作業成功，

nl::編織::Crypto

總結

列舉

Typedefs

函式

類別

列舉

X963EncodedPointFormat

Typedefs

AES128CTRDRBG

AES128CTRMode

AES256CTRMode

熵

HKDFSHA1

HKDFSHA256

HMACSHA1

HMACSHA256

函式

ClearSecret 資料

常數時間比較

解碼 BIGNUMValueLE

DecodeECDSA 簽名

解碼碼

DecodeX962ECPoint

DecodeX962ECPoint

ECDHComputeSharedSecret

ECDHComputeSharedSecret

ECDSASigToFixedLenSig

ECDSA_SIG_get0

ECDSA_SIG_set0

編碼 BIGNUMValueLE

EncodeECDSA 簽名

EncodeX962ECPoint

已修正：LenSigToECDSASig

產生 AndEncodeWeaveHMAC 簽名

產生及編碼 WeaveRSASignature

產生 ECDHKey

GenerateECDSA 簽名

GenerateECDSA 簽名

GetCurveG

GetCurveSize

GetCurveSize

GetECGroupForCurve

反向位元組數

ShaNIDFromSigAlgoOID

驗證 ECDSA 簽名

驗證 ECDSA 簽名

驗證 HMAC 簽名

驗證 RSA 簽名