تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

nl::Weave::WeaveKeyId

#include <src/lib/core/WeaveKeyIds.h>

تمثّل هذه الخاصية تعريف معرّف مفتاح Weave.

الملخّص

تتضمن هذه الفئة أنواع المفاتيح والعلامات الرئيسية وتعريف حقول معرّف المفتاح ودوال واجهة برمجة التطبيقات.

الأنواع المتاحة للجميع
@52{ kType_None = 0x00000000, kType_General = 0x00001000, kType_Session = 0x00002000, kType_AppStaticKey = 0x00004000, kType_AppRotatingKey = kType_AppStaticKey \| kTypeModifier_IncorporatesEpochKey, kType_AppRootKey = 0x00010000, kType_AppEpochKey = 0x00020000 \| kTypeModifier_IncorporatesEpochKey, kType_AppGroupMasterKey = 0x00030000, kType_AppIntermediateKey = kType_AppRootKey \| kTypeModifier_IncorporatesEpochKey, kNone = kType_None \| 0x0000, kFabricSecret = kType_General \| 0x0001, kFabricRootKey = kType_AppRootKey \| (0 << kShift_RootKeyNumber), kClientRootKey = kType_AppRootKey \| (1 << kShift_RootKeyNumber), kServiceRootKey = kType_AppRootKey \| (2 << kShift_RootKeyNumber), kKeyNumber_Max = kMask_KeyNumber }	تعداد حقول معرّفات مفتاح Weave العامة والعلامات والأنواع.

الأنواع المتاحة للجميع

@52{
  kType_None = 0x00000000,
  kType_General = 0x00001000,
  kType_Session = 0x00002000,
  kType_AppStaticKey = 0x00004000,
  kType_AppRotatingKey = kType_AppStaticKey | kTypeModifier_IncorporatesEpochKey,
  kType_AppRootKey = 0x00010000,
  kType_AppEpochKey = 0x00020000 | kTypeModifier_IncorporatesEpochKey,
  kType_AppGroupMasterKey = 0x00030000,
  kType_AppIntermediateKey = kType_AppRootKey | kTypeModifier_IncorporatesEpochKey,
  kNone = kType_None | 0x0000,
  kFabricSecret = kType_General | 0x0001,
  kFabricRootKey = kType_AppRootKey | (0 << kShift_RootKeyNumber),
  kClientRootKey = kType_AppRootKey | (1 << kShift_RootKeyNumber),
  kServiceRootKey = kType_AppRootKey | (2 << kShift_RootKeyNumber),
  kKeyNumber_Max = kMask_KeyNumber
}

تعداد

حقول معرّفات مفتاح Weave العامة والعلامات والأنواع.

الدوال الثابتة العامة
`ConvertToCurrentAppKeyId(uint32_t keyId)`	`uint32_t` تحويل رقم تعريف مفتاح مجموعة التطبيقات إلى رقم تعريف المفتاح الحالي للتطبيق.
`ConvertToStaticAppKeyId(uint32_t keyId)`	`uint32_t` حوِّل رقم تعريف مفتاح التطبيق إلى رقم تعريف مفتاح التطبيق الثابت.
`DescribeKey(uint32_t keyId)`	`const char *` فك ترميز معرّف مفتاح Weave باستخدام سلسلة وصفية.
`GetAppGroupLocalNumber(uint32_t keyId)`	`uint8_t` يمكنك الحصول على الرقم المحلي لمجموعة التطبيقات التي تم استخدامها لاشتقاق مفتاح التطبيق المحدد.
`GetAppGroupMasterKeyId(uint32_t keyId)`	`uint32_t` يمكنك الحصول على معرّف المفتاح الرئيسي لمجموعة التطبيقات الذي تم استخدامه لاستنتاج مفتاح التطبيق المُحدّد.
`GetEpochKeyId(uint32_t keyId)`	`uint32_t` يمكنك الحصول على معرّف مفتاح فترة التطبيق الذي تم استخدامه لاستنتاج مفتاح التطبيق المُحدّد.
`GetEpochKeyNumber(uint32_t keyId)`	`uint8_t` يمكنك الحصول على رقم مفتاح حقبة مجموعة التطبيقات الذي تم استخدامه لاستنتاج مفتاح التطبيق المُحدَّد.
`GetRootKeyId(uint32_t keyId)`	`uint32_t` يمكنك الحصول على معرّف مفتاح جذر مجموعة التطبيقات الذي تم استخدامه لاستنتاج مفتاح التطبيق المحدد.
`GetRootKeyNumber(uint32_t keyId)`	`uint8_t` يمكنك الحصول على رقم المفتاح الجذر لمجموعة التطبيقات الذي تم استخدامه لاستنتاج مفتاح التطبيق المُحدَّد.
`GetType(uint32_t keyId)`	`uint32_t` احصل على نوع مفتاح Weave لرقم تعريف المفتاح المحدّد.
`IncorporatesAppGroupMasterKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان معرّف مفتاح مجموعة التطبيقات المحدّد يتضمّن المفتاح الرئيسي للمجموعة.
`IncorporatesEpochKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان معرّف مفتاح مجموعة التطبيقات المحدّد يتضمّن مفتاح الحقبة.
`IncorporatesRootKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان معرِّف مفتاح مجموعة التطبيقات المحدّد يتضمن مفتاح الجذر.
`IsAppEpochKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان رقم تعريف المفتاح المحدّد هو من نوع المفتاح لفترة التطبيق.
`IsAppGroupKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان رقم تعريف المفتاح المحدّد ينتمي إلى أحد أنواع مفاتيح مجموعة التطبيقات (ثابتة أو بالتناوب).
`IsAppGroupMasterKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان رقم تعريف المفتاح المحدّد هو نوع المفتاح الرئيسي لمجموعة التطبيقات.
`IsAppRootKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان رقم تعريف المفتاح المحدّد هو من نوع المفتاح الجذر للتطبيق.
`IsAppRotatingKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان معرّف المفتاح المحدّد من نوع تدوير التطبيقات.
`IsAppStaticKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان رقم تعريف المفتاح المحدّد نوعًا ثابتًا للتطبيق.
`IsGeneralKey(uint32_t keyId)`	`bool` تحديد ما إذا كان رقم تعريف المفتاح المحدد من نوع عام.
`IsMessageEncryptionKeyId(uint32_t keyId, bool allowLogicalKeys)`	`bool` حدِّد ما إذا كان معرّف المفتاح قد تعرّف على مفتاح مناسب لتشفير رسائل Weave.
`IsSameKeyOrGroup(uint32_t keyId1, uint32_t keyId2)`	`bool` تُحدِّد هذه السياسة ما إذا كان معرّفا المفتاح قد تعرّفا على المفتاح نفسه، أو في حال تغيير المفاتيح، تكون مجموعة المفاتيح نفسها مستقلة عن أي حقبة معيّنة.
`IsSessionKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان رقم تعريف المفتاح المحدّد من نوع الجلسة.
`IsValidKeyId(uint32_t keyId)`	`bool` حدِّد ما إذا كان معرِّف المفتاح يتضمّن قيمة صالحة (قانونية).
`MakeAppGroupMasterKeyId(uint8_t appGroupLocalNumber)`	`uint32_t` إنشاء رقم تعريف رئيسي لمجموعة التطبيقات وفقًا للرقم المحلي لمجموعة التطبيقات
`MakeAppIntermediateKeyId(uint32_t rootKeyId, uint32_t epochKeyId, bool useCurrentEpochKey)`	`uint32_t` إنشاء رقم تعريف للمفتاح المتوسط للتطبيق بأرقام تعريف أساسية للمكوّنات.
`MakeAppKeyId(uint32_t keyType, uint32_t rootKeyId, uint32_t epochKeyId, uint32_t appGroupMasterKeyId, bool useCurrentEpochKey)`	`uint32_t` إنشاء رقم تعريف مفتاح مجموعة التطبيقات بالاستناد إلى أرقام التعريف الأساسية للمكوّنات والمعلومات الأخرى
`MakeAppRotatingKeyId(uint32_t rootKeyId, uint32_t epochKeyId, uint32_t appGroupMasterKeyId, bool useCurrentEpochKey)`	`uint32_t` إنشاء رقم تعريف للمفتاح بالتناوب لتطبيق مُعرّف وفقًا للأرقام التعريفية للمكوِّنات وغيرها من المعلومات.
`MakeAppStaticKeyId(uint32_t rootKeyId, uint32_t appGroupMasterKeyId)`	`uint32_t` إنشاء رقم تعريف مفتاح ثابت للتطبيق وفقًا للأرقام التعريفية للمكوِّنات الأساسية
`MakeEpochKeyId(uint8_t epochKeyNumber)`	`uint32_t` إنشاء رقم تعريف مفتاح جذر مجموعة التطبيقات وفقًا لرقم مفتاح الحقبة.
`MakeGeneralKeyId(uint16_t generalKeyNumber)`	`uint16_t` إنشاء رقم تعريف مفتاح عام بالاستناد إلى رقم المفتاح العام
`MakeRootKeyId(uint8_t rootKeyNumber)`	`uint32_t` إنشاء رقم تعريف مفتاح جذر مجموعة التطبيقات وفقًا لرقم المفتاح الجذري
`MakeSessionKeyId(uint16_t sessionKeyNumber)`	`uint16_t` يمكنك إنشاء رقم تعريف مفتاح الجلسة حسب رقم مفتاح الجلسة.
`UpdateEpochKeyId(uint32_t keyId, uint32_t epochKeyId)`	`uint32_t` تعديل معرّف مفتاح مجموعة التطبيقات برقم مفتاح جديد
`UsesCurrentEpochKey(uint32_t keyId)`	`bool` حدِّد ما إذا كان معرّف مفتاح مجموعة التطبيق المحدّد يستخدم &quot؛current" مفتاح الحقبة.

الأنواع المتاحة للجميع

@52

@52

حقول معرّفات مفتاح Weave العامة والعلامات والأنواع.

أماكن إقامة
`kClientRootKey`	رقم تعريف مفتاح جذر العميل.
`kFabricRootKey`	معرّف مفتاح جذر الأقمشة
`kFabricSecret`	معرّف نسيج حياكة.
`kKeyNumber_Max`	الحد الأقصى من القيم للحقول الفرعية لرقم التعريف الأساسي
`kNone`	يتم إدراج معرّفات المفاتيح العامة. معرّف مفتاح Weave غير محدد.
`kServiceRootKey`	رقم تعريف المفتاح الجذر للخدمة.
`kType_AppEpochKey`	نوع مفتاح حقبة مجموعة التطبيقات
`kType_AppGroupMasterKey`	نوع المفتاح الرئيسي لمجموعة التطبيقات.
`kType_AppIntermediateKey`	نوع المفتاح المتوسط لمجموعة التطبيقات.
`kType_AppRootKey`	أنواع مفاتيح Weave (بخلاف أنواع تشفير رسائل Weave). ملاحظة: لا يمكن أن تكون 16 وحدة من أهم هذه الأنواع من جميع الأصفار، لأن هذه القيم محجوزة لمفاتيح تشفير رسالة Weave فقط. أنواع مفتاح المجموعة المكوّنة للمجموعة الأساسية.
`kType_AppRotatingKey`	نوع مفتاح تدوير التطبيقات.
`kType_AppStaticKey`	نوع المفتاح الثابت للتطبيق.
`kType_General`	نوع المفتاح العام.
`kType_None`	أنواع مفاتيح Weave المستخدمة لتشفير رسائل Weave. ملاحظة: يجب أن يكون 16 بت من إجمالي 32 بت من أهم مفتاح تشفير الرسائل صفرًا لأن تشفير 16 بت فقط أقل من رقم التعريف في رسالة Weave.غير مشفّر.
`kType_Session`	نوع مفتاح الجلسة.

الدوال الثابتة العامة

تحويل إلى رقم تعريف التطبيق الحالي

uint32_t ConvertToCurrentAppKeyId(
  uint32_t keyId
)

تحويل رقم تعريف مفتاح مجموعة التطبيقات إلى رقم تعريف المفتاح الحالي للتطبيق.

التفاصيل

المعلَمات

[in] keyId

رقم تعريف مفتاح التطبيق.

المرتجعات

رقم تعريف المفتاح الحالي للتطبيق.

ConvertToStaticAppKeyId

uint32_t ConvertToStaticAppKeyId(
  uint32_t keyId
)

حوِّل رقم تعريف مفتاح التطبيق إلى رقم تعريف مفتاح التطبيق الثابت.

التفاصيل

المعلَمات

[in] keyId

رقم تعريف مفتاح التطبيق.

المرتجعات

رقم تعريف المفتاح الثابت للتطبيق.

وصف المفتاح

const char * DescribeKey(
  uint32_t keyId
)

فك ترميز معرّف مفتاح Weave باستخدام سلسلة وصفية.

التفاصيل

المعلَمات

[in] keyId

دمج رقم تعريف المفتاح لفك الترميز وعرض سلسلة وصفية له

المرتجعات

مؤشر إلى سلسلة NULL تم إنهاؤها لرقم تعريف المفتاح المحدد.

GetAppGroupLocalNumber

uint8_t GetAppGroupLocalNumber(
  uint32_t keyId
)

يمكنك الحصول على الرقم المحلي لمجموعة التطبيقات التي تم استخدامها لاشتقاق مفتاح التطبيق المحدد.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح مجموعة تطبيقات Weave.

المرتجعات

رقم التطبيق المحلي لمجموعة التطبيقات.

GetAppGroupMasterKeyId

uint32_t GetAppGroupMasterKeyId(
  uint32_t keyId
)

يمكنك الحصول على معرّف المفتاح الرئيسي لمجموعة التطبيقات الذي تم استخدامه لاستنتاج مفتاح التطبيق المُحدّد.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح مجموعة تطبيقات Weave.

المرتجعات

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

GetEpochKeyId

uint32_t GetEpochKeyId(
  uint32_t keyId
)

يمكنك الحصول على معرّف مفتاح فترة التطبيق الذي تم استخدامه لاستنتاج مفتاح التطبيق المُحدّد.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح مجموعة تطبيقات Weave.

المرتجعات

معرّف مفتاح الحقبة

GetEpochKeyNumber

uint8_t GetEpochKeyNumber(
  uint32_t keyId
)

يمكنك الحصول على رقم مفتاح حقبة مجموعة التطبيقات الذي تم استخدامه لاستنتاج مفتاح التطبيق المُحدَّد.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح مجموعة تطبيقات Weave.

المرتجعات

رقم مفتاح الحقبة.

GetRootKeyId

uint32_t GetRootKeyId(
  uint32_t keyId
)

يمكنك الحصول على معرّف مفتاح جذر مجموعة التطبيقات الذي تم استخدامه لاستنتاج مفتاح التطبيق المحدد.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح مجموعة تطبيقات Weave.

المرتجعات

رقم تعريف المفتاح الجذر.

GetRootKeyNumber

uint8_t GetRootKeyNumber(
  uint32_t keyId
)

يمكنك الحصول على رقم المفتاح الجذر لمجموعة التطبيقات الذي تم استخدامه لاستنتاج مفتاح التطبيق المُحدَّد.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح مجموعة تطبيقات Weave.

المرتجعات

رقم الجذر الجذر.

GetType

uint32_t GetType(
  uint32_t keyId
)

احصل على نوع مفتاح Weave لرقم تعريف المفتاح المحدّد.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح Weave

المرتجعات

معرّف المفتاح.

IncorporatesAppGroupMasterKey

bool IncorporatesAppGroupMasterKey(
  uint32_t keyId
)

حدِّد ما إذا كان معرّف مفتاح مجموعة التطبيقات المحدّد يتضمّن المفتاح الرئيسي للمجموعة.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح مجموعة تطبيقات Weave.

المرتجعات

صحيح إذا كان keyId يتضمن مفتاح المجموعة الرئيسي.

قناة IncorporatesEpochKey

bool IncorporatesEpochKey(
  uint32_t keyId
)

حدِّد ما إذا كان معرّف مفتاح مجموعة التطبيقات المحدّد يتضمّن مفتاح الحقبة.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح مجموعة تطبيقات Weave.

المرتجعات

صحيح إذا كان keyId يتضمن مفتاح الحقبة.

مفتاح IncorporatesRoot

bool IncorporatesRootKey(
  uint32_t keyId
)

حدِّد ما إذا كان معرِّف مفتاح مجموعة التطبيقات المحدّد يتضمن مفتاح الجذر.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح مجموعة تطبيقات Weave.

المرتجعات

صحيح إذا كان keyId يتضمن مفتاح الجذر.

مفتاح AppAppEpoch

bool IsAppEpochKey(
  uint32_t keyId
)

حدِّد ما إذا كان رقم تعريف المفتاح المحدّد هو من نوع المفتاح لفترة التطبيق.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح Weave

المرتجعات

true إذا كان keyId لنوع مفتاح حقبة التطبيق.

مفتاح AppAppGroup

bool IsAppGroupKey(
  uint32_t keyId
)

حدِّد ما إذا كان رقم تعريف المفتاح المحدّد ينتمي إلى أحد أنواع مفاتيح مجموعة التطبيقات (ثابتة أو بالتناوب).

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح Weave

المرتجعات

صحيح إذا كان keyId يتم تدويره أو نوع المفتاح الثابت.

مفتاح AppAppGroupMaster

bool IsAppGroupMasterKey(
  uint32_t keyId
)

حدِّد ما إذا كان رقم تعريف المفتاح المحدّد هو نوع المفتاح الرئيسي لمجموعة التطبيقات.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح Weave

المرتجعات

true إذا كان keyId لنوع المفتاح الرئيسي لمجموعة التطبيقات.

مفتاح AppAppRoot

bool IsAppRootKey(
  uint32_t keyId
)

حدِّد ما إذا كان رقم تعريف المفتاح المحدّد هو من نوع المفتاح الجذر للتطبيق.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح Weave

المرتجعات

صحيح إذا كان keyId لنوع مفتاح جذر التطبيق.

مفتاح AppAppRotating

bool IsAppRotatingKey(
  uint32_t keyId
)

حدِّد ما إذا كان معرّف المفتاح المحدّد من نوع تدوير التطبيقات.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح Weave

المرتجعات

صحيح إذا كان keyId لنوع تدوير التطبيق.

مفتاح AppAppStaticKey

bool IsAppStaticKey(
  uint32_t keyId
)

حدِّد ما إذا كان رقم تعريف المفتاح المحدّد نوعًا ثابتًا للتطبيق.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح Weave

المرتجعات

صحيح إذا كان keyId من نوع ثابت للتطبيق.

مفتاح عام

bool IsGeneralKey(
  uint32_t keyId
)

تحديد ما إذا كان رقم تعريف المفتاح المحدد من نوع عام.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح Weave

المرتجعات

صحيح إذا كان keyId يتضمن النوع "عام".

الرقم التعريفي لـ isMessageEncryptionKey

bool IsMessageEncryptionKeyId(
  uint32_t keyId,
  bool allowLogicalKeys
)

حدِّد ما إذا كان معرّف المفتاح قد تعرّف على مفتاح مناسب لتشفير رسائل Weave.

التفاصيل

المعلَمات

`[in] keyId`	معرّف مفتاح Weave
`[in] allowLogicalKeys`	يحدِّد ما إذا كان يجب اعتبار معرّفات المفاتيح المنطقية (مثل مفتاح "&&;;current" التدوير) مناسبة لتشفير الرسائل.

المرتجعات

true إذا كان من الممكن استخدام المفتاح الذي تم تحديده لتشفير رسائل Weave.

IsSameKeyOrGroup

bool IsSameKeyOrGroup(
  uint32_t keyId1,
  uint32_t keyId2
)

تُحدِّد هذه السياسة ما إذا كان معرّفا المفتاح قد تعرّفا على المفتاح نفسه، أو في حال تغيير المفاتيح، تكون مجموعة المفاتيح نفسها مستقلة عن أي حقبة معيّنة.

التفاصيل

المعلَمات

`[in] keyId1`	رقم التعريف الأساسي الأول لاختباره.
`[in] keyId2`	معرّف المفتاح الثاني لاختباره.

المرتجعات

صحيح إذا كانت أرقام تعريف المفاتيح تمثل المفتاح نفسه.

مفتاح الجلسة

bool IsSessionKey(
  uint32_t keyId
)

حدِّد ما إذا كان رقم تعريف المفتاح المحدّد من نوع الجلسة.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح Weave

المرتجعات

صحيح إذا كان keyId لنوع الجلسة.

معرف صالح

bool IsValidKeyId(
  uint32_t keyId
)

حدِّد ما إذا كان معرِّف المفتاح يتضمّن قيمة صالحة (قانونية).

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح Weave

المرتجعات

صحيح إذا كانت قيمة رقم تعريف المفتاح صالحة.

MakeAppGroupMasterKeyId

uint32_t MakeAppGroupMasterKeyId(
  uint8_t appGroupLocalNumber
)

إنشاء رقم تعريف رئيسي لمجموعة التطبيقات وفقًا للرقم المحلي لمجموعة التطبيقات

التفاصيل

المعلَمات

[in] appGroupLocalNumber

الرقم المحلي لمجموعة التطبيقات.

المرتجعات

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

رقم تعريف التطبيق

uint32_t MakeAppIntermediateKeyId(
  uint32_t rootKeyId,
  uint32_t epochKeyId,
  bool useCurrentEpochKey
)

إنشاء رقم تعريف للمفتاح المتوسط للتطبيق بأرقام تعريف أساسية للمكوّنات.

التفاصيل

المعلَمات

`[in] rootKeyId`	رقم تعريف مفتاح الجذر المستخدَم لاشتقاق المفتاح المتوسط للتطبيق.
`[in] epochKeyId`	رقم تعريف مفتاح Epoch المستخدم للحصول على المفتاح المتوسط للتطبيق.
`[in] useCurrentEpochKey`	علامة منطقية تشير إلى ما إذا كان يجب اشتقاق المفتاح باستخدام "current" مفتاح الحقبة.

المرتجعات

معرّف المفتاح المتوسط للتطبيق.

رقم تعريف التطبيق

uint32_t MakeAppKeyId(
  uint32_t keyType,
  uint32_t rootKeyId,
  uint32_t epochKeyId,
  uint32_t appGroupMasterKeyId,
  bool useCurrentEpochKey
)

إنشاء رقم تعريف مفتاح مجموعة التطبيقات بالاستناد إلى أرقام التعريف الأساسية للمكوّنات والمعلومات الأخرى

التفاصيل

المعلَمات

`[in] keyType`	نوع مفتاح مجموعة التطبيقات المشتقة.
`[in] rootKeyId`	رقم تعريف مفتاح الجذر المستخدَم لاشتقاق مفتاح مجموعة التطبيقات.
`[in] epochKeyId`	رقم تعريف مفتاح Epoch المستخدم للحصول على مفتاح مجموعة التطبيقات.
`[in] appGroupMasterKeyId`	رقم تعريف المفتاح الرئيسي لمجموعة التطبيقات المستخدَم لاشتقاق مفتاح مجموعة التطبيقات.
`[in] useCurrentEpochKey`	علامة منطقية تشير إلى ما إذا كان يجب اشتقاق المفتاح باستخدام "current" مفتاح الحقبة.

المرتجعات

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

MakeAppRotatingKeyId

uint32_t MakeAppRotatingKeyId(
  uint32_t rootKeyId,
  uint32_t epochKeyId,
  uint32_t appGroupMasterKeyId,
  bool useCurrentEpochKey
)

إنشاء رقم تعريف للمفتاح بالتناوب لتطبيق مُعرّف وفقًا للأرقام التعريفية للمكوِّنات وغيرها من المعلومات.

التفاصيل

المعلَمات

`[in] rootKeyId`	رقم تعريف مفتاح الجذر المستخدَم لاشتقاق مفتاح تناوب التطبيقات.
`[in] epochKeyId`	معرّف مفتاح Epoch المستخدم للحصول على مفتاح تناوب التطبيقات.
`[in] appGroupMasterKeyId`	رقم تعريف المفتاح الرئيسي لمجموعة التطبيقات المستخدَم لاشتقاق مفتاح تناوب التطبيقات.
`[in] useCurrentEpochKey`	علامة منطقية تشير إلى ما إذا كان يجب اشتقاق المفتاح باستخدام "current" مفتاح الحقبة.

المرتجعات

رقم تعريف مفتاح تدوير التطبيق.

MakeAppStaticKeyId

uint32_t MakeAppStaticKeyId(
  uint32_t rootKeyId,
  uint32_t appGroupMasterKeyId
)

إنشاء رقم تعريف مفتاح ثابت للتطبيق وفقًا للأرقام التعريفية للمكوِّنات الأساسية

التفاصيل

المعلَمات

`[in] rootKeyId`	رقم تعريف مفتاح الجذر المستخدَم لاشتقاق المفتاح الثابت للتطبيق.
`[in] appGroupMasterKeyId`	رقم تعريف المفتاح الرئيسي لمجموعة التطبيقات المُستخدَم لاشتقاق المفتاح الثابت للتطبيق.

المرتجعات

رقم تعريف المفتاح الثابت للتطبيق.

MakeEpochKeyId

uint32_t MakeEpochKeyId(
  uint8_t epochKeyNumber
)

إنشاء رقم تعريف مفتاح جذر مجموعة التطبيقات وفقًا لرقم مفتاح الحقبة.

التفاصيل

المعلَمات

[in] epochKeyNumber

رقم مفتاح الحقبة.

المرتجعات

معرّف مفتاح الحقبة

معرّف المفتاح العام

uint16_t MakeGeneralKeyId(
  uint16_t generalKeyNumber
)

إنشاء رقم تعريف مفتاح عام بالاستناد إلى رقم المفتاح العام

التفاصيل

المعلَمات

[in] generalKeyNumber

رقم المفتاح العام.

المرتجعات

معرّف المفتاح العام.

MakeRootKeyId

uint32_t MakeRootKeyId(
  uint8_t rootKeyNumber
)

إنشاء رقم تعريف مفتاح جذر مجموعة التطبيقات وفقًا لرقم المفتاح الجذري

التفاصيل

المعلَمات

[in] rootKeyNumber

رقم المفتاح الجذر

المرتجعات

رقم تعريف المفتاح الجذر.

MakeSessionKeyId

uint16_t MakeSessionKeyId(
  uint16_t sessionKeyNumber
)

يمكنك إنشاء رقم تعريف مفتاح الجلسة حسب رقم مفتاح الجلسة.

التفاصيل

المعلَمات

[in] sessionKeyNumber

رقم مفتاح الجلسة.

المرتجعات

رقم تعريف مفتاح الجلسة.

الرقم التعريفي لـ EpochKeyId

uint32_t UpdateEpochKeyId(
  uint32_t keyId,
  uint32_t epochKeyId
)

تعديل معرّف مفتاح مجموعة التطبيقات برقم مفتاح جديد

التفاصيل

المعلَمات

`[in] keyId`	رقم تعريف مفتاح التطبيق.
`[in] epochKeyId`	معرّف مفتاح الحقبة الذي سيتم استخدامه في إنشاء رقم تعريف مفتاح التطبيق المُعدَّل.

المرتجعات

رقم تعريف مفتاح التطبيق.

استخدامsCurrentEpochKey

bool UsesCurrentEpochKey(
  uint32_t keyId
)

حدِّد ما إذا كان معرّف مفتاح مجموعة التطبيق المحدّد يستخدم &quot؛current" مفتاح الحقبة.

التفاصيل

المعلَمات

[in] keyId

معرّف مفتاح مجموعة تطبيقات Weave.

المرتجعات

صحيح إذا كان keyId يشير إلى استخدام مفتاح الحقبة الحالية.