Trang này được dịch bởi Cloud Translation API.

nl::Weave::Mã hóa

Vùng chứa tên này bao gồm tất cả giao diện trong Weave để hỗ trợ mật mã dùng chung.

Tóm tắt

Bảng liệt kê
`X963EncodedPointFormat`	enum

Typedef
`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(*` Chữ ký của một hàm dùng để thu thập dữ liệu ngẫu nhiên từ một nguồn entropy.
`HKDFSHA1`	typedef `HKDF< Platform::Security::SHA1 >`
`HKDFSHA256`	typedef `HKDF< Platform::Security::SHA256 >`
`HMACSHA1`	typedef `HMAC< Platform::Security::SHA1 >`
`HMACSHA256`	typedef `HMAC< Platform::Security::SHA256 >`

Hàm
`ClearSecretData(uint8_t *buf, uint32_t len)`	`NL_DLL_EXPORT void` Xóa `len` byte đầu tiên của vùng bộ nhớ `buf`.
`ConstantTimeCompare(const uint8_t buf1, const uint8_t buf2, uint16_t len)`	`bool` So sánh `len` byte đầu tiên của vùng bộ nhớ `buf1` và vùng bộ nhớ `buf2`.
`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` Tạo và mã hóa chữ ký HMAC của Weave.
`GenerateAndEncodeWeaveRSASignature(OID sigAlgoOID, TLVWriter & writer, uint64_t tag, const uint8_t hash, uint8_t hashLen, const uint8_t keyDER, uint16_t keyDERLen)`	`WEAVE_ERROR` Tạo và mã hóa chữ ký Wesve 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` Nhận kích thước đường cong hình elip (tính bằng byte).
`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` Xác minh chữ ký Weave HMAC.
`VerifyRSASignature(OID sigAlgoOID, const uint8_t hash, uint8_t hashLen, const EncodedRSASignature & sig, const uint8_t certDER, uint16_t certDERLen)`	`WEAVE_ERROR` Xác minh chữ ký Weave RSA.

Lớp
nl::Weave::Mật khẩu::CTRMode
nl::Weave::Tiền mã hóa::CTR_DRBG
nl::Weave::Mật khẩu::Chữ ký được mã hóa ECDSA
nl::Weave:: Mật mã::EnEncryptionEC PrivateKey
nl::Weave:: Mật mã::EnEncryptionECpublicKey
nl::Weave::Mật khẩu::Mã hóa được mã hoá MACMAC
nl::Weave:: Mật mã::EkEncryptionRSAKey
nl::Weave::Mật khẩu::Mã hóa được mã hóa
nl::Weave::Mật khẩu::HKDF
nl::Weave::crypt::HKDFSHA1Or256
nl::Weave::Mật khẩu::HMAC

Bảng liệt kê

X963EnEncodingPointFormat

 X963EncodedPointFormat

Typedef

AES128CTRDRBG

CTR_DRBG< Platform::Security::AES128BlockCipherEnc > AES128CTRDRBG

Chế độ AES128CTRMode

CTRMode< Platform::Security::AES128BlockCipherEnc > AES128CTRMode

Chế độ AES256CTRMode

CTRMode< Platform::Security::AES256BlockCipherEnc > AES256CTRMode

Tác phẩm EntropyFunct

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

Chữ ký của một hàm dùng để thu thập dữ liệu ngẫu nhiên từ một nguồn entropy.

HKDFSHA1

HKDF< Platform::Security::SHA1 > HKDFSHA1

HKDFSHA256

HKDF< Platform::Security::SHA256 > HKDFSHA256

Hàm MACMAC1

HMAC< Platform::Security::SHA1 > HMACSHA1

HMACSHA256

HMAC< Platform::Security::SHA256 > HMACSHA256

Hàm

Dữ liệu bí mật

NL_DLL_EXPORT void ClearSecretData(
  uint8_t *buf,
  uint32_t len
)

Xóa len byte đầu tiên của vùng bộ nhớ buf.

Trong quá trình triển khai này, len byte dung lượng bộ nhớ buf đầu tiên được lấp đầy bằng 0.

Thông tin chi tiết

Các thông số

`[in] buf`	Trỏ vào một bộ nhớ đệm lưu dữ liệu bí mật cần xóa.
`[in] len`	Chỉ định kích thước dữ liệu bí mật tính bằng byte.

So sánh thời gian không đổi

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

So sánh len byte đầu tiên của vùng bộ nhớ buf1 và vùng bộ nhớ buf2.

Thời gian mà hàm này thực hiện độc lập với dữ liệu trong các vùng bộ nhớ buf1 và buf2.

Thông tin chi tiết

Các thông số

`[in] buf1`	Trỏ vào một khối kỷ niệm.
`[in] buf2`	Trỏ vào một khối kỷ niệm.
`[in] len`	Kích thước của bộ nhớ để so sánh bằng byte.

Giá trị trả về

`true`	nếu `len` byte đầu tiên của diện tích bộ nhớ `buf1` và `buf2` bằng nhau.
`false`	nếu không.

Giải mãVANNUMNUMGiá trị

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

Chữ ký giải mã ECDSA

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

Giải mã ECKey

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

Giải mãX962ECPoint

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

Giải mãX962ECPoint

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

Điện toán chung được chia sẻ

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
)

Điện toán chung được chia sẻ

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

ECDSASigToFixLenSig

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
)

Chữ ký EncodeECDSA

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

Mã hóaX962ECPoint

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

Ống kính cố định

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

CreateAndEncodeWeaveHMACSignature

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

Tạo và mã hóa chữ ký HMAC của Weave.

Tính toán chữ ký HMAC cho một dữ liệu nhất định bằng cách sử dụng khóa bí mật và viết chữ ký dưới dạng cấu trúc Have HMACChữ ký cho trình ghi TLV được chỉ định có thẻ đã cho.

Thông tin chi tiết

Các thông số

`[in] sigAlgoOID`	Thuật toán OID dùng để tạo chữ ký HMAC.
`[in] writer`	Đối tượng TLVWriter cần viết chữ ký được mã hóa.
`[in] tag`	Thẻ TLV được liên kết với cấu trúc chữ ký đã mã hóa.
`[in] data`	Vùng đệm chứa dữ liệu cần ký.
`[in] dataLen`	Độ dài tính bằng byte của dữ liệu.
`[in] key`	Vùng đệm chứa khóa bí mật dùng để tạo chữ ký HMAC.
`[in] keyLen`	Độ dài tính bằng byte của khóa bí mật.

Giá trị trả về

`WEAVE_NO_ERROR`	Nếu thao tác thành công.
`other`	Các mã lỗi Weave khác liên quan đến mã hóa chữ ký.

CreateAndEncodeWeaveRSAChữ ký

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

Tạo và mã hóa chữ ký Wesve RSA.

Tính toán chữ ký RSA bằng cách sử dụng khóa cá nhân RSA được mã hóa X509 và hàm băm thông báo và ghi chữ ký dưới dạng cấu trúc RSA chữ ký Weave cho tác giả TLV đã chỉ định với thẻ đã cho.

Thông tin chi tiết

Các thông số

`[in] sigAlgoOID`	Thuật toán OID dùng để tạo chữ ký RSA.
`[in] writer`	Đối tượng TLVWriter cần viết chữ ký được mã hóa.
`[in] tag`	Thẻ TLV được liên kết với cấu trúc chữ ký đã mã hóa.
`[in] hash`	Vùng đệm chứa dữ liệu băm để ký.
`[in] hashLen`	Độ dài tính bằng byte của hàm băm dữ liệu.
`[in] keyDER`	Vùng đệm chứa khóa riêng tư sẽ dùng để tạo chữ ký. Khóa cá nhân dự kiến sẽ được mã hóa dưới dạng cấu trúc khóa riêng tư RSA X509.
`[in] keyDERLen`	Độ dài tính bằng byte của khóa riêng tư được mã hóa.

Giá trị trả về

`WEAVE_NO_ERROR`	Nếu thao tác thành công.
`other`	Các mã lỗi Weave khác liên quan đến việc giải mã khóa riêng tư, tạo chữ ký hoặc mã hóa chữ ký.

Tạo khóa ECDHKey

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

Chữ ký CreateECDSA

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

Chữ ký CreateECDSA

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
)

Nhận kích thước đường cong hình elip (tính bằng byte).

Thông tin chi tiết

Các thông số

[in] curveOID

OID đường cong cụ thể.

Giá trị trả về

Returns

0 nếu đường congOOID được chỉ định là Đường cong elip không được hỗ trợ. Nếu không, trả về kích thước đường cong tính bằng byte.

GetECGroupForCurve

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

Đảo ngược

void ReverseBytes(
  uint8_t *buf,
  size_t len
)

ShaNIDTừSigAlgoOID

int ShaNIDFromSigAlgoOID(
  OID sigAlgoOID
)

Xác minh chữ ký ECECDSA

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

Xác minh chữ ký ECECDSA

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

Xác minh

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

Xác minh chữ ký Weave HMAC.

Xác minh chữ ký HMAC bằng cách sử dụng dữ liệu đã cho và khoá bí mật dùng để xác minh chữ ký.

Thông tin chi tiết

Các thông số

`[in] sigAlgoOID`	Thuật toán OID dùng để tạo chữ ký HMAC.
`[in] data`	Vùng đệm chứa dữ liệu cần ký.
`[in] dataLen`	Độ dài tính bằng byte của dữ liệu.
`[in] sig`	Chữ ký HMAC được mã hóa cần được xác minh.
`[in] key`	Vùng đệm chứa khóa bí mật dùng để tạo chữ ký HMAC.
`[in] keyLen`	Độ dài tính bằng byte của khóa bí mật.

Giá trị trả về

`WEAVE_NO_ERROR`	Nếu xác minh chữ ký HMAC thành công.
`WEAVE_ERROR_INVALID_SIGNATURE`	Nếu không xác minh được chữ ký HMAC.

Chữ ký Xác minh quảng cáo

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

Xác minh chữ ký Weave RSA.

Xác minh chữ ký RSA bằng một dữ liệu băm đã cho và một chứng chỉ RSA được mã hóa X509 có chứa khóa công khai được dùng để xác minh chữ ký.

Thông tin chi tiết

Các thông số

`[in] sigAlgoOID`	Thuật toán OID dùng để tạo chữ ký RSA.
`[in] hash`	Vùng đệm chứa dữ liệu băm để ký.
`[in] hashLen`	Độ dài tính bằng byte của hàm băm dữ liệu.
`[in] sig`	Chữ ký RSA đã mã hóa cần xác minh.
`[in] certDER`	Vùng đệm chứa chứng chỉ có khóa công khai sẽ dùng để xác minh chữ ký. Chứng chỉ dự kiến sẽ được mã hóa theo DER và có cấu trúc RSA X509.
`[in] certDERLen`	Độ dài tính bằng byte của chứng chỉ được mã hóa.

Giá trị trả về

WEAVE_NO_ERROR

Nếu thao tác thành công.

nl::Weave::Mã hóa

Tóm tắt

Bảng liệt kê

Typedef

Hàm

Lớp

Bảng liệt kê

X963EnEncodingPointFormat

Typedef

AES128CTRDRBG

Chế độ AES128CTRMode

Chế độ AES256CTRMode

Tác phẩm EntropyFunct

HKDFSHA1

HKDFSHA256

Hàm MACMAC1

HMACSHA256

Hàm

Dữ liệu bí mật

So sánh thời gian không đổi

Giải mãVANNUMNUMGiá trị

Chữ ký giải mã ECDSA

Giải mã ECKey

Giải mãX962ECPoint

Giải mãX962ECPoint

Điện toán chung được chia sẻ

Điện toán chung được chia sẻ

ECDSASigToFixLenSig

ECDSA_SIG_get0

ECDSA_SIG_set0

EncodeBIGNUMValueLE

Chữ ký EncodeECDSA

Mã hóaX962ECPoint

Ống kính cố định

CreateAndEncodeWeaveHMACSignature

CreateAndEncodeWeaveRSAChữ ký

Tạo khóa ECDHKey

Chữ ký CreateECDSA

Chữ ký CreateECDSA

GetCurveG

GetCurveSize

GetCurveSize

GetECGroupForCurve

Đảo ngược

ShaNIDTừSigAlgoOID

Xác minh chữ ký ECECDSA

Xác minh chữ ký ECECDSA

Xác minh

Chữ ký Xác minh quảng cáo