nl:: بافت:: پروفایل ها:: امنیت:: 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)
}
شمارش
تعاریف پارامترهای پروتکل کلیدهای برنامه را ببافید.
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
}
شمارش
شناسه های جهانی گروه برنامه (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
متنوع کننده کلید برای استخراج کلید میانی بافت.

کارکرد

GetAppGroupMasterKeyId (uint32_t groupGlobalId, GroupKeyStoreBase *groupKeyStore, uint32_t & groupMasterKeyId)
شناسه اصلی کلید گروه برنامه را با شناسه جهانی گروه برنامه دریافت کنید.
LogGroupKeys ( GroupKeyStoreBase *groupKeyStore)

کلاس ها

nl:: بافت:: پروفایل ها:: امنیت:: AppKeys:: DummyGroupKeyStore
nl:: بافت:: پروفایل ها:: امنیت:: AppKeys:: GroupKeyStoreBase

تعریف کلاس فروشگاه کلید گروه Weave.

nl:: Weave:: پروفایل ها:: امنیت:: AppKeys:: WeaveGroupKey

حاوی اطلاعاتی درباره کلیدهای گروه برنامه Weave است.

شمارش ها

@220

 @220

تعاریف پارامترهای پروتکل کلیدهای برنامه را ببافید.

خواص
kWeaveAppClientRootKeyDiversifierSize

اندازه تنوع دهنده کلید ریشه مشتری.

kWeaveAppEpochKeySize

اندازه کلید دوره کاربردی را ببافید.

kWeaveAppFabricRootKeyDiversifierSize

اندازه تنوع دهنده کلید ریشه پارچه.

kWeaveAppGroupKeySize

اندازه کلید گروه تشکیل دهنده را ببافید.

kWeaveAppGroupMasterKeySize

اندازه کلید اصلی گروه برنامه ببافید.

kWeaveAppIntermediateKeyDiversifierSize

اندازه متغیر کلید میانی.

kWeaveAppIntermediateKeySize

اندازه کلید میانی کاربرد را ببافید.

kWeaveAppRootKeySize

اندازه کلید ریشه برنامه را ببافید.

kWeaveFabricSecretSize

سایز مخفی پارچه ببافید.

WeaveAppGroupGlobalId

 WeaveAppGroupGlobalId

شناسه های جهانی گروه برنامه (AGGID) را بافید.

خواص
kWeaveAppGroupGlobalId_NestHVAC

Nest HVAC Group.

kWeaveAppGroupGlobalId_NestPhysicalAccess

شناسه های جهانی Nest Labs Application Group.

توجه: سعی نکنید خودتان این مقادیر را تخصیص دهید. این مقادیر تحت مدیریت Nest Labs هستند. لطفاً با استفاده از «Nest Weave: Nest Application Group ID Global Registry» https://docs.google.com/document/d/1xHLAcTvLZg2YGoJfbUb2nbPIvaCNuoygmdiNwC-PJHI .Nest Physical Access Group درخواست رسمی کنید.

kWeaveAppGroupGlobalId_NestSecurityControl

Nest Security Group Control.

kWeaveAppGroupGlobalId_NestStructureSecurity

Nest Structure Security Group.

kWeaveAppGroupGlobalId_Unspecified

شناسه جهانی گروه برنامه مشخص نشده است.

متغیرها

kWeaveAppClientRootKeyDiversifier

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

متنوع کننده کلید برای استخراج کلید ریشه کلاینت Weave استفاده می شود.

این مقدار 4 بایت اول SHA-1 HASH عبارت "کلید ریشه مشتری" را نشان می دهد.

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 }

متنوع کننده کلید برای استخراج کلید میانی بافت.

این مقدار 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
)