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)
} 		تعداد
نسج تعريفات مَعلمات بروتوكول مفاتيح التطبيقات.
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
أداة التنويع الرئيسية المستخدمة في اشتقاق مفتاح جذر قماش Weave.
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

حجم مفتاح حقبة تطبيق Weave.

kWeaveAppFabricRootKeyDiversifierSize

حجم متنوّع المفتاح الأساسي للنسيج

kWeaveAppGroupKeySize

نسج حجم مفتاح المجموعة المكونة.

kWeaveAppGroupMasterKeySize

نسج حجم المفتاح الرئيسي لمجموعة التطبيقات.

kWeaveAppIntermediateKeyDiversifierSize

حجم متنوّع المفتاح المتوسط

kWeaveAppIntermediateKeySize

حجم مفتاح متوسط لتطبيق Weave.

kWeaveAppRootKeySize

حجم مفتاح جذر تطبيق Weave.

kWeaveFabricSecretSize

نسج المقاس السري.

WeaveAppGroupGlobalId

 WeaveAppGroupGlobalId

تنظيم المعرّفات العامة لمجموعة التطبيقات (AGGID)

أماكن إقامة
kWeaveAppGroupGlobalId_NestHVAC

مجموعة Nest HVAC.

kWeaveAppGroupGlobalId_NestPhysicalAccess

أرقام التعريف العالمية لمجموعة تطبيقات Nest Labs.

ملاحظة: لا تحاول تخصيص هذه القيم بنفسك. تخضع هذه القيم لإدارة Nest Labs. يُرجى تقديم طلب رسمي باستخدام "Nest Weave: Nest Application Group Global ID Registry" https://docs.google.com/document/d/1xHLAcTvLZg2YGoJfbUb2nbPIvaCNuoygmdiNwC-PJHI.Nest Physical 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 }

أداة التنويع الرئيسية المستخدمة في اشتقاق مفتاح جذر قماش Weave.

تمثل هذه القيمة أول 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
الأخطاء الأخرى الخاصة بالنظام الأساسي التي تعرضها واجهات برمجة تطبيقات ملف تخزين مفاتيح النظام الأساسي.

LogGroupKeys

WEAVE_ERROR LogGroupKeys(
  GroupKeyStoreBase *groupKeyStore
)