nl::Weave::Profiles::Security::AppKeys

מרחב השמות הזה כולל את כל הממשקים ב-Weave לספריית מפתחות של אפליקציות Weave, בתוך פרופיל האבטחה של Weave.

סיכום

ערכים של ספירה

@220{
  kWeaveAppGroupKeySize = 32,
  kWeaveAppRootKeySize = kWeaveAppGroupKeySize,
  kWeaveAppEpochKeySize = kWeaveAppGroupKeySize,
  kWeaveAppGroupMasterKeySize = kWeaveAppGroupKeySize,
  kWeaveAppIntermediateKeySize = kWeaveAppGroupKeySize,
  kWeaveFabricSecretSize = 36,
  kWeaveAppFabricRootKeyDiversifierSize = sizeof(kWeaveAppFabricRootKeyDiversifier),
  kWeaveAppClientRootKeyDiversifierSize = sizeof(kWeaveAppClientRootKeyDiversifier),
  kWeaveAppIntermediateKeyDiversifierSize = sizeof(kWeaveAppIntermediateKeyDiversifier)
}
טיפוסים בני מנייה (enum)
שזירה של הגדרות הפרמטרים של פרוטוקול מפתחות של אפליקציות.
WeaveAppGroupGlobalId{
  kWeaveAppGroupGlobalId_Unspecified = 0,
  kWeaveAppGroupGlobalId_NestPhysicalAccess = (kWeaveVendor_NestLabs << 16) | 0x0001,
  kWeaveAppGroupGlobalId_NestStructureSecurity = (kWeaveVendor_NestLabs << 16) | 0x0002,
  kWeaveAppGroupGlobalId_NestHVAC = (kWeaveVendor_NestLabs << 16) | 0x0003,
  kWeaveAppGroupGlobalId_NestSecurityControl = (kWeaveVendor_NestLabs << 16) | 0x0004
}
טיפוסים בני מנייה (enum)
שזירה של מזהים גלובליים של קבוצת אפליקציות (AGGID).

משתנים

kWeaveAppClientRootKeyDiversifier = { 0x53, 0xE3, 0xFF, 0xE5 }[]
const uint8_t
מפריד מפתחות שמשמש לגזירה של מפתח שורש לקוח של Weave.
kWeaveAppFabricRootKeyDiversifier = { 0x21, 0xFA, 0x8F, 0x6A }[]
const uint8_t
מגזירה למפתחות שמשמשים לנגזרת מפתח שורש של בד אריגת.
kWeaveAppIntermediateKeyDiversifier = { 0xBC, 0xAA, 0x95, 0xAD }[]
const uint8_t
משתנה מפתחות המשמש לנגזרת מפתחות ביניים של Weave.

פונקציות

GetAppGroupMasterKeyId(uint32_t groupGlobalId, GroupKeyStoreBase *groupKeyStore, uint32_t & groupMasterKeyId)
קבלת מזהה מפתח המאסטר של קבוצת האפליקציות בהינתן המזהה הגלובלי של קבוצת האפליקציות.
LogGroupKeys(GroupKeyStoreBase *groupKeyStore)

שיעורים

nl::Weave::Profiles::Security::AppKeys::DummyGroupKeyStore
nl::Weave::Profiles::Security::AppKeys::GroupKeyStoreBase

ההגדרה של קטגוריית מפתחות של חנויות מפתחות ב-Weave.

nl::Weave::Profiles::Security::AppKeys::WeaveGroupKey

מכיל מידע על מפתחות של קבוצות אפליקציות ב-Weave.

ערכים של ספירה

220@

 @220

שזירה של הגדרות הפרמטרים של פרוטוקול מפתחות של אפליקציות.

מאפיינים
kWeaveAppClientRootKeyDiversifierSize

גודל משתנה של מפתח השורש של הלקוח.

kWeaveAppEpochKeySize

שזירה של גודל מפתח תקופת הזמן של האפליקציה (epoch).

kWeaveAppFabricRootKeyDiversifierSize

גודל המשתנה של מפתח השורש הבד.

kWeaveAppGroupKeySize

שזירה את גודל מפתח הקבוצה המרכיב.

kWeaveAppGroupMasterKeySize

שזירה של גודל מפתח המאסטר של קבוצת האפליקציות.

kWeaveAppIntermediateKeyDiversifierSize

גודל של משתנה מפתחות בינוני.

kWeaveAppIntermediateKeySize

שזירה של גודל מפתח הביניים של האפליקציה.

kWeaveAppRootKeySize

שזירה של גודל מפתח הבסיס של האפליקציה.

kWeaveFabricSecretSize

שזירת אריגת גודל סודי של בד.

WeaveAppGroupGlobalId

 WeaveAppGroupGlobalId

שזירה של מזהים גלובליים של קבוצת אפליקציות (AGGID).

מאפיינים
kWeaveAppGroupGlobalId_NestHVAC

קבוצת בקרת האקלים של Nest.

kWeaveAppGroupGlobalId_NestPhysicalAccess

מזהים גלובליים של קבוצת אפליקציות Nest Labs.

הערה: אל תנסו להקצות את הערכים האלה בעצמכם. הערכים האלה נמצאים בניהול של Nest Labs. יש להגיש בקשה רשמית באמצעות Nest Weave: Nest Application Group Global ID Registry' https://docs.google.com/document/d/1xHLAcTvLZg2YGoJfbUb2nbPIvaCNuoygmdiNwC-PJHI.Nest Technical Access Group.

kWeaveAppGroupGlobalId_NestSecurityControl

קבוצת הבקרה אבטחה של Nest.

kWeaveAppGroupGlobalId_NestStructureSecurity

קבוצת אבטחה במבנה של Nest.

kWeaveAppGroupGlobalId_Unspecified

המזהה הגלובלי של קבוצת האפליקציות לא צוין.

משתנים

kWeaveAppClientRootKeyDiversifier

const uint8_t kWeaveAppClientRootKeyDiversifier[] = { 0x53, 0xE3, 0xFF, 0xE5 }

מפריד מפתחות שמשמש לגזירה של מפתח שורש לקוח של Weave.

הערך הזה מייצג את 4 הבייטים הראשונים של SHA-1 HASH של Client Root Key לביטוי.

kWeaveAppFabricRootKeyDiversifier

const uint8_t kWeaveAppFabricRootKeyDiversifier[] = { 0x21, 0xFA, 0x8F, 0x6A }

מגזירה למפתחות שמשמשים לנגזרת מפתח שורש של בד אריגת.

הערך הזה מייצג את 4 הבייטים הראשונים של SHA-1 HASH של Fabric Root Key לביטוי.

kWeaveAppIntermediateKeyDiversifier

const uint8_t kWeaveAppIntermediateKeyDiversifier[] = { 0xBC, 0xAA, 0x95, 0xAD }

משתנה מפתחות המשמש לנגזרת מפתחות ביניים של Weave.

הערך הזה מייצג את 4 הבייטים הראשונים של SHA-1 HASH של 'מפתח ביניים' לביטוי.

פונקציות

GetAppGroupMasterKeyId

WEAVE_ERROR GetAppGroupMasterKeyId(
  uint32_t groupGlobalId,
  GroupKeyStoreBase *groupKeyStore,
  uint32_t & groupMasterKeyId
)

קבלת מזהה מפתח המאסטר של קבוצת האפליקציות בהינתן המזהה הגלובלי של קבוצת האפליקציות.

פרטים
פרמטרים
[in] groupGlobalId
המזהה הגלובלי של קבוצת האפליקציות.
[in] groupKeyStore
מצביע לאובייקט של מאגר המפתחות של הקבוצה.
[out] groupMasterKeyId
המזהה של מפתח המאסטר של קבוצת האפליקציות.
מוחזר ערכים
WEAVE_NO_ERROR
הצלחה.
WEAVE_ERROR_INVALID_ARGUMENT
אם לא צוין מצביע למאגר של מפתחות הקבוצה.
WEAVE_ERROR_UNSUPPORTED_WEAVE_FEATURE
אם אובייקט FabricState לא אותחל עם מאגר מפתחות קבוצה שפועל באופן מלא.
WEAVE_ERROR_KEY_NOT_FOUND
אם מפתח קבוצה עם המזהה הגלובלי שצוין לא נמצא במאגר המפתחות של הפלטפורמה.
other
שגיאות אחרות ספציפיות לפלטפורמה שהוחזרו על-ידי ממשקי ה-API של מאגר המפתחות של הפלטפורמה.

LogGroupKeys

WEAVE_ERROR LogGroupKeys(
  GroupKeyStoreBase *groupKeyStore
)