nl:: Weave:: WeaveKeyId
#include <src/lib/core/WeaveKeyIds.h>
Die Definition der Weave-Schlüsselkennung.
Zusammenfassung
Diese Klasse enthält Schlüsseltypen, Schlüssel-Flags, Definition von Schlüssel-ID-Feldern und API-Funktionen.
Öffentliche Typen |
|
---|---|
@52{
|
enum ID-Felder, Flags und Typen für Public Weave-Schlüssel. |
Öffentliche statische Funktionen |
|
---|---|
ConvertToCurrentAppKeyId(uint32_t keyId)
|
uint32_t
Konvertieren Sie die Schlüssel-ID der Anwendungsgruppe in die aktuelle Schlüssel-ID der Anwendung.
|
ConvertToStaticAppKeyId(uint32_t keyId)
|
uint32_t
Konvertieren Sie die Anwendungsschlüssel-ID in eine statische Anwendungsschlüssel-ID.
|
DescribeKey(uint32_t keyId)
|
const char *
Decodieren Sie eine Weave-Schlüsselkennung mit einem beschreibenden String.
|
GetAppGroupLocalNumber(uint32_t keyId)
|
uint8_t
Ruft die lokale Nummer der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
|
GetAppGroupMasterKeyId(uint32_t keyId)
|
uint32_t
Ruft die Masterschlüssel-ID der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
|
GetEpochKeyId(uint32_t keyId)
|
uint32_t
Ruft die Epochenschlüssel-ID der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
|
GetEpochKeyNumber(uint32_t keyId)
|
uint8_t
Ruft die Epochenschlüsselnummer der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
|
GetRootKeyId(uint32_t keyId)
|
uint32_t
Ruft die Stammschlüssel-ID der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
|
GetRootKeyNumber(uint32_t keyId)
|
uint8_t
Ruft die Stammschlüsselnummer der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
|
GetType(uint32_t keyId)
|
uint32_t
Ruft den Weave-Schlüsseltyp der angegebenen Schlüssel-ID ab.
|
IncorporatesAppGroupMasterKey(uint32_t keyId)
|
bool
Prüfen Sie, ob die angegebene Anwendungsgruppenschlüssel-ID den Gruppenmasterschlüssel enthält.
|
IncorporatesEpochKey(uint32_t keyId)
|
bool
Prüfen Sie, ob die angegebene Anwendungsgruppenschlüssel-ID einen Epochenschlüssel enthält.
|
IncorporatesRootKey(uint32_t keyId)
|
bool
Prüfen Sie, ob die angegebene Anwendungsgruppenschlüssel-ID den Stammschlüssel enthält.
|
IsAppEpochKey(uint32_t keyId)
|
bool
Prüft, ob die angegebene Schlüssel-ID vom Typ eines Schlüsseltyps aus der Anwendungs-Epoche ist.
|
IsAppGroupKey(uint32_t keyId)
|
bool
Prüfen Sie, ob die angegebene Schlüssel-ID zu einem der Anwendungsgruppen-Schlüsseltypen (statisch oder rotierend) gehört.
|
IsAppGroupMasterKey(uint32_t keyId)
|
bool
Prüfen Sie, ob die angegebene Schlüssel-ID vom Typ eines Hauptschlüsseltyps für Anwendungsgruppen ist.
|
IsAppRootKey(uint32_t keyId)
|
bool
Prüfen Sie, ob die angegebene Schlüssel-ID ein Stammschlüsseltyp der Anwendung ist.
|
IsAppRotatingKey(uint32_t keyId)
|
bool
Ermittelt, ob die angegebene Schlüssel-ID vom Typ einer rotierenden Anwendung ist.
|
IsAppStaticKey(uint32_t keyId)
|
bool
Prüft, ob die angegebene Schlüssel-ID vom Typ einer statischen Anwendung ist.
|
IsGeneralKey(uint32_t keyId)
|
bool
Ermittelt, ob die angegebene Schlüssel-ID von einem allgemeinen Typ ist.
|
IsMessageEncryptionKeyId(uint32_t keyId, bool allowLogicalKeys)
|
bool
Bestimmt, ob eine bestimmte Schlüssel-ID einen Schlüssel identifiziert, der für die Weave-Nachrichtenverschlüsselung geeignet ist.
|
IsSameKeyOrGroup(uint32_t keyId1, uint32_t keyId2)
|
bool
Bestimmt, ob zwei Schlüssel-IDs denselben Schlüssel identifizieren oder im Fall von rotierenden Schlüsseln dieselbe Gruppe von Schlüsseln unabhängig von einer bestimmten Epoche.
|
IsSessionKey(uint32_t keyId)
|
bool
Ermittelt, ob die angegebene Schlüssel-ID zu einem Sitzungstyp gehört.
|
IsValidKeyId(uint32_t keyId)
|
bool
Bestimmt, ob die Schlüsselkennung einen gültigen (rechtlichen) Wert hat.
|
MakeAppGroupMasterKeyId(uint8_t appGroupLocalNumber)
|
uint32_t
Erstellt die Masterschlüssel-ID für die Anwendungsgruppe anhand der lokalen Nummer der Anwendungsgruppe.
|
MakeAppIntermediateKeyId(uint32_t rootKeyId, uint32_t epochKeyId, bool useCurrentEpochKey)
|
uint32_t
Erstellt die Zwischenschlüssel-ID der Anwendung anhand der einzelnen Schlüssel-IDs.
|
MakeAppKeyId(uint32_t keyType, uint32_t rootKeyId, uint32_t epochKeyId, uint32_t appGroupMasterKeyId, bool useCurrentEpochKey)
|
uint32_t
Anwendungsgruppenschlüssel-ID anhand der einzelnen Schlüssel-IDs und anderer Informationen erstellen.
|
MakeAppRotatingKeyId(uint32_t rootKeyId, uint32_t epochKeyId, uint32_t appGroupMasterKeyId, bool useCurrentEpochKey)
|
uint32_t
Konstruiert eine rotierende Schlüssel-ID einer Anwendung anhand der einzelnen Schlüssel-IDs und anderer Informationen.
|
MakeAppStaticKeyId(uint32_t rootKeyId, uint32_t appGroupMasterKeyId)
|
uint32_t
Erstellt eine statische Anwendungsschlüssel-ID anhand der einzelnen Schlüssel-IDs.
|
MakeEpochKeyId(uint8_t epochKeyNumber)
|
uint32_t
Konstruiert die Stammschlüssel-ID der Anwendungsgruppe anhand der Epochenschlüsselnummer.
|
MakeGeneralKeyId(uint16_t generalKeyNumber)
|
uint16_t
Konstruiert eine allgemeine Schlüssel-ID anhand einer allgemeinen Schlüsselnummer.
|
MakeRootKeyId(uint8_t rootKeyNumber)
|
uint32_t
Erstellt die Stammschlüssel-ID der Anwendungsgruppe anhand der Stammschlüsselnummer.
|
MakeSessionKeyId(uint16_t sessionKeyNumber)
|
uint16_t
Erstellt eine Sitzungsschlüssel-ID anhand einer Sitzungsschlüsselnummer.
|
UpdateEpochKeyId(uint32_t keyId, uint32_t epochKeyId)
|
uint32_t
Anwendungsgruppenschlüssel-ID mit neuer Epochenschlüsselnummer aktualisieren.
|
UsesCurrentEpochKey(uint32_t keyId)
|
bool
Prüfen, ob für die angegebene Anwendungsgruppenschlüssel-ID „aktuell“ verwendet wird Epochenschlüssel.
|
Öffentliche Typen
52
@52
ID-Felder, Flags und Typen für Public Weave-Schlüssel.
Attribute | |
---|---|
kClientRootKey
|
ID des Stammschlüssels des Clients. |
kFabricRootKey
|
Fabric-Stammschlüssel-ID. |
kFabricSecret
|
Weave Stoff-Geheim-ID. |
kKeyNumber_Max
|
Höchstwerte für Schlüssel-ID-Unterfelder. |
kNone
|
Weave globale Schlüssel-IDs. Nicht angegebene Weave-Schlüssel-ID. |
kServiceRootKey
|
Root-Schlüssel-ID des Dienstes. |
kType_AppEpochKey
|
Epochenschlüsseltyp der Anwendungsgruppe. |
kType_AppGroupMasterKey
|
Masterschlüsseltyp der Anwendungsgruppe. |
kType_AppIntermediateKey
|
Zwischenschlüsseltyp der Anwendungsgruppe. |
kType_AppRootKey
|
Weave-Schlüsseltypen (außer Weave-Verschlüsselungstypen). |
kType_AppRotatingKey
|
Rotierender Schlüsseltyp der Anwendung. |
kType_AppStaticKey
|
Typ des statischen Anwendungsschlüssels. |
kType_General
|
Allgemeiner Schlüsseltyp. |
kType_None
|
Weave-Schlüsseltypen, die für die Weave-Nachrichtenverschlüsselung verwendet werden. |
kType_Session
|
Typ des Sitzungsschlüssels. |
Öffentliche statische Funktionen
ConvertToCurrentAppKeyId
uint32_t ConvertToCurrentAppKeyId( uint32_t keyId )
Konvertieren Sie die Schlüssel-ID der Anwendungsgruppe in die aktuelle Schlüssel-ID der Anwendung.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Aktuelle Schlüssel-ID der Anwendung.
|
ConvertToStaticAppKeyId
uint32_t ConvertToStaticAppKeyId( uint32_t keyId )
Konvertieren Sie die Anwendungsschlüssel-ID in eine statische Anwendungsschlüssel-ID.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
ID des statischen Anwendungsschlüssels.
|
DescribeKey
const char * DescribeKey( uint32_t keyId )
Decodieren Sie eine Weave-Schlüsselkennung mit einem beschreibenden String.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Ein Zeiger auf einen mit NULL beendeten String, der die angegebene Schlüssel-ID beschreibt.
|
GetAppGroupLocalNumber
uint8_t GetAppGroupLocalNumber( uint32_t keyId )
Ruft die lokale Nummer der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
lokale Nummer der Anwendungsgruppe.
|
GetAppGroupMasterKeyId
uint32_t GetAppGroupMasterKeyId( uint32_t keyId )
Ruft die Masterschlüssel-ID der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Masterschlüssel-ID der Anwendungsgruppe.
|
GetEpochKeyId
uint32_t GetEpochKeyId( uint32_t keyId )
Ruft die Epochenschlüssel-ID der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Epochenschlüssel-ID.
|
GetEpochKeyNumber
uint8_t GetEpochKeyNumber( uint32_t keyId )
Ruft die Epochenschlüsselnummer der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Epochenschlüsselnummer.
|
GetRootKeyId
uint32_t GetRootKeyId( uint32_t keyId )
Ruft die Stammschlüssel-ID der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Stammschlüssel-ID.
|
GetRootKeyNumber
uint8_t GetRootKeyNumber( uint32_t keyId )
Ruft die Stammschlüsselnummer der Anwendungsgruppe ab, die zum Ableiten des angegebenen Anwendungsschlüssels verwendet wurde.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Stammschlüsselnummer.
|
GetType
uint32_t GetType( uint32_t keyId )
Ruft den Weave-Schlüsseltyp der angegebenen Schlüssel-ID ab.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Typ der Schlüssel-ID.
|
IncorporatesAppGroupMasterKey
bool IncorporatesAppGroupMasterKey( uint32_t keyId )
Prüfen Sie, ob die angegebene Anwendungsgruppenschlüssel-ID den Gruppenmasterschlüssel enthält.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die Schlüssel-ID einen Gruppen-Masterschlüssel enthält.
|
IncorporatesEpochKey
bool IncorporatesEpochKey( uint32_t keyId )
Prüfen Sie, ob die angegebene Anwendungsgruppenschlüssel-ID einen Epochenschlüssel enthält.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die keyId einen Epochenschlüssel enthält.
|
IncorporatesRootKey
bool IncorporatesRootKey( uint32_t keyId )
Prüfen Sie, ob die angegebene Anwendungsgruppenschlüssel-ID den Stammschlüssel enthält.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die keyId einen Stammschlüssel enthält.
|
IsAppEpochKey
bool IsAppEpochKey( uint32_t keyId )
Prüft, ob die angegebene Schlüssel-ID vom Typ eines Schlüsseltyps aus der Anwendungs-Epoche ist.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die "keyId" eines Schlüsseltyps für die Anwendungsepoche festgelegt ist.
|
IsAppGroupKey
bool IsAppGroupKey( uint32_t keyId )
Prüfen Sie, ob die angegebene Schlüssel-ID zu einem der Schlüsseltypen der Anwendungsgruppe gehört (statisch oder rotierend).
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die Schlüssel-ID vom Schlüsseltyp rotieren oder statisch ist.
|
IsAppGroupMasterKey
bool IsAppGroupMasterKey( uint32_t keyId )
Prüfen Sie, ob die angegebene Schlüssel-ID vom Typ eines Hauptschlüsseltyps für Anwendungsgruppen ist.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die "keyId" eines Masterschlüsseltyps für eine Anwendungsgruppe festgelegt ist.
|
IsAppRootKey
bool IsAppRootKey( uint32_t keyId )
Prüfen Sie, ob die angegebene Schlüssel-ID ein Stammschlüsseltyp der Anwendung ist.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die keyId eines Stammschlüsseltyps einer Anwendung ist.
|
IsAppRotatingKey
bool IsAppRotatingKey( uint32_t keyId )
Ermittelt, ob die angegebene Schlüssel-ID vom Typ einer rotierenden Anwendung ist.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die Schlüssel-ID eines Anwendungsrotationstyps ist.
|
IsAppStaticKey
bool IsAppStaticKey( uint32_t keyId )
Prüft, ob die angegebene Schlüssel-ID vom Typ einer statischen Anwendung ist.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die "keyId" eines statischen Anwendungstyps festgelegt ist.
|
IsGeneralKey
bool IsGeneralKey( uint32_t keyId )
Ermittelt, ob die angegebene Schlüssel-ID von einem allgemeinen Typ ist.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die keyId vom Typ "General" (Allgemein) ist.
|
IsMessageEncryptionKeyId
bool IsMessageEncryptionKeyId( uint32_t keyId, bool allowLogicalKeys )
Ermitteln Sie, ob eine bestimmte Schlüssel-ID einen Schlüssel identifiziert, der für die Weave-Nachrichtenverschlüsselung geeignet ist.
Details | |||||
---|---|---|---|---|---|
Parameter |
|
||||
Rückgabe |
„true“, wenn der identifizierte Schlüssel zum Verschlüsseln von Weave-Nachrichten verwendet werden kann.
|
IsSameKeyOrGroup
bool IsSameKeyOrGroup( uint32_t keyId1, uint32_t keyId2 )
Bestimmt, ob zwei Schlüssel-IDs denselben Schlüssel identifizieren. Bei rotierenden Schlüsseln ist dies unabhängig von einer bestimmten Epoche dieselbe Gruppe von Schlüsseln.
Details | |||||
---|---|---|---|---|---|
Parameter |
|
||||
Rückgabe |
"True", wenn die Schlüssel-IDs denselben Schlüssel darstellen.
|
IsSessionKey
bool IsSessionKey( uint32_t keyId )
Ermittelt, ob die angegebene Schlüssel-ID zu einem Sitzungstyp gehört.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die Schlüssel-ID eines Sitzungstyps ist.
|
IsValidKeyId
bool IsValidKeyId( uint32_t keyId )
Bestimmt, ob die Schlüsselkennung einen gültigen (rechtlichen) Wert hat.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn der Schlüssel-ID-Wert gültig ist.
|
MakeAppGroupMasterKeyId
uint32_t MakeAppGroupMasterKeyId( uint8_t appGroupLocalNumber )
Erstellt die Masterschlüssel-ID für die Anwendungsgruppe anhand der lokalen Nummer der Anwendungsgruppe.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Masterschlüssel-ID der Anwendungsgruppe.
|
MakeAppIntermediateKeyId
uint32_t MakeAppIntermediateKeyId( uint32_t rootKeyId, uint32_t epochKeyId, bool useCurrentEpochKey )
Erstellt die Zwischenschlüssel-ID der Anwendung anhand der einzelnen Schlüssel-IDs.
Details | |||||||
---|---|---|---|---|---|---|---|
Parameter |
|
||||||
Rückgabe |
Zwischenschlüssel-ID der Anwendung.
|
MakeAppKeyId
uint32_t MakeAppKeyId( uint32_t keyType, uint32_t rootKeyId, uint32_t epochKeyId, uint32_t appGroupMasterKeyId, bool useCurrentEpochKey )
Anwendungsgruppenschlüssel-ID anhand der einzelnen Schlüssel-IDs und anderer Informationen erstellen.
Details | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Parameter |
|
||||||||||
Rückgabe |
Schlüssel-ID der Anwendungsgruppe.
|
MakeAppRotatingKeyId
uint32_t MakeAppRotatingKeyId( uint32_t rootKeyId, uint32_t epochKeyId, uint32_t appGroupMasterKeyId, bool useCurrentEpochKey )
Konstruiert eine rotierende Schlüssel-ID einer Anwendung anhand der einzelnen Schlüssel-IDs und anderer Informationen.
Details | |||||||||
---|---|---|---|---|---|---|---|---|---|
Parameter |
|
||||||||
Rückgabe |
die ID des rotierenden Anwendungsschlüssels.
|
MakeAppStaticKeyId
uint32_t MakeAppStaticKeyId( uint32_t rootKeyId, uint32_t appGroupMasterKeyId )
Erstellt eine statische Anwendungsschlüssel-ID anhand der einzelnen Schlüssel-IDs.
Details | |||||
---|---|---|---|---|---|
Parameter |
|
||||
Rückgabe |
ID des statischen Anwendungsschlüssels.
|
MakeEpochKeyId
uint32_t MakeEpochKeyId( uint8_t epochKeyNumber )
Konstruiert die Stammschlüssel-ID der Anwendungsgruppe anhand der Epochenschlüsselnummer.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Epochenschlüssel-ID.
|
MakeGeneralKeyId
uint16_t MakeGeneralKeyId( uint16_t generalKeyNumber )
Konstruiert eine allgemeine Schlüssel-ID anhand einer allgemeinen Schlüsselnummer.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
allgemeine Schlüssel-ID.
|
MakeRootKeyId
uint32_t MakeRootKeyId( uint8_t rootKeyNumber )
Erstellt die Stammschlüssel-ID der Anwendungsgruppe anhand der Stammschlüsselnummer.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Stammschlüssel-ID.
|
MakeSessionKeyId
uint16_t MakeSessionKeyId( uint16_t sessionKeyNumber )
Erstellt eine Sitzungsschlüssel-ID anhand einer Sitzungsschlüsselnummer.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Sitzungsschlüssel-ID.
|
UpdateEpochKeyId
uint32_t UpdateEpochKeyId( uint32_t keyId, uint32_t epochKeyId )
Anwendungsgruppenschlüssel-ID mit neuer Epochenschlüsselnummer aktualisieren.
Details | |||||
---|---|---|---|---|---|
Parameter |
|
||||
Rückgabe |
Anwendungsschlüssel-ID.
|
UsesCurrentEpochKey
bool UsesCurrentEpochKey( uint32_t keyId )
Prüfen, ob für die angegebene Anwendungsgruppenschlüssel-ID „aktuell“ verwendet wird Epochenschlüssel.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
"true", wenn die keyId angibt, dass der aktuelle Epochenschlüssel verwendet wird.
|