Freigeben über

keyCredential-Ressourcentyp

  • Artikel

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 Der Anzeigename für den Schlüssel mit einer maximalen Länge von 90 Zeichen. Längere Werte werden akzeptiert, aber verkürzt. 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 Zeichenfolge 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.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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