หน้านี้ได้รับการแปลโดย Cloud Translation API

nl::Weave::WeaveKeyId

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

คำจำกัดความของตัวระบุคีย์ Weave

สรุป

คลาสนี้ประกอบด้วยประเภทคีย์ แฟล็กคีย์ คำจำกัดความของช่องรหัสคีย์ และฟังก์ชัน API

ประเภทสาธารณะ
@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 }	enum ช่องรหัส แฟล็ก และประเภทรหัสของ 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
}

enum

ช่องรหัส แฟล็ก และประเภทรหัสของ 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` รับรหัสคีย์ Epoch ของกลุ่มแอปพลิเคชันที่ใช้เพื่อรับคีย์แอปพลิเคชันที่ระบุ
`GetEpochKeyNumber(uint32_t keyId)`	`uint8_t` รับหมายเลขคีย์ Epoch ของกลุ่มแอปพลิเคชันที่ใช้เพื่อรับคีย์แอปพลิเคชันที่ระบุ
`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` ระบุว่ารหัสคีย์กลุ่มแอปพลิเคชันที่ระบุรวมคีย์ Epoch หรือไม่
`IncorporatesRootKey(uint32_t keyId)`	`bool` ตรวจสอบว่ารหัสคีย์กลุ่มแอปพลิเคชันที่ระบุรวมคีย์รูทหรือไม่
`IsAppEpochKey(uint32_t keyId)`	`bool` ระบุว่ารหัสคีย์ที่ระบุเป็นประเภทคีย์ Epoch ของแอปพลิเคชันหรือไม่
`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` กำหนดว่ารหัสคีย์ 2 รหัสระบุคีย์เดียวกัน หรือในกรณีของคีย์แบบหมุนเวียน กลุ่มคีย์เดียวกันโดยไม่เกี่ยวข้องกับ Epoch ใดโดยเฉพาะ
`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` สร้างรหัสคีย์รูทของกลุ่มแอปพลิเคชันที่ระบุหมายเลขคีย์ Epoch
`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` อัปเดตรหัสคีย์กลุ่มแอปพลิเคชันด้วยหมายเลขคีย์ Epoch ใหม่
`UsesCurrentEpochKey(uint32_t keyId)`	`bool` ตรวจสอบว่ารหัสคีย์กลุ่มแอปพลิเคชันที่ระบุใช้ "ปัจจุบัน" หรือไม่ คีย์ Epoch

ประเภทสาธารณะ

@52

@52

ช่องรหัส แฟล็ก และประเภทรหัสของ Weave สาธารณะ

พร็อพเพอร์ตี้
`kClientRootKey`	รหัสคีย์รูทของไคลเอ็นต์
`kFabricRootKey`	รหัสคีย์รูทของ Fabric
`kFabricSecret`	รหัสข้อมูลลับของผ้าถัก
`kKeyNumber_Max`	ค่าสูงสุดสำหรับช่องย่อยของรหัสคีย์
`kNone`	สร้างรหัสคีย์ส่วนกลาง รหัสคีย์ Weave ที่ไม่ระบุ
`kServiceRootKey`	รหัสคีย์รูทของบริการ
`kType_AppEpochKey`	ประเภทคีย์ Epoch ของกลุ่มแอปพลิเคชัน
`kType_AppGroupMasterKey`	ประเภทคีย์หลักของกลุ่มแอปพลิเคชัน
`kType_AppIntermediateKey`	ประเภทคีย์กลางของกลุ่มแอปพลิเคชัน
`kType_AppRootKey`	ประเภทคีย์ Weave (นอกเหนือจากประเภทการเข้ารหัสข้อความ Weave) หมายเหตุ: บิตที่สำคัญที่สุด 16 จาก 32 บิตในประเภทนี้ต้องไม่ใช่เลข 0 ทั้งหมด เนื่องจากค่าเหล่านี้สงวนไว้สำหรับคีย์การเข้ารหัสข้อความ Weave เท่านั้น ประเภทคีย์กลุ่มองค์ประกอบ ประเภทคีย์รูทของกลุ่มแอปพลิเคชัน
`kType_AppRotatingKey`	ประเภทคีย์การหมุนเวียนแอปพลิเคชัน
`kType_AppStaticKey`	ประเภทคีย์แบบคงที่ของแอปพลิเคชัน
`kType_General`	ประเภทคีย์ทั่วไป
`kType_None`	ประเภทคีย์ Weave ที่ใช้สำหรับการเข้ารหัสข้อความ Weave หมายเหตุ: 16 บิตที่สำคัญที่สุดของประเภทคีย์การเข้ารหัสข้อความควรเป็น 0 เพราะรหัสเพียง 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

สร้างรหัสคีย์เพื่อถอดรหัสและสำหรับแสดงผลสตริงอธิบาย

การคืนสินค้า

ตัวชี้ไปยังสตริงที่มีค่าสิ้นสุด 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
)

รับรหัสคีย์ Epoch ของกลุ่มแอปพลิเคชันที่ใช้เพื่อรับคีย์แอปพลิเคชันที่ระบุ

รายละเอียด

พารามิเตอร์

[in] keyId

Weave ตัวระบุคีย์กลุ่มแอปพลิเคชัน

การคืนสินค้า

รหัสคีย์ Epoch

GetEpochKeyNumber

uint8_t GetEpochKeyNumber(
  uint32_t keyId
)

รับหมายเลขคีย์ Epoch ของกลุ่มแอปพลิเคชันที่ใช้เพื่อรับคีย์แอปพลิเคชันที่ระบุ

รายละเอียด

พารามิเตอร์

[in] keyId

Weave ตัวระบุคีย์กลุ่มแอปพลิเคชัน

การคืนสินค้า

หมายเลขคีย์ Epoch

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 Key Identifier

การคืนสินค้า

ของรหัสคีย์

IncorporatesAppGroupMasterKey

bool IncorporatesAppGroupMasterKey(
  uint32_t keyId
)

ตรวจสอบว่ารหัสคีย์กลุ่มแอปพลิเคชันที่ระบุมีคีย์หลักของกลุ่มหรือไม่

รายละเอียด

พารามิเตอร์

[in] keyId

Weave ตัวระบุคีย์กลุ่มแอปพลิเคชัน

การคืนสินค้า

"จริง" หาก keyId มีคีย์ต้นแบบของกลุ่ม

IncorporatesEpochKey

bool IncorporatesEpochKey(
  uint32_t keyId
)

ระบุว่ารหัสคีย์กลุ่มแอปพลิเคชันที่ระบุรวมคีย์ Epoch หรือไม่

รายละเอียด

พารามิเตอร์

[in] keyId

Weave ตัวระบุคีย์กลุ่มแอปพลิเคชัน

การคืนสินค้า

"จริง" หาก keyId มีคีย์ Epoch

IncorporatesRootKey

bool IncorporatesRootKey(
  uint32_t keyId
)

ตรวจสอบว่ารหัสคีย์กลุ่มแอปพลิเคชันที่ระบุรวมคีย์รูทหรือไม่

รายละเอียด

พารามิเตอร์

[in] keyId

Weave ตัวระบุคีย์กลุ่มแอปพลิเคชัน

การคืนสินค้า

"จริง" หาก keyId มีคีย์รูท

IsAppEpochKey

bool IsAppEpochKey(
  uint32_t keyId
)

ระบุว่ารหัสคีย์ที่ระบุเป็นประเภทคีย์ Epoch ของแอปพลิเคชันหรือไม่

รายละเอียด

พารามิเตอร์

[in] keyId

Weave Key Identifier

การคืนสินค้า

true ถ้า keyId ของประเภทคีย์ Epoch ของแอปพลิเคชัน

IsAppGroupKey

bool IsAppGroupKey(
  uint32_t keyId
)

ระบุว่ารหัสคีย์ที่ระบุเป็นของหนึ่งในประเภทคีย์กลุ่มแอปพลิเคชัน (คงที่หรือแบบหมุนเวียน)

รายละเอียด

พารามิเตอร์

[in] keyId

Weave Key Identifier

การคืนสินค้า

"จริง" หาก keyId เป็นประเภทคีย์แบบหมุนเวียนหรือแบบคงที่

IsAppGroupMasterKey

bool IsAppGroupMasterKey(
  uint32_t keyId
)

ระบุว่ารหัสคีย์ที่ระบุเป็นประเภทคีย์หลักของกลุ่มแอปพลิเคชันหรือไม่

รายละเอียด

พารามิเตอร์

[in] keyId

Weave Key Identifier

การคืนสินค้า

"จริง" หาก keyId ของประเภทคีย์หลักของกลุ่มแอปพลิเคชัน

IsAppRootKey

bool IsAppRootKey(
  uint32_t keyId
)

ระบุว่ารหัสคีย์ที่ระบุเป็นประเภทคีย์รูทของแอปพลิเคชันหรือไม่

รายละเอียด

พารามิเตอร์

[in] keyId

Weave Key Identifier

การคืนสินค้า

"จริง" หาก keyId ของประเภทคีย์รูทของแอปพลิเคชัน

IsAppRotatingKey

bool IsAppRotatingKey(
  uint32_t keyId
)

ระบุว่ารหัสคีย์ที่ระบุเป็นประเภทการหมุนเวียนแอปพลิเคชันหรือไม่

รายละเอียด

พารามิเตอร์

[in] keyId

Weave Key Identifier

การคืนสินค้า

"จริง" หาก keyId ของประเภทการหมุนเวียนแอปพลิเคชัน

IsAppStaticKey

bool IsAppStaticKey(
  uint32_t keyId
)

ระบุว่ารหัสคีย์ที่ระบุเป็นรหัสแบบคงที่ของแอปพลิเคชันหรือไม่

รายละเอียด

พารามิเตอร์

[in] keyId

Weave Key Identifier

การคืนสินค้า

"จริง" หาก keyId ของประเภทคงที่ของแอปพลิเคชัน

IsGeneralKey

bool IsGeneralKey(
  uint32_t keyId
)

ระบุว่ารหัสคีย์ที่ระบุเป็นประเภททั่วไปหรือไม่

รายละเอียด

พารามิเตอร์

[in] keyId

Weave Key Identifier

การคืนสินค้า

"จริง" หาก 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
)

กำหนดว่ารหัสคีย์ 2 รหัสระบุคีย์เดียวกัน หรือในกรณีของคีย์แบบหมุนเวียน กลุ่มคีย์เดียวกันโดยไม่เกี่ยวข้องกับ Epoch ใดโดยเฉพาะ

รายละเอียด

พารามิเตอร์

`[in] keyId1`	รหัสคีย์แรกที่จะทดสอบ
`[in] keyId2`	รหัสคีย์ที่ 2 ที่จะทดสอบ

การคืนสินค้า

เป็นจริงหากรหัสคีย์แสดงคีย์เดียวกัน

IsSessionKey

bool IsSessionKey(
  uint32_t keyId
)

ระบุว่ารหัสคีย์ที่ระบุเป็นประเภทเซสชันหรือไม่

รายละเอียด

พารามิเตอร์

[in] keyId

Weave Key Identifier

การคืนสินค้า

"จริง" หาก keyId ของประเภทเซสชัน

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" หรือไม่ คีย์ Epoch

การคืนสินค้า

รหัสคีย์กลางของแอปพลิเคชัน

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" หรือไม่ คีย์ Epoch

การคืนสินค้า

รหัสคีย์กลุ่มแอปพลิเคชัน

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" หรือไม่ คีย์ Epoch

การคืนสินค้า

รหัสคีย์การหมุนเวียนแอปพลิเคชัน

MakeAppStaticKeyId

uint32_t MakeAppStaticKeyId(
  uint32_t rootKeyId,
  uint32_t appGroupMasterKeyId
)

สร้างรหัสคีย์แบบคงที่ของแอปพลิเคชันที่มีรหัสคีย์ส่วนประกอบ

รายละเอียด

พารามิเตอร์

`[in] rootKeyId`	รหัสคีย์รูทที่ใช้เพื่อรับคีย์แบบคงที่ของแอปพลิเคชัน
`[in] appGroupMasterKeyId`	รหัสคีย์มาสเตอร์ของกลุ่มแอปพลิเคชันที่ใช้เพื่อรับคีย์แบบคงที่ของแอปพลิเคชัน

การคืนสินค้า

รหัสคีย์แบบคงที่ของแอปพลิเคชัน

MakeEpochKeyId

uint32_t MakeEpochKeyId(
  uint8_t epochKeyNumber
)

สร้างรหัสคีย์รูทของกลุ่มแอปพลิเคชันที่ระบุหมายเลขคีย์ Epoch

รายละเอียด

พารามิเตอร์

[in] epochKeyNumber

หมายเลขคีย์ Epoch

การคืนสินค้า

รหัสคีย์ 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
)

อัปเดตรหัสคีย์กลุ่มแอปพลิเคชันด้วยหมายเลขคีย์ Epoch ใหม่

รายละเอียด

พารามิเตอร์

`[in] keyId`	รหัสคีย์แอปพลิเคชัน
`[in] epochKeyId`	รหัสคีย์ Epoch ซึ่งจะนำมาใช้ในการสร้างรหัสคีย์แอปพลิเคชันที่อัปเดตแล้ว

การคืนสินค้า

รหัสคีย์แอปพลิเคชัน

UsesCurrentEpochKey

bool UsesCurrentEpochKey(
  uint32_t keyId
)

ตรวจสอบว่ารหัสคีย์กลุ่มแอปพลิเคชันที่ระบุใช้ "ปัจจุบัน" หรือไม่ คีย์ Epoch

รายละเอียด

พารามิเตอร์

[in] keyId

Weave ตัวระบุคีย์กลุ่มแอปพลิเคชัน

การคืนสินค้า

"จริง" หาก keyId ระบุการใช้งานคีย์ Epoch ปัจจุบัน