nl:: Weave:: Profiles:: Security:: Passcodes
Questo spazio dei nomi include tutte le interfacce di Weave per la libreria dei passcode di Weave all'interno del profilo di sicurezza Weave.
Riepilogo
Enumerazioni |
|
---|---|
@278{
|
enum Tipi di configurazione della crittografia con passcode Weave. |
@279{
|
enum Dimensioni dei parametri del protocollo di crittografia passcode di Weave. |
Variabili |
|
---|---|
kPasscodeEncKeyDiversifier = { 0x1A, 0x65, 0x5D, 0x96 }[]
|
const uint8_t
Diversificatore di chiavi utilizzato per la derivazione della chiave di crittografia del passcode di Weave.
|
kPasscodeFingerprintKeyDiversifier = { 0xD1, 0xA1, 0xD9, 0x6C }[]
|
const uint8_t
Diversificatore di chiavi utilizzato per la derivazione della chiave di crittografia del passcode di Weave.
|
Funzioni |
|
---|---|
DecryptPasscode(const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *passcodeBuf, size_t passcodeBufSize, size_t & passcodeLen, GroupKeyStoreBase *groupKeyStore)
|
Decripta un passcode criptato usando lo schema di crittografia di Nest Passcode.
|
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)
|
Decripta un passcode criptato usando lo schema di crittografia di Nest Passcode.
|
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)
|
Cripta un passcode utilizzando lo schema di crittografia di Nest Passcode.
|
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)
|
Cripta un passcode utilizzando lo schema di crittografia di Nest Passcode.
|
GetEncryptedPasscodeConfig(const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t & config)
|
Recupera il tipo di configurazione di un passcode criptato.
|
GetEncryptedPasscodeFingerprint(const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *fingerprintBuf, size_t fingerprintBufSize, size_t & fingerprintLen)
|
Recupera il valore dell'impronta associato a un passcode criptato.
|
GetEncryptedPasscodeKeyId(const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & keyId)
|
Recupera l'ID della chiave utilizzata per criptare un passcode criptato.
|
GetEncryptedPasscodeNonce(const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & nonce)
|
Recupera il valore nonce associato a un passcode criptato.
|
IsSupportedPasscodeEncryptionConfig(uint8_t config)
|
bool
Restituisce true se la configurazione della crittografia del passcode fornita è supportata dalle API di crittografia/decrittografia del passcode.
|
Structs |
|
---|---|
nl:: |
Enumerazioni
@278
@278
Tipi di configurazione della crittografia con passcode Weave.
Proprietà | |
---|---|
kPasscodeConfig1_KeyId
|
ID chiave fittizia utilizzato per la configurazione 1 del passcode di test. |
kPasscode_Config1_TEST_ONLY
|
La configurazione della crittografia del passcode n. 1 non utilizza la crittografia e le chiavi segrete per l'autenticazione e il passcode dell'impronta. Questa configurazione DEVE essere utilizzata solo a scopo di TEST. |
kPasscode_Config2
|
La configurazione di crittografia del passcode n. 2 utilizza la crittografia AES-128-ECB con integrità HMAC-SHA-1 a 8 byte e impronta HMAC-SHA-1 a 8 byte. |
@279
@279
Dimensioni dei parametri del protocollo di crittografia passcode di Weave.
Proprietà | |
---|---|
kPasscodeAuthenticationKeyLen
|
Lunghezza della chiave di autenticazione SHA-1 con passcode. |
kPasscodeAuthenticatorLen
|
Lunghezza dell'autenticatore del passcode. |
kPasscodeEncKeyDiversifierSize
|
Dimensione della diversificazione della chiave di applicazione di crittografia del passcode. |
kPasscodeEncryptionKeyLen
|
Lunghezza della chiave di crittografia con passcode (AES-128). |
kPasscodeFingerprintKeyDiversifierSize
|
Dimensioni della diversificazione della chiave dell'impronta del passcode. |
kPasscodeFingerprintKeyLen
|
Lunghezza della chiave SHA-1 (passcode fingerprint). |
kPasscodeFingerprintLen
|
Lunghezza dell'impronta del passcode. |
kPasscodeMaxEncryptedLen
|
Lunghezza massima del passcode criptato. |
kPasscodeMaxLen
|
Lunghezza massima del passcode non criptato. |
kPasscodePaddedLen
|
Lunghezza del passcode (riempita alla lunghezza del blocco AES-128). |
kPasscodeTotalDerivedKeyLen
|
Lunghezza totale della chiave (crittografia e integrità) del passcode. |
Variabili
kPasscodeEncKeyDiversifier
const uint8_t kPasscodeEncKeyDiversifier[] = { 0x1A, 0x65, 0x5D, 0x96 }
Diversificatore di chiavi utilizzato per la derivazione della chiave di crittografia del passcode di Weave.
Questo valore rappresenta i primi 4 byte dell'HASH SHA-1 di "Nest Passcode EK and AK" a frase.
kPasscodeFingerprintKeyDiversifier
const uint8_t kPasscodeFingerprintKeyDiversifier[] = { 0xD1, 0xA1, 0xD9, 0x6C }
Diversificatore di chiavi utilizzato per la derivazione della chiave di crittografia del passcode di Weave.
Questo valore rappresenta i primi 4 byte dell'HASH SHA-1 di "Nest Passcode EK and AK" a frase.
Funzioni
DecryptPasscode
WEAVE_ERROR DecryptPasscode( const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *passcodeBuf, size_t passcodeBufSize, size_t & passcodeLen, GroupKeyStoreBase *groupKeyStore )
Decripta un passcode criptato usando lo schema di crittografia di Nest Passcode.
Dettagli | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parametri |
|
||||||||||||||||
Valori restituiti |
|
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 )
Decripta un passcode criptato usando lo schema di crittografia di Nest Passcode.
Dettagli | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parametri |
|
||||||||||||||||
Valori restituiti |
|
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 )
Cripta un passcode utilizzando lo schema di crittografia di Nest Passcode.
Dettagli | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parametri |
|
||||||||||||||||||
Valori restituiti |
|
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 )
Cripta un passcode utilizzando lo schema di crittografia di Nest Passcode.
Dettagli | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parametri |
|
||||||||||||||||||||||
Valori restituiti |
|
GetEncryptedPasscodeConfig
WEAVE_ERROR GetEncryptedPasscodeConfig( const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t & config )
Recupera il tipo di configurazione di un passcode criptato.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
GetEncryptedPasscodeFingerprint
WEAVE_ERROR GetEncryptedPasscodeFingerprint( const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *fingerprintBuf, size_t fingerprintBufSize, size_t & fingerprintLen )
Recupera il valore dell'impronta associato a un passcode criptato.
Dettagli | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Parametri |
|
GetEncryptedPasscodeKeyId
WEAVE_ERROR GetEncryptedPasscodeKeyId( const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & keyId )
Recupera l'ID della chiave utilizzata per criptare un passcode criptato.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
GetEncryptedPasscodeNonce
WEAVE_ERROR GetEncryptedPasscodeNonce( const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & nonce )
Recupera il valore nonce associato a un passcode criptato.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
IsSupportedPasscodeEncryptionConfig
bool IsSupportedPasscodeEncryptionConfig( uint8_t config )
Restituisce true se la configurazione della crittografia del passcode fornita è supportata dalle API di crittografia/decrittografia del passcode.