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

nl::Weave::Profiles::Security::Passcodes

這個命名空間包含 Weave 中有關 Weave 安全性設定檔內 Weave 密碼庫的所有介面。

摘要

列舉
`@278{ kPasscode_Config1_TEST_ONLY = 0x01, kPasscode_Config2 = 0x02, kPasscodeConfig1_KeyId = WeaveKeyId::kNone }`	列舉武器密碼加密設定類型。
@279{ kPasscodeEncryptionKeyLen = Platform::Security::AES128BlockCipher::kKeyLength, kPasscodeAuthenticationKeyLen = Platform::Security::SHA1::kHashLength, kPasscodeFingerprintKeyLen = Platform::Security::SHA1::kHashLength, kPasscodeTotalDerivedKeyLen = kPasscodeEncryptionKeyLen + kPasscodeAuthenticationKeyLen, kPasscodePaddedLen = Platform::Security::AES128BlockCipher::kBlockLength, kPasscodeAuthenticatorLen = 8, kPasscodeFingerprintLen = 8, kPasscodeMaxEncryptedLen = sizeof(uint8_t) + 2 * sizeof(uint32_t) + kPasscodePaddedLen + kPasscodeAuthenticatorLen + kPasscodeFingerprintLen, kPasscodeMaxLen = kPasscodePaddedLen, kPasscodeEncKeyDiversifierSize = sizeof(kPasscodeEncKeyDiversifier) + sizeof(uint8_t), kPasscodeFingerprintKeyDiversifierSize = sizeof(kPasscodeFingerprintKeyDiversifier) }	列舉武器密碼加密通訊協定參數大小。

列舉

@278{
  kPasscode_Config1_TEST_ONLY = 0x01,
  kPasscode_Config2 = 0x02,
  kPasscodeConfig1_KeyId = WeaveKeyId::kNone
}

列舉

武器密碼加密設定類型。

@279{
  kPasscodeEncryptionKeyLen = Platform::Security::AES128BlockCipher::kKeyLength,
  kPasscodeAuthenticationKeyLen = Platform::Security::SHA1::kHashLength,
  kPasscodeFingerprintKeyLen = Platform::Security::SHA1::kHashLength,
  kPasscodeTotalDerivedKeyLen = kPasscodeEncryptionKeyLen + kPasscodeAuthenticationKeyLen,
  kPasscodePaddedLen = Platform::Security::AES128BlockCipher::kBlockLength,
  kPasscodeAuthenticatorLen = 8,
  kPasscodeFingerprintLen = 8,
  kPasscodeMaxEncryptedLen = sizeof(uint8_t) + 2 * sizeof(uint32_t) + kPasscodePaddedLen +
                                                          kPasscodeAuthenticatorLen + kPasscodeFingerprintLen,
  kPasscodeMaxLen = kPasscodePaddedLen,
  kPasscodeEncKeyDiversifierSize = sizeof(kPasscodeEncKeyDiversifier) + sizeof(uint8_t),
  kPasscodeFingerprintKeyDiversifierSize = sizeof(kPasscodeFingerprintKeyDiversifier)
}

列舉

武器密碼加密通訊協定參數大小。

變數
`kPasscodeEncKeyDiversifier = { 0x1A, 0x65, 0x5D, 0x96 }[]`	`const uint8_t` 用於改造密碼加密金鑰的金鑰分流器。
`kPasscodeFingerprintKeyDiversifier = { 0xD1, 0xA1, 0xD9, 0x6C }[]`	`const uint8_t` 用於改造密碼加密金鑰的金鑰分流器。

函式
`DecryptPasscode(const uint8_t encPasscode, size_t encPasscodeLen, uint8_t passcodeBuf, size_t passcodeBufSize, size_t & passcodeLen, GroupKeyStoreBase *groupKeyStore)`	`WEAVE_ERROR` 將使用 Nest 密碼加密機制加密的密碼解密。
`DecryptPasscode(const uint8_t encPasscode, size_t encPasscodeLen, const uint8_t encKey, const uint8_t authKey, const uint8_t fingerprintKey, uint8_t *passcodeBuf, size_t passcodeBufSize, size_t & passcodeLen)`	`WEAVE_ERROR` 將使用 Nest 密碼加密機制加密的密碼解密。
`EncryptPasscode(uint8_t config, uint32_t keyId, uint32_t nonce, const uint8_t passcode, size_t passcodeLen, uint8_t encPasscode, size_t encPasscodeBufSize, size_t & encPasscodeLen, GroupKeyStoreBase *groupKeyStore)`	`WEAVE_ERROR` 使用 Nest 密碼加密機制將密碼加密。
`EncryptPasscode(uint8_t config, uint32_t keyId, uint32_t nonce, const uint8_t passcode, size_t passcodeLen, const uint8_t encKey, const uint8_t authKey, const uint8_t fingerprintKey, uint8_t *encPasscode, size_t encPasscodeBufSize, size_t & encPasscodeLen)`	`WEAVE_ERROR` 使用 Nest 密碼加密機制將密碼加密。
`GetEncryptedPasscodeConfig(const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t & config)`	`WEAVE_ERROR` 取得加密密碼的設定類型。
`GetEncryptedPasscodeFingerprint(const uint8_t encPasscode, size_t encPasscodeLen, uint8_t fingerprintBuf, size_t fingerprintBufSize, size_t & fingerprintLen)`	`WEAVE_ERROR` 取得與加密密碼相關聯的指紋值。
`GetEncryptedPasscodeKeyId(const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & keyId)`	`WEAVE_ERROR` 取得用於加密已加密密碼的金鑰 ID。
`GetEncryptedPasscodeNonce(const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & nonce)`	`WEAVE_ERROR` 取得與加密密碼相關聯的 Nonce 值。
`IsSupportedPasscodeEncryptionConfig(uint8_t config)`	`bool` 如果密碼加密/解密 API 支援提供的密碼加密設定，則傳回 true。

Structs
nl::Weave::Profiles::Security::Passcodes::EncryptedPasscodeStruct

列舉

278 次

 @278

武器密碼加密設定類型。

屬性

屬性
`kPasscodeConfig1_KeyId`	用於測試密碼設定 #1 的虛擬金鑰 ID。
`kPasscode_Config1_TEST_ONLY`	密碼加密設定 #1 未使用加密金鑰和密鑰來驗證及指紋密碼。這項設定「必須」用於測試用途。
`kPasscode_Config2`	密碼加密設定 #2 使用 AES-128-ECB 加密與 8 位元組的 HMAC-SHA-1 完整性，以及 8 位元組的 HMAC-SHA-1 指紋。

kPasscodeConfig1_KeyId

用於測試密碼設定 #1 的虛擬金鑰 ID。

kPasscode_Config1_TEST_ONLY

密碼加密設定 #1 未使用加密金鑰和密鑰來驗證及指紋密碼。

這項設定「必須」用於測試用途。

kPasscode_Config2

密碼加密設定 #2 使用 AES-128-ECB 加密與 8 位元組的 HMAC-SHA-1 完整性，以及 8 位元組的 HMAC-SHA-1 指紋。

279 人

 @279

武器密碼加密通訊協定參數大小。

屬性
`kPasscodeAuthenticationKeyLen`	密碼驗證 (SHA-1) 金鑰長度。
`kPasscodeAuthenticatorLen`	密碼驗證器長度。
`kPasscodeEncKeyDiversifierSize`	密碼加密應用程式金鑰分隔碼大小。
`kPasscodeEncryptionKeyLen`	密碼加密 (AES-128) 金鑰長度。
`kPasscodeFingerprintKeyDiversifierSize`	密碼指紋金鑰多樣性大小。
`kPasscodeFingerprintKeyLen`	密碼指紋 (SHA-1) 金鑰長度。
`kPasscodeFingerprintLen`	密碼指紋長度。
`kPasscodeMaxEncryptedLen`	加密密碼長度上限。
`kPasscodeMaxLen`	密碼長度上限。
`kPasscodePaddedLen`	密碼長度 (會填充為 AES-128 區塊長度)。
`kPasscodeTotalDerivedKeyLen`	金鑰總長度 (加密和完整性)。

變數

kPasscodeEncKeyDiversifier

const uint8_t kPasscodeEncKeyDiversifier[] = { 0x1A, 0x65, 0x5D, 0x96 }

用於改造密碼加密金鑰的金鑰分流器。

這個值代表「Nest Passcode EK and AK」中 SHA-1 HASH 的前 4 個位元組詞組。

kPasscodeFingerprintKeyDiversifier

const uint8_t kPasscodeFingerprintKeyDiversifier[] = { 0xD1, 0xA1, 0xD9, 0x6C }

用於改造密碼加密金鑰的金鑰分流器。

這個值代表「Nest Passcode EK and AK」中 SHA-1 HASH 的前 4 個位元組詞組。

函式

DecryptPasscode

WEAVE_ERROR DecryptPasscode(
  const uint8_t *encPasscode,
  size_t encPasscodeLen,
  uint8_t *passcodeBuf,
  size_t passcodeBufSize,
  size_t & passcodeLen,
  GroupKeyStoreBase *groupKeyStore
)

將使用 Nest 密碼加密機制加密的密碼解密。

詳細資料

參數

`[in] encPasscode`	加密密碼緩衝區的指標。
`[in] encPasscodeLen`	加密密碼長度。
`[in] passcodeBuf`	指向緩衝區的指標，用於接收已解密的密碼。
`[in] passcodeBufSize`	以密碼 Buf 指向的緩衝區大小。
`[out] passcodeLen`	設定解密密碼的長度。
`[in] groupKeyStore`	群組金鑰儲存庫物件的指標。

傳回值

`WEAVE_NO_ERROR`	成功時。
`WEAVE_ERROR_UNSUPPORTED_PASSCODE_CONFIG`	不支援指定密碼設定。
`WEAVE_ERROR_PASSCODE_AUTHENTICATION_FAILED`	密碼驗證失敗時傳送的結果。
`WEAVE_ERROR_PASSCODE_FINGERPRINT_FAILED`	密碼指紋檢查失敗時。
`WEAVE_ERROR_INVALID_KEY_ID`	如果要求的金鑰 ID 無效，
`WEAVE_ERROR_BUFFER_TOO_SMALL`	如果提供的密碼緩衝區太小。
`WEAVE_ERROR_INVALID_ARGUMENT`	如果密碼太短或太長或者，如未提供指向群組金鑰儲存庫的指標，或平台金鑰儲存庫傳回無效的金鑰參數，
`other`	平台金鑰存放區 API 傳回的其他平台專屬錯誤。

DecryptPasscode

WEAVE_ERROR DecryptPasscode(
  const uint8_t *encPasscode,
  size_t encPasscodeLen,
  const uint8_t *encKey,
  const uint8_t *authKey,
  const uint8_t *fingerprintKey,
  uint8_t *passcodeBuf,
  size_t passcodeBufSize,
  size_t & passcodeLen
)

將使用 Nest 密碼加密機制加密的密碼解密。

詳細資料

參數

`[in] encPasscode`	加密密碼緩衝區的指標。
`[in] encPasscodeLen`	加密密碼長度。
`[in] encKey`	用於加密密碼的金鑰指標。金鑰的長度必須符合與指定設定相關聯的加密演算法。
`[in] authKey`	用於驗證密碼的金鑰指標。金鑰的長度必須符合與指定設定相關聯的驗證演算法。
`[in] fingerprintKey`	用於產生密碼指紋的金鑰指標。金鑰的長度必須符合與指定設定相關聯的指紋演算法。
`[in] passcodeBuf`	指向緩衝區的指標，用於接收已解密的密碼。
`[in] passcodeBufSize`	以密碼 Buf 指向的緩衝區大小。
`[out] passcodeLen`	設定解密密碼的長度。

傳回值

`WEAVE_NO_ERROR`	成功時。
`WEAVE_ERROR_UNSUPPORTED_PASSCODE_CONFIG`	不支援指定密碼設定。
`WEAVE_ERROR_PASSCODE_AUTHENTICATION_FAILED`	密碼驗證失敗時傳送的結果。
`WEAVE_ERROR_PASSCODE_FINGERPRINT_FAILED`	密碼指紋檢查失敗時。
`WEAVE_ERROR_BUFFER_TOO_SMALL`	如果提供的密碼緩衝區太小。
`WEAVE_ERROR_INVALID_ARGUMENT`	如果密碼太短或太長。

EncryptPasscode

WEAVE_ERROR EncryptPasscode(
  uint8_t config,
  uint32_t keyId,
  uint32_t nonce,
  const uint8_t *passcode,
  size_t passcodeLen,
  uint8_t *encPasscode,
  size_t encPasscodeBufSize,
  size_t & encPasscodeLen,
  GroupKeyStoreBase *groupKeyStore
)

使用 Nest 密碼加密機制將密碼加密。

詳細資料

參數

`[in] config`	要使用的密碼加密設定。
`[in] keyId`	要求的密碼加密金鑰 ID。
`[in] nonce`	指派給加密密碼的專屬值。
`[in] passcode`	要加密的密碼指標。
`[in] passcodeLen`	密碼長度。
`[out] encPasscode`	指向用來儲存加密密碼的緩衝區指標。
`[in] encPasscodeBufSize`	加密密碼儲存空間的緩衝區大小。
`[out] encPasscodeLen`	加密密碼長度。
`[in] groupKeyStore`	群組金鑰儲存庫物件的指標。

傳回值

`WEAVE_NO_ERROR`	成功時。
`WEAVE_ERROR_UNSUPPORTED_PASSCODE_CONFIG`	不支援指定密碼設定。
`WEAVE_ERROR_BUFFER_TOO_SMALL`	如果提供的輸出緩衝區太小，無法用於加密密碼。
`WEAVE_ERROR_INVALID_KEY_ID`	如果要求的金鑰 ID 無效，
`WEAVE_ERROR_INVALID_ARGUMENT`	如果提供的密碼太短或太長或者，如未提供指向群組金鑰儲存庫的指標，或平台金鑰儲存庫傳回無效的金鑰參數，
`other`	平台金鑰存放區 API 傳回的其他平台專屬錯誤。

EncryptPasscode

WEAVE_ERROR EncryptPasscode(
  uint8_t config,
  uint32_t keyId,
  uint32_t nonce,
  const uint8_t *passcode,
  size_t passcodeLen,
  const uint8_t *encKey,
  const uint8_t *authKey,
  const uint8_t *fingerprintKey,
  uint8_t *encPasscode,
  size_t encPasscodeBufSize,
  size_t & encPasscodeLen
)

使用 Nest 密碼加密機制將密碼加密。

詳細資料

參數

`[in] config`	要使用的 Weave 密碼加密設定。
`[in] keyId`	要求的密碼加密金鑰 ID。
`[in] nonce`	指派給密碼的專屬值。
`[in] passcode`	要加密的密碼指標。
`[in] passcodeLen`	密碼長度。
`[in] encKey`	用於加密密碼的金鑰指標。金鑰的長度必須符合與指定設定相關聯的加密演算法。
`[in] authKey`	用於驗證密碼的金鑰指標。金鑰的長度必須符合與指定設定相關聯的驗證演算法。
`[in] fingerprintKey`	用於產生密碼指紋的金鑰指標。金鑰的長度必須符合與指定設定相關聯的指紋演算法。
`[out] encPasscode`	指向儲存加密密碼的緩衝區。這個緩衝區不得小於 kPasscodeMaxEncryptedLen。
`[in] encPasscodeBufSize`	encPasscode 指向的緩衝區大小。
`[out] encPasscodeLen`	加密密碼長度。

傳回值

`WEAVE_NO_ERROR`	成功時。
`WEAVE_ERROR_UNSUPPORTED_PASSCODE_CONFIG`	不支援指定密碼設定。
`WEAVE_ERROR_BUFFER_TOO_SMALL`	如果提供的輸出緩衝區太小，無法用於加密密碼。
`WEAVE_ERROR_INVALID_ARGUMENT`	如果提供的密碼太短或太長。

GetEncryptedPasscodeConfig

WEAVE_ERROR GetEncryptedPasscodeConfig(
  const uint8_t *encPasscode,
  size_t encPasscodeLen,
  uint8_t & config
)

取得加密密碼的設定類型。

詳細資料

參數

`[in] encPasscode`	指向包含已加密密碼的緩衝區。
`[in] encPasscodeLen`	加密密碼的長度。
`[out] config`	加密密碼使用的 Weave 密碼加密設定。

GetEncryptedPasscodeFingerprint

WEAVE_ERROR GetEncryptedPasscodeFingerprint(
  const uint8_t *encPasscode,
  size_t encPasscodeLen,
  uint8_t *fingerprintBuf,
  size_t fingerprintBufSize,
  size_t & fingerprintLen
)

取得與加密密碼相關聯的指紋值。

詳細資料

參數

`[in] encPasscode`	指向包含已加密密碼的緩衝區。
`[in] encPasscodeLen`	加密密碼的長度。
`[in] fingerprintBuf`	用於接收指紋值的緩衝區。
`[in] fingerprintBufSize`	以指紋 Buf 指向的緩衝區大小。
`[out] fingerprintLen`	傳回的指紋值長度。

GetEncryptedPasscodeKeyId

WEAVE_ERROR GetEncryptedPasscodeKeyId(
  const uint8_t *encPasscode,
  size_t encPasscodeLen,
  uint32_t & keyId
)

取得用於加密已加密密碼的金鑰 ID。

詳細資料

參數

`[in] encPasscode`	指向包含已加密密碼的緩衝區。
`[in] encPasscodeLen`	加密密碼的長度。
`[out] keyId`	用於加密已加密密碼的金鑰 ID。

GetEncryptedPasscodeNonce

WEAVE_ERROR GetEncryptedPasscodeNonce(
  const uint8_t *encPasscode,
  size_t encPasscodeLen,
  uint32_t & nonce
)

取得與加密密碼相關聯的 Nonce 值。

詳細資料

參數

`[in] encPasscode`	指向包含已加密密碼的緩衝區。
`[in] encPasscodeLen`	加密密碼的長度。
`[out] nonce`	與加密密碼相關聯的 Nonce 值。

IsSupportedPasscodeEncryptionConfig

bool IsSupportedPasscodeEncryptionConfig(
  uint8_t config
)

如果密碼加密/解密 API 支援提供的密碼加密設定，則傳回 true。

nl::Weave::Profiles::Security::Passcodes

摘要

列舉

變數

函式

Structs

列舉

278 次

279 人

變數

kPasscodeEncKeyDiversifier

kPasscodeFingerprintKeyDiversifier

函式

DecryptPasscode

DecryptPasscode

EncryptPasscode

EncryptPasscode

GetEncryptedPasscodeConfig

GetEncryptedPasscodeFingerprint

GetEncryptedPasscodeKeyId

GetEncryptedPasscodeNonce

IsSupportedPasscodeEncryptionConfig