تمت ترجمة هذه الصفحة بواسطة 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 }	تعداد الحقول والعلامات وأنواعها في مفتاح Public 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
}

تعداد

الحقول والعلامات وأنواعها في مفتاح Public 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` تحديد ما إذا كان معرّف مفتاح مجموعة التطبيقات المحدّد يستخدم القيمة الحالية مفتاح الحقبة.

الأنواع العامة

52@

@52

الحقول والعلامات وأنواعها في مفتاح Public Weave.

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

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

ConvertToCurrentAppKeyId

uint32_t ConvertToCurrentAppKeyId(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

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

ConvertToStaticAppKeyId

uint32_t ConvertToStaticAppKeyId(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

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

DescribeKey

const char * DescribeKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

نسيج معرّف المفتاح لفك ترميزه والذي يتم إرجاع سلسلة وصفية له.

المرتجعات

مؤشر يؤدي إلى سلسلة منتهية الصلاحية فارغة تصف معرّف المفتاح المحدّد.

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.

المرتجعات

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

IncorporatesEpochKey

bool IncorporatesEpochKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

true إذا كان keyId يتضمّن مفتاح epoch.

IncorporatesRootKey

bool IncorporatesRootKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

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

IsAppEpochKey

bool IsAppEpochKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

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

IsAppGroupKey

bool IsAppGroupKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

true إذا كان keyId من نوع مفتاح دوار أو ثابت.

IsAppGroupMasterKey

bool IsAppGroupMasterKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

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

IsAppRootKey

bool IsAppRootKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

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

IsAppRotatingKey

bool IsAppRotatingKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

true إذا كان معرف المفتاح لنوع يعتمد على تدوير أحد التطبيقات.

IsAppStaticKey

bool IsAppStaticKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

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

IsGeneralKey

bool IsGeneralKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

true إذا كان keyId بنوع عام.

IsMessageEncryptionKeyId

bool IsMessageEncryptionKeyId(
  uint32_t keyId,
  bool allowLogicalKeys
)

حدد ما إذا كان معرف مفتاح معين يحدد مفتاحًا مناسبًا لتشفير رسالة Weave.

التفاصيل

المعلمات

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

المرتجعات

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

IsSameKeyOrGroup

bool IsSameKeyOrGroup(
  uint32_t keyId1,
  uint32_t keyId2
)

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

التفاصيل

المعلمات

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

المرتجعات

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

IsSessionKey

bool IsSessionKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

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

IsValidKeyId

bool IsValidKeyId(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

رقم تعريف مفتاح Weave.

المرتجعات

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

MakeAppGroupMasterKeyId

uint32_t MakeAppGroupMasterKeyId(
  uint8_t appGroupLocalNumber
)

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

التفاصيل

المعلمات

[in] appGroupLocalNumber

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

المرتجعات

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

MakeAppIntermediateKeyId

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

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

التفاصيل

المعلمات

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

المرتجعات

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

MakeAppKeyId

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

رقم مفتاح Epoch

المرتجعات

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

MakeGeneralKeyId

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

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

المرتجعات

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

UpdateEpochKeyId

uint32_t UpdateEpochKeyId(
  uint32_t keyId,
  uint32_t epochKeyId
)

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

التفاصيل

المعلمات

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

المرتجعات

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

UsesCurrentEpochKey

bool UsesCurrentEpochKey(
  uint32_t keyId
)

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

التفاصيل

المعلمات

[in] keyId

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

المرتجعات

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