nl:: Weave:: Profiles:: Security:: Passcodes
מרחב השמות הזה כולל את כל הממשקים ב-Weave לספריית קודי הגישה של Weave בפרופיל האבטחה של Weave.
סיכום
ספירות |
|
---|---|
@278{
|
טיפוסים בני מנייה (enum) סוגי הגדרה של הצפנה של קוד גישה. |
@279{
|
טיפוסים בני מנייה (enum) שזירה של גודלי הפרמטרים של פרוטוקול ההצפנה בקוד סיסמה. |
משתנים |
|
---|---|
kPasscodeEncKeyDiversifier = { 0x1A, 0x65, 0x5D, 0x96 }[]
|
const uint8_t
מגוון מפתחות שמשמש לגזירה של מפתח להצפנת קוד גישה ב-Weave.
|
kPasscodeFingerprintKeyDiversifier = { 0xD1, 0xA1, 0xD9, 0x6C }[]
|
const uint8_t
מגוון מפתחות שמשמש לגזירה של מפתח להצפנת קוד גישה ב-Weave.
|
פונקציות |
|
---|---|
DecryptPasscode(const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *passcodeBuf, size_t passcodeBufSize, size_t & passcodeLen, GroupKeyStoreBase *groupKeyStore)
|
פענוח של קוד סיסמה שהוצפן באמצעות סכימת ההצפנה של 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)
|
פענוח של קוד סיסמה שהוצפן באמצעות סכימת ההצפנה של 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)
|
הצפנת קוד גישה באמצעות סכמת ההצפנה של 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)
|
הצפנת קוד גישה באמצעות סכמת ההצפנה של Nest Passcode.
|
GetEncryptedPasscodeConfig(const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t & config)
|
קבלת סוג ההגדרה של קוד סיסמה מוצפן.
|
GetEncryptedPasscodeFingerprint(const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *fingerprintBuf, size_t fingerprintBufSize, size_t & fingerprintLen)
|
מקבלים את ערך טביעת האצבע שמשויך לקוד סיסמה מוצפן.
|
GetEncryptedPasscodeKeyId(const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & keyId)
|
מקבלים את מזהה המפתח שמשמש להצפנה של קוד סיסמה מוצפן.
|
GetEncryptedPasscodeNonce(const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & nonce)
|
מקבלים את הערך חד-פעמי (nonce) שמשויך לקוד סיסמה מוצפן.
|
IsSupportedPasscodeEncryptionConfig(uint8_t config)
|
bool
הפונקציה מחזירה את הערך True אם התצורה שסופקה להצפנת קוד גישה נתמכת על ידי ממשקי ה-API להצפנה/פענוח של קוד הגישה.
|
מבנים |
|
---|---|
nl:: |
ספירות
@278
@278
סוגי הגדרה של הצפנה של קוד גישה.
תכונות | |
---|---|
kPasscodeConfig1_KeyId
|
מזהה מפתח דמה המשמש להגדרה מס' 1 של קוד הסיסמה לבדיקה. |
kPasscode_Config1_TEST_ONLY
|
בתצורה מס' 1 של ההצפנה באמצעות קוד גישה, לא נעשה שימוש בהצפנה ובמפתחות סודיים לצורך אימות וקוד סיסמה באמצעות טביעת אצבע. יש להשתמש בהגדרה הזו למטרות בדיקה בלבד. |
kPasscode_Config2
|
הגדרה מס' 2 להצפנת קוד גישה מבוססת על הצפנת AES-128-ECB עם תקינות HMAC-SHA-1 של 8 בייט וטביעת אצבע HMAC-SHA-1 בגודל 8 בייט. |
@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 }
מגוון מפתחות שמשמש לגזירה של מפתח להצפנת קוד גישה ב-Weave.
הערך הזה מייצג את 4 הבייטים הראשונים של הביטוי SHA-1 HASH של הביטוי Nest Passcode EK and AK.
kPasscodeFingerprintKeyDiversifier
const uint8_t kPasscodeFingerprintKeyDiversifier[] = { 0xD1, 0xA1, 0xD9, 0x6C }
מגוון מפתחות שמשמש לגזירה של מפתח להצפנת קוד גישה ב-Weave.
הערך הזה מייצג את 4 הבייטים הראשונים של הביטוי SHA-1 HASH של הביטוי Nest Passcode EK and AK.
פונקציות
DecryptPasscode
WEAVE_ERROR DecryptPasscode( const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *passcodeBuf, size_t passcodeBufSize, size_t & passcodeLen, GroupKeyStoreBase *groupKeyStore )
פענוח של קוד סיסמה שהוצפן באמצעות סכימת ההצפנה של Nest Passcode.
פרטים | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||||||||||||
ערכים מוחזרים |
|
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 Passcode.
פרטים | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||||||||||||
ערכים מוחזרים |
|
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 Passcode.
פרטים | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||||||||||||||
ערכים מוחזרים |
|
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 Passcode.
פרטים | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||||||||||||||||||
ערכים מוחזרים |
|
GetEncryptedPasscodeConfig
WEAVE_ERROR GetEncryptedPasscodeConfig( const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t & config )
קבלת סוג ההגדרה של קוד סיסמה מוצפן.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
GetEncryptedPasscodeFingerprint
WEAVE_ERROR GetEncryptedPasscodeFingerprint( const uint8_t *encPasscode, size_t encPasscodeLen, uint8_t *fingerprintBuf, size_t fingerprintBufSize, size_t & fingerprintLen )
מקבלים את ערך טביעת האצבע שמשויך לקוד סיסמה מוצפן.
פרטים | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
GetEncryptedPasscodeKeyId
WEAVE_ERROR GetEncryptedPasscodeKeyId( const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & keyId )
מקבלים את מזהה המפתח שמשמש להצפנה של קוד סיסמה מוצפן.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
GetEncryptedPasscodeNonce
WEAVE_ERROR GetEncryptedPasscodeNonce( const uint8_t *encPasscode, size_t encPasscodeLen, uint32_t & nonce )
מקבלים את הערך חד-פעמי (nonce) שמשויך לקוד סיסמה מוצפן.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
IsSupportedPasscodeEncryptionConfig
bool IsSupportedPasscodeEncryptionConfig( uint8_t config )
הפונקציה מחזירה את הערך True אם התצורה שסופקה להצפנת קוד גישה נתמכת על ידי ממשקי ה-API להצפנה/פענוח של קוד הגישה.