nl::Weave::Profiles::Security::AppKeys

Không gian tên này bao gồm tất cả các giao diện trong thư viện khoá ứng dụng Weave trong hồ sơ bảo mật của Weave.

Tóm tắt

Bảng liệt kê

@220{
  kWeaveAppGroupKeySize = 32,
  kWeaveAppRootKeySize = kWeaveAppGroupKeySize,
  kWeaveAppEpochKeySize = kWeaveAppGroupKeySize,
  kWeaveAppGroupMasterKeySize = kWeaveAppGroupKeySize,
  kWeaveAppIntermediateKeySize = kWeaveAppGroupKeySize,
  kWeaveFabricSecretSize = 36,
  kWeaveAppFabricRootKeyDiversifierSize = sizeof(kWeaveAppFabricRootKeyDiversifier),
  kWeaveAppClientRootKeyDiversifierSize = sizeof(kWeaveAppClientRootKeyDiversifier),
  kWeaveAppIntermediateKeyDiversifierSize = sizeof(kWeaveAppIntermediateKeyDiversifier)
}
enum
Dệt định nghĩa tham số giao thức khoá ứng dụng.
WeaveAppGroupGlobalId{
  kWeaveAppGroupGlobalId_Unspecified = 0,
  kWeaveAppGroupGlobalId_NestPhysicalAccess = (kWeaveVendor_NestLabs << 16) | 0x0001,
  kWeaveAppGroupGlobalId_NestStructureSecurity = (kWeaveVendor_NestLabs << 16) | 0x0002,
  kWeaveAppGroupGlobalId_NestHVAC = (kWeaveVendor_NestLabs << 16) | 0x0003,
  kWeaveAppGroupGlobalId_NestSecurityControl = (kWeaveVendor_NestLabs << 16) | 0x0004
}
enum
Mã chung của nhóm ứng dụng Weave (AGGID).

Biến

kWeaveAppClientRootKeyDiversifier = { 0x53, 0xE3, 0xFF, 0xE5 }[]
const uint8_t
Công cụ đa dạng hoá chính dùng để dẫn xuất khoá gốc ứng dụng của Weave.
kWeaveAppFabricRootKeyDiversifier = { 0x21, 0xFA, 0x8F, 0x6A }[]
const uint8_t
Công cụ đa dạng hoá chính được sử dụng để lấy khoá gốc từ vải Weave.
kWeaveAppIntermediateKeyDiversifier = { 0xBC, 0xAA, 0x95, 0xAD }[]
const uint8_t
Công cụ đa dạng hoá chính được sử dụng để dẫn xuất khoá trung gian của Weave.

Hàm

GetAppGroupMasterKeyId(uint32_t groupGlobalId, GroupKeyStoreBase *groupKeyStore, uint32_t & groupMasterKeyId)
Nhận mã khoá chính của nhóm ứng dụng được cấp cho mã nhận dạng chung của nhóm ứng dụng.
LogGroupKeys(GroupKeyStoreBase *groupKeyStore)

Lớp

nl::Weave::Profiles::Security::AppKeys::DummyGroupKeyStore
nl::Weave::Profiles::Security::AppKeys::GroupKeyStoreBase

Định nghĩa về lớp kho khoá cho nhóm Weave.

nl::Weave::Profiles::Security::AppKeys::WeaveGroupKey

Chứa thông tin về khoá nhóm ứng dụng của Weave.

Bảng liệt kê

@220

 @220

Dệt định nghĩa tham số giao thức khoá ứng dụng.

Thuộc tính
kWeaveAppClientRootKeyDiversifierSize

Kích thước của trình đa dạng hoá khoá gốc ứng dụng.

kWeaveAppEpochKeySize

Kích thước khoá thời gian bắt đầu của ứng dụng dạng dệt.

kWeaveAppFabricRootKeyDiversifierSize

Kích thước của trình đa dạng hoá khoá gốc.

kWeaveAppGroupKeySize

Kích thước khoá nhóm cấu thành.

kWeaveAppGroupMasterKeySize

Dệt kích thước khoá chính của nhóm ứng dụng.

kWeaveAppIntermediateKeyDiversifierSize

Kích thước của phần đa dạng hoá khoá ở mức trung bình.

kWeaveAppIntermediateKeySize

Kích thước khoá trung gian của ứng dụng dệt.

kWeaveAppRootKeySize

Kích thước khoá gốc của ứng dụng dệt.

kWeaveFabricSecretSize

Dệt kích thước bí mật của vải.

WeaveAppGroupGlobalId

 WeaveAppGroupGlobalId

Mã chung của nhóm ứng dụng Weave (AGGID).

Thuộc tính
kWeaveAppGroupGlobalId_NestHVAC

Nest HVAC Group.

kWeaveAppGroupGlobalId_NestPhysicalAccess

Mã chung của nhóm ứng dụng Nest Labs.

Lưu ý: Đừng cố gắng tự phân bổ các giá trị này. Các giá trị này do Nest Labs quản lý. Vui lòng gửi yêu cầu chính thức qua "Nest Weave: Nest Application Group Global ID Registry" https://docs.google.com/document/d/1xHLAcTvLZg2YGoJfbUb2nbPIvaCNuoygmdiNwC-PJHI.Nest Physical Access Group.

kWeaveAppGroupGlobalId_NestSecurityControl

Nhóm kiểm soát Bảo mật Nest.

kWeaveAppGroupGlobalId_NestStructureSecurity

Nhóm Security trong Nest Structure.

kWeaveAppGroupGlobalId_Unspecified

Chưa chỉ định mã chung của nhóm ứng dụng.

Biến

kWeaveAppClientRootKeyDiversifier

const uint8_t kWeaveAppClientRootKeyDiversifier[] = { 0x53, 0xE3, 0xFF, 0xE5 }

Công cụ đa dạng hoá chính dùng để dẫn xuất khoá gốc ứng dụng của Weave.

Giá trị này biểu thị 4 byte đầu tiên của SHA-1 HASH của cụm từ "Khoá gốc máy khách".

kWeaveAppFabricRootKeyDiversifier

const uint8_t kWeaveAppFabricRootKeyDiversifier[] = { 0x21, 0xFA, 0x8F, 0x6A }

Công cụ đa dạng hoá chính được sử dụng để lấy khoá gốc từ vải Weave.

Giá trị này biểu thị 4 byte đầu tiên của SHA-1 HASH của cụm từ "Fabric Root Key".

kWeaveAppIntermediateKeyDiversifier

const uint8_t kWeaveAppIntermediateKeyDiversifier[] = { 0xBC, 0xAA, 0x95, 0xAD }

Công cụ đa dạng hoá chính được sử dụng để dẫn xuất khoá trung gian của Weave.

Giá trị này biểu thị 4 byte đầu tiên của SHA-1 HASH của cụm từ "Khoá trung gian".

Hàm

GetAppGroupMasterKeyId

WEAVE_ERROR GetAppGroupMasterKeyId(
  uint32_t groupGlobalId,
  GroupKeyStoreBase *groupKeyStore,
  uint32_t & groupMasterKeyId
)

Nhận mã khoá chính của nhóm ứng dụng được cấp cho mã nhận dạng chung của nhóm ứng dụng.

Thông tin chi tiết
Các tham số
[in] groupGlobalId
Mã chung của nhóm ứng dụng.
[in] groupKeyStore
Con trỏ đến đối tượng kho khoá nhóm.
[out] groupMasterKeyId
Mã khoá chính của nhóm ứng dụng.
Giá trị trả về
WEAVE_NO_ERROR
Khi thành công.
WEAVE_ERROR_INVALID_ARGUMENT
Nếu con trỏ đến kho khoá nhóm không được cung cấp.
WEAVE_ERROR_UNSUPPORTED_WEAVE_FEATURE
Nếu đối tượng FabricState không được khởi chạy với kho khoá nhóm đầy đủ chức năng.
WEAVE_ERROR_KEY_NOT_FOUND
Nếu không tìm thấy khoá nhóm có mã nhận dạng chung đã chỉ định trong kho khoá của nền tảng.
other
Các lỗi khác theo nền tảng cụ thể do API kho khoá của nền tảng trả về.

LogGroupKeys

WEAVE_ERROR LogGroupKeys(
  GroupKeyStoreBase *groupKeyStore
)