nl:: Weave:: Profiles:: Security:: Passcodes
Este espacio de nombres incluye todas las interfaces de Weave para la biblioteca de contraseñas de Weave dentro del perfil de seguridad de Weave.
Resumen
Enumeraciones |
|
---|---|
@278{
|
enum Tipos de configuración de encriptación de contraseñas de Weave. |
@279{
|
enum Tamaños de los parámetros del protocolo de encriptación de contraseñas de Weave. |
Variables |
|
---|---|
kPasscodeEncKeyDiversifier = { 0x1A, 0x65, 0x5D, 0x96 }[]
|
const uint8_t
Diversificador de claves utilizado para la derivación de claves de encriptación de contraseñas de Weave.
|
kPasscodeFingerprintKeyDiversifier = { 0xD1, 0xA1, 0xD9, 0x6C }[]
|
const uint8_t
Diversificador de claves utilizado para la derivación de claves de encriptación de contraseñas de Weave.
|
remotas |
|
---|---|
DecryptPasscode(const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *passcodeBuf, size_t passcodeBufSize, size_t & passcodeLen, GroupKeyStoreBase *groupKeyStore)
|
Desencripta una contraseña que se encriptó con el esquema de encriptación de contraseña de 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)
|
Desencripta una contraseña que se encriptó con el esquema de encriptación de contraseña de 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)
|
Encripta una contraseña con el esquema de encriptación de contraseña de 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)
|
Encripta una contraseña con el esquema de encriptación de contraseña de Nest.
|
GetEncryptedPasscodeConfig(const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t & config)
|
Obtén el tipo de configuración de una contraseña encriptada.
|
GetEncryptedPasscodeFingerprint(const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *fingerprintBuf, size_t fingerprintBufSize, size_t & fingerprintLen)
|
Obtén el valor de la huella digital asociado con una contraseña encriptada.
|
GetEncryptedPasscodeKeyId(const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & keyId)
|
Obtén el ID de la clave que se usó para encriptar una contraseña encriptada.
|
GetEncryptedPasscodeNonce(const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & nonce)
|
Obtén el valor del nonce asociado con una contraseña encriptada.
|
IsSupportedPasscodeEncryptionConfig(uint8_t config)
|
bool
Muestra true si la configuración de encriptación de contraseña proporcionada es compatible con las APIs de encriptación/desencriptación de contraseña.
|
Structs |
|
---|---|
nl:: |
Enumeraciones
@278
@278
Tipos de configuración de encriptación de contraseñas de Weave.
Propiedades | |
---|---|
kPasscodeConfig1_KeyId
|
ID de clave ficticio usado para la configuración de contraseña de prueba núm. 1. |
kPasscode_Config1_TEST_ONLY
|
La configuración de encriptación de código de acceso n° 1 no usa encriptación ni claves secretas para la autenticación y la huella digital de la contraseña. Esta configuración DEBE usarse únicamente con fines de PRUEBA. |
kPasscode_Config2
|
La configuración de encriptación de código de acceso n° 2 usa encriptación AES-128-ECB con integridad HMAC-SHA-1 de 8 bytes y huella digital HMAC-SHA-1 de 8 bytes. |
@279
@279
Tamaños de los parámetros del protocolo de encriptación de contraseñas de Weave.
Propiedades | |
---|---|
kPasscodeAuthenticationKeyLen
|
Longitud de la clave de autenticación con código de acceso (SHA-1). |
kPasscodeAuthenticatorLen
|
Longitud del autenticador de código de acceso. |
kPasscodeEncKeyDiversifierSize
|
Tamaño del diversificador de claves de la aplicación de encriptación de contraseñas. |
kPasscodeEncryptionKeyLen
|
Longitud de la clave de encriptación de contraseña (AES-128). |
kPasscodeFingerprintKeyDiversifierSize
|
Tamaño del diversificador de la clave de huella digital de código de acceso. |
kPasscodeFingerprintKeyLen
|
Longitud de la clave de la huella digital de código de acceso (SHA-1). |
kPasscodeFingerprintLen
|
Longitud de la huella digital del código de acceso. |
kPasscodeMaxEncryptedLen
|
Longitud máxima de la contraseña encriptada. |
kPasscodeMaxLen
|
Longitud máxima de contraseña no encriptada. |
kPasscodePaddedLen
|
Longitud del código de acceso (con relleno según la longitud del bloque AES-128). |
kPasscodeTotalDerivedKeyLen
|
Longitud total de la clave de código de acceso (integridad y encriptación). |
Variables
kPasscodeEncKeyDiversifier
const uint8_t kPasscodeEncKeyDiversifier[] = { 0x1A, 0x65, 0x5D, 0x96 }
Diversificador de claves utilizado para la derivación de claves de encriptación de contraseñas de Weave.
Este valor representa los primeros 4 bytes de la HASH SHA-1 de la frase “Nest Passcode EK and AK”.
kPasscodeFingerprintKeyDiversifier
const uint8_t kPasscodeFingerprintKeyDiversifier[] = { 0xD1, 0xA1, 0xD9, 0x6C }
Diversificador de claves utilizado para la derivación de claves de encriptación de contraseñas de Weave.
Este valor representa los primeros 4 bytes de la HASH SHA-1 de la frase “Nest Passcode EK and AK”.
remotas
DecryptPasscode
WEAVE_ERROR DecryptPasscode( const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *passcodeBuf, size_t passcodeBufSize, size_t & passcodeLen, GroupKeyStoreBase *groupKeyStore )
Desencripta una contraseña que se encriptó con el esquema de encriptación de contraseña de Nest.
Detalles | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parámetros |
|
||||||||||||||||
Valores que se muestran |
|
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 )
Desencripta una contraseña que se encriptó con el esquema de encriptación de contraseña de Nest.
Detalles | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parámetros |
|
||||||||||||||||
Valores que se muestran |
|
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 )
Encripta una contraseña con el esquema de encriptación de contraseña de Nest.
Detalles | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parámetros |
|
||||||||||||||||||
Valores que se muestran |
|
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 )
Encripta una contraseña con el esquema de encriptación de contraseña de Nest.
Detalles | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parámetros |
|
||||||||||||||||||||||
Valores que se muestran |
|
GetEncryptedPasscodeConfig
WEAVE_ERROR GetEncryptedPasscodeConfig( const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t & config )
Obtén el tipo de configuración de una contraseña encriptada.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
GetEncryptedPasscodeFingerprint
WEAVE_ERROR GetEncryptedPasscodeFingerprint( const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *fingerprintBuf, size_t fingerprintBufSize, size_t & fingerprintLen )
Obtén el valor de la huella digital asociado con una contraseña encriptada.
Detalles | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Parámetros |
|
GetEncryptedPasscodeKeyId
WEAVE_ERROR GetEncryptedPasscodeKeyId( const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & keyId )
Obtén el ID de la clave que se usó para encriptar una contraseña encriptada.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
GetEncryptedPasscodeNonce
WEAVE_ERROR GetEncryptedPasscodeNonce( const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & nonce )
Obtén el valor del nonce asociado con una contraseña encriptada.
Detalles | |||||||
---|---|---|---|---|---|---|---|
Parámetros |
|
IsSupportedPasscodeEncryptionConfig
bool IsSupportedPasscodeEncryptionConfig( uint8_t config )
Muestra true si la configuración de encriptación de contraseña proporcionada es compatible con las APIs de encriptación/desencriptación de contraseña.