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

ฟังก์ชันสาธารณะแบบคงที่

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
ตรวจสอบว่ารหัสคีย์ที่ระบุเป็นคีย์ประเภทแอปพลิเคชันของแอปพลิเคชันหรือไม่
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
พิจารณาว่ารหัสคีย์กลุ่มแอปพลิเคชันที่ระบุใช้ "current" คีย์ Epoch หรือไม่

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

@52

 @52

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

พร็อพเพอร์ตี้
kClientRootKey

รหัสคีย์รูทของไคลเอ็นต์

kFabricRootKey

รหัสคีย์รูทของ Canvas

kFabricSecret

รหัสข้อมูลลับของทอ

kKeyNumber_Max

ค่าสูงสุดของช่องย่อยรหัสคีย์

kNone

แสดงให้เห็นถึงรหัสคีย์ส่วนกลาง

รหัสคีย์ Weave ที่ไม่ระบุ

kServiceRootKey

รหัสคีย์รูทของบริการ

kType_AppEpochKey

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

kType_AppGroupMasterKey

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

kType_AppIntermediateKey

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

kType_AppRootKey

ประเภทคีย์ Weave (นอกเหนือจากประเภทการเข้ารหัสข้อความ Weave)

kType_AppRotatingKey

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

kType_AppStaticKey

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

kType_General

ประเภทคีย์ทั่วไป

kType_None

ประเภทคีย์ Weave ที่ใช้สําหรับการเข้ารหัสข้อความ Weave

kType_Session

ประเภทคีย์เซสชัน

ฟังก์ชันสาธารณะแบบคงที่

แปลงเป็นรหัสแอปปัจจุบัน

uint32_t ConvertToCurrentAppKeyId(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
รหัสคีย์แอปพลิเคชัน
การคืนสินค้า
รหัสคีย์ปัจจุบันของแอปพลิเคชัน

แปลงเป็นรหัสแอปแบบคงที่

uint32_t ConvertToStaticAppKeyId(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
รหัสคีย์แอปพลิเคชัน
การคืนสินค้า
รหัสคีย์แบบคงที่ของแอปพลิเคชัน

คําอธิบาย

const char * DescribeKey(
  uint32_t keyId
)

ถอดรหัสตัวระบุคีย์ Weave ด้วยสตริงที่สื่อความหมาย

รายละเอียด
พารามิเตอร์
[in] keyId
สานรหัสคีย์เพื่อถอดรหัสและแสดงผลสตริงที่สื่อความหมาย
การคืนสินค้า
ตัวชี้ไปยังสตริงที่สิ้นสุดโดย NULL ที่อธิบายรหัสคีย์ที่ระบุ

รับหมายเลขกลุ่มแอปในเครื่อง

uint8_t GetAppGroupLocalNumber(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สานตัวระบุคีย์กลุ่มแอปพลิเคชัน
การคืนสินค้า
หมายเลขกลุ่มแอปพลิเคชันของแอปพลิเคชัน

รับคีย์กลุ่มแอป

uint32_t GetAppGroupMasterKeyId(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สานตัวระบุคีย์กลุ่มแอปพลิเคชัน
การคืนสินค้า
รหัสคีย์กลุ่มแอปพลิเคชัน

รับรหัส Epoch

uint32_t GetEpochKeyId(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สานตัวระบุคีย์กลุ่มแอปพลิเคชัน
การคืนสินค้า
รหัสคีย์ Epoch

จํานวนคีย์ Epoch

uint8_t GetEpochKeyNumber(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สานตัวระบุคีย์กลุ่มแอปพลิเคชัน
การคืนสินค้า
หมายเลขคีย์ Epoch

รหัสคีย์รูท

uint32_t GetRootKeyId(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สานตัวระบุคีย์กลุ่มแอปพลิเคชัน
การคืนสินค้า
รหัสคีย์รูท

หมายเลขคีย์รูท

uint8_t GetRootKeyNumber(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สานตัวระบุคีย์กลุ่มแอปพลิเคชัน
การคืนสินค้า
หมายเลขคีย์รูท

ประเภท Get

uint32_t GetType(
  uint32_t keyId
)

รับประเภทคีย์ Weave ของรหัสคีย์ที่ระบุ

รายละเอียด
พารามิเตอร์
[in] keyId
สลับตัวระบุคีย์
การคืนสินค้า
ประเภทของรหัสคีย์

คีย์ IncorporatesAppGroupMaster

bool IncorporatesAppGroupMasterKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สานตัวระบุคีย์กลุ่มแอปพลิเคชัน
การคืนสินค้า
true หาก keyId รวมคีย์หลักของกลุ่ม

รวม EpochKey

bool IncorporatesEpochKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สานตัวระบุคีย์กลุ่มแอปพลิเคชัน
การคืนสินค้า
true หาก keyId รวมคีย์ epoch

คีย์รูท

bool IncorporatesRootKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สานตัวระบุคีย์กลุ่มแอปพลิเคชัน
การคืนสินค้า
true หาก keyId รวมคีย์รูท

คีย์ IsAppEpoch

bool IsAppEpochKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สลับตัวระบุคีย์
การคืนสินค้า
true หากคีย์ ID ของประเภทคีย์ Epoch ของแอปพลิเคชัน

คีย์กลุ่มแอป

bool IsAppGroupKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สลับตัวระบุคีย์
การคืนสินค้า
true หากคีย์Id หมุนเวียนอยู่ในประเภทคีย์หมุนเวียนหรือแบบคงที่

คีย์กลุ่มแอป

bool IsAppGroupMasterKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สลับตัวระบุคีย์
การคืนสินค้า
true หากคีย์คีย์ของประเภทคีย์หลักของกลุ่มแอปพลิเคชัน

คีย์ IsAppRoot

bool IsAppRootKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สลับตัวระบุคีย์
การคืนสินค้า
true หากคีย์คีย์ของประเภทคีย์รูทของแอปพลิเคชัน

คีย์แบบหมุน

bool IsAppRotatingKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สลับตัวระบุคีย์
การคืนสินค้า
true หากคีย์Id ของประเภทการหมุนเวียนแอปพลิเคชัน

เป็นคีย์แบบคงที่

bool IsAppStaticKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สลับตัวระบุคีย์
การคืนสินค้า
true หากคีย์Id ของประเภทแอปพลิเคชันแบบคงที่

คีย์ทั่วไป

bool IsGeneralKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สลับตัวระบุคีย์
การคืนสินค้า
true หาก keyId มีประเภททั่วไป

รหัสคีย์การรับส่งข้อความ

bool IsMessageEncryptionKeyId(
  uint32_t keyId,
  bool allowLogicalKeys
)

พิจารณาว่ารหัสคีย์ที่ระบุระบุคีย์ที่เหมาะสําหรับการเข้ารหัสข้อความ Weave หรือไม่

รายละเอียด
พารามิเตอร์
[in] keyId
รหัสคีย์ทอ
[in] allowLogicalKeys
ระบุว่ารหัสคีย์เชิงตรรกะ (เช่น "current" การหมุนเวียนคีย์) ควรเหมาะสําหรับการเข้ารหัสข้อความหรือไม่
การคืนสินค้า
true หากสามารถใช้คีย์ที่ระบุเพื่อเข้ารหัสข้อความ Weave ได้

IsSameKeyOrGroup

bool IsSameKeyOrGroup(
  uint32_t keyId1,
  uint32_t keyId2
)

กําหนดว่ารหัสคีย์ 2 รหัสจะระบุคีย์เดียวกันหรือในกรณีที่หมุนเวียนคีย์ กลุ่มคีย์เดียวกันจะไม่ขึ้นอยู่กับ Epoch ประเภทใดประเภทหนึ่ง

รายละเอียด
พารามิเตอร์
[in] keyId1
รหัสคีย์แรกที่จะทดสอบ
[in] keyId2
รหัสคีย์ที่ 2 ที่จะทดสอบ
การคืนสินค้า
เป็นจริงหากรหัสคีย์แสดงถึงคีย์เดียวกัน

รหัสเซสชัน

bool IsSessionKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สลับตัวระบุคีย์
การคืนสินค้า
true หาก keyId ของประเภทเซสชัน

รหัสคีย์ที่ถูกต้อง

bool IsValidKeyId(
  uint32_t keyId
)

ตรวจสอบว่าตัวระบุคีย์มีค่าที่ถูกต้อง (ถูกกฎหมาย) หรือไม่

รายละเอียด
พารามิเตอร์
[in] keyId
รหัสคีย์ทอ
การคืนสินค้า
true หากค่ารหัสคีย์ถูกต้อง

รหัสคีย์กลุ่มแอป

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" epoch หรือไม่
การคืนสินค้า
รหัสคีย์สื่อกลางของแอปพลิเคชัน

รหัสคีย์ของแอป

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 หรือไม่
การคืนสินค้า
รหัสคีย์กลุ่มแอปพลิเคชัน

เปลี่ยนรหัสคีย์ของแอป

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 หรือไม่
การคืนสินค้า
รหัสคีย์การหมุนเวียนแอปพลิเคชัน

รหัสคีย์ของแอปแบบคงที่

uint32_t MakeAppStaticKeyId(
  uint32_t rootKeyId,
  uint32_t appGroupMasterKeyId
)

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

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

รหัสคีย์ Epoch

uint32_t MakeEpochKeyId(
  uint8_t epochKeyNumber
)

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

รายละเอียด
พารามิเตอร์
[in] epochKeyNumber
หมายเลขคีย์ Epoch
การคืนสินค้า
รหัสคีย์ Epoch

รหัสคีย์ทั่วไป

uint16_t MakeGeneralKeyId(
  uint16_t generalKeyNumber
)

สร้างรหัสคีย์ทั่วไปตามหมายเลขคีย์ทั่วไป

รายละเอียด
พารามิเตอร์
[in] generalKeyNumber
หมายเลขคีย์ทั่วไป
การคืนสินค้า
รหัสคีย์ทั่วไป

รหัสคีย์รูท

uint32_t MakeRootKeyId(
  uint8_t rootKeyNumber
)

สร้างรหัสคีย์รูทของกลุ่มตามหมายเลขคีย์รูท

รายละเอียด
พารามิเตอร์
[in] rootKeyNumber
หมายเลขคีย์รูท
การคืนสินค้า
รหัสคีย์รูท

รหัสเซสชันคีย์

uint16_t MakeSessionKeyId(
  uint16_t sessionKeyNumber
)

สร้างรหัสคีย์เซสชันที่ระบุหมายเลขคีย์เซสชัน

รายละเอียด
พารามิเตอร์
[in] sessionKeyNumber
หมายเลขเซสชันคีย์
การคืนสินค้า
รหัสคีย์เซสชัน

อัปเดตรหัส Epoch

uint32_t UpdateEpochKeyId(
  uint32_t keyId,
  uint32_t epochKeyId
)

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

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

ใช้CurrentEpochKey

bool UsesCurrentEpochKey(
  uint32_t keyId
)

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

รายละเอียด
พารามิเตอร์
[in] keyId
สานตัวระบุคีย์กลุ่มแอปพลิเคชัน
การคืนสินค้า
true หาก keyId ระบุการใช้คีย์ Epoch ปัจจุบัน