Google 致力于为黑人社区推动种族平等。查看具体举措。

此页面由 Cloud Translation API 翻译。

nl::Weave::加密

此命名空间包括 Weave 中的所有接口，用于提供共享加密支持。

摘要

枚举
`X963EncodedPointFormat`	枚举

类型定义符
`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::CTR 模式
nl::Weave::Crypto::CTR_DRBG
nl::Weave::Crypto::经过编码的 ECDSASignature
nl::Weave::Crypto::EncodedECPrivateKey
nl::Weave::Crypto::EncodedECPublicKey
nl::Weave::Crypto::经过编码的 HMACSignature
nl::Weave::Crypto::经过编码的 RSAKey
nl::Weave::Crypto::经过编码的 RSASignature
nl::Weave::Crypto::HKDF
nl::Weave::Crypto::HKDFSHA1Or256
nl::Weave::Crypto::HMAC

枚举

X963 编码编码格式

 X963EncodedPointFormat

类型定义符

AES128CTRDRBG

CTR_DRBG< Platform::Security::AES128BlockCipherEnc > AES128CTRDRBG

AES128 点击率模式

CTRMode< Platform::Security::AES128BlockCipherEnc > AES128CTRMode

AES256 点击率模式

CTRMode< Platform::Security::AES256BlockCipherEnc > AES256CTRMode

熵功能

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

用于从熵源收集随机数据的函数签名。

港元

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
)

清除内存区域 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
)

解码 DSADSASignature

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
)

解码 X962ECPoint

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

解码 X962ECPoint

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
)

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
)

固定屏幕标识符 ECECSig

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 签名，并以 Weave HMACSignature 结构的形式将该签名写入具有指定标记的指定 TLV 写入程序。

详细信息

参数

`[in] sigAlgoOID`	用于生成 HMAC 签名的算法 OID。
`[in] writer`	应写入编码签名的 TLVWriter 对象。
`[in] tag`	与经过编码的签名结构相关联的 TLV 标记。
`[in] data`	包含待签署数据的缓冲区。
`[in] dataLen`	数据的长度（以字节为单位）。
`[in] key`	包含用于生成 HMAC 签名的密钥的缓冲区。
`[in] keyLen`	Secret 的长度（以字节为单位）。

返回值

`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 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 错误代码。

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

如果指定的曲线 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
)

验证 ECDSASignature

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

验证 ECDSASignature

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`	Secret 的长度（以字节为单位）。

返回值

`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

操作是否成功。