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

nl::Weave::WeaveKeyId

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

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

สรุป

คลาสนี้ประกอบด้วยประเภทคีย์ แฟล็กคีย์ การกำหนดช่องรหัสคีย์ และฟังก์ชัน 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 บิตของประเภทเหล่านี้ไม่ใช่ 0 ทั้งหมด เนื่องจากค่าเหล่านี้สงวนไว้สำหรับคีย์การเข้ารหัสข้อความ Weave เท่านั้น ประเภทคีย์กลุ่มส่วนประกอบ ประเภทคีย์รูทของกลุ่มแอปพลิเคชัน
`kType_AppRotatingKey`	ประเภทคีย์การหมุนเวียนแอปพลิเคชัน
`kType_AppStaticKey`	ประเภทคีย์แบบคงที่ของแอปพลิเคชัน
`kType_General`	ประเภทคีย์ทั่วไป
`kType_None`	ประเภทคีย์ที่ใช้ Weave ใช้สำหรับการเข้ารหัสข้อความ Weave หมายเหตุ: บิตที่สำคัญที่สุด 16 บิตของประเภทคีย์การเข้ารหัสข้อความควรเป็น 0 เนื่องจากมีการเข้ารหัสข้อความ Weave เพียง 16 บิต ข้อความ 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

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

การส่งคืน

หมายเลขภายในของกลุ่มแอปพลิเคชัน

GetAppGroupMasterKeyId

uint32_t GetAppGroupMasterKeyId(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

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

การส่งคืน

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

GetEpochKeyId

uint32_t GetEpochKeyId(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

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

การส่งคืน

รหัสคีย์ Epoch

GetEpochKeyNumber

uint8_t GetEpochKeyNumber(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

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

การส่งคืน

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

GetRootKeyId

uint32_t GetRootKeyId(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

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

การส่งคืน

รหัสคีย์รูท

GetRootKeyNumber

uint8_t GetRootKeyNumber(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

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

การส่งคืน

หมายเลขคีย์ราก

GetType

uint32_t GetType(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

ตัวระบุคีย์ Weave

การส่งคืน

ประเภทรหัสคีย์

IncorporatesAppGroupMasterKey

bool IncorporatesAppGroupMasterKey(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

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

การส่งคืน

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

IncorporatesEpochKey

bool IncorporatesEpochKey(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

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

การส่งคืน

true ถ้า keyId มีคีย์ Epoch

IncorporatesRootKey

bool IncorporatesRootKey(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

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

การส่งคืน

true หาก keyId มีคีย์รูท

IsAppEpochKey

bool IsAppEpochKey(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

ตัวระบุคีย์ Weave

การส่งคืน

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

IsAppGroupKey

bool IsAppGroupKey(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

ตัวระบุคีย์ Weave

การส่งคืน

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

IsAppGroupMasterKey

bool IsAppGroupMasterKey(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

ตัวระบุคีย์ Weave

การส่งคืน

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

IsAppRootKey

bool IsAppRootKey(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

ตัวระบุคีย์ Weave

การส่งคืน

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

IsAppRotatingKey

bool IsAppRotatingKey(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

ตัวระบุคีย์ Weave

การส่งคืน

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

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
)

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

รายละเอียด

พารามิเตอร์

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

การส่งคืน

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

IsSessionKey

bool IsSessionKey(
  uint32_t keyId
)

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

รายละเอียด

พารามิเตอร์

[in] keyId

ตัวระบุคีย์ Weave

การส่งคืน

จริง หาก 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`	ธงบูลีนที่ระบุว่าควรดึงคีย์โดยใช้คีย์ 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`	ธงบูลีนที่ระบุว่าควรดึงคีย์โดยใช้คีย์ 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`	ธงบูลีนที่ระบุว่าควรดึงคีย์โดยใช้คีย์ 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

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

การส่งคืน

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