keyCredential-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Enthält Schlüsselanmeldeinformationen, die einer Anwendung oder einem Dienstprinzipal zugeordnet sind. Die keyCredentials-Eigenschaft der Entitäten application und servicePrincipal ist eine Sammlung von keyCredential.

Informationen zum Hinzufügen von keyCredential mithilfe von Microsoft Graph finden Sie unter Hinzufügen eines Zertifikats zu einer App mithilfe von Microsoft Graph.

Eigenschaften

Eigenschaft	Typ	Beschreibung
customKeyIdentifier	Binär	Ein binärtyp mit 40 Zeichen, der zum Identifizieren der Anmeldeinformationen verwendet werden kann. Optional. Wenn nicht in der Nutzlast angegeben, wird standardmäßig der Fingerabdruck des Zertifikats verwendet.
displayName	String	Anzeigename für den Schlüssel. Optional.
endDateTime	DateTimeOffset	Das Datum und die Uhrzeit, zu dem die Anmeldeinformationen ablaufen. Der DateTimeOffset-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
Schlüssel	Binär	Wert für die Schlüsselanmeldeinformationen. Sollte ein Base64-codierter Wert sein. Wird nur $select für ein einzelnes Objekt zurückgegeben, d. h GET applications/{applicationId}?$select=keyCredentials . oder GET servicePrincipals/{servicePrincipalId}?$select=keyCredentials, andernfalls ist es immer null. Aus einem .cer Zertifikat können Sie den Schlüssel mithilfe der Convert.ToBase64String() -Methode lesen. Weitere Informationen finden Sie unter Abrufen des Zertifikatschlüssels.
keyId	GUID	Der eindeutige Bezeichner für den Schlüssel.
startDateTime	DateTimeOffset	Das Datum und die Uhrzeit, zu dem die Anmeldeinformationen gültig werden. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
type	String	Der Typ der Schlüsselanmeldeinformationen; Beispiel: Symmetric, AsymmetricX509Certoder X509CertAndPassword.
Verwendung	String	Eine Zeichenfolge, die den Zweck beschreibt, für den der Schlüssel verwendet werden kann; Beispielsweise None, , VerifyPairwiseIdentifier, , Delegation, Decrypt, Encrypt, , HashedIdentifierSelfSignedTls, oder Sign. Wenn usage ist Sign, sollte der Typ sein X509CertAndPassword, und die PasswordCredentials zum Signieren sollten definiert werden.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.keyCredential",
  "customKeyIdentifier": "Binary",
  "displayName": "String",
  "endDateTime": "String (timestamp)",
  "key": "Binary",
  "keyId": "Guid",
  "startDateTime": "String (timestamp)",
  "type": "String",
  "usage": "String"
}