Type de ressource keyCredential

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Contient des informations d’identification de clé associées à une application ou à un principal de service. La propriété keyCredentials des entités application et servicePrincipal est une collection de keyCredential.

Pour ajouter une cléCredential à l’aide de Microsoft Graph, consultez Ajouter un certificat à une application à l’aide de Microsoft Graph.

Propriétés

Propriété Type Description
customKeyIdentifier Binary Type binaire de 40 caractères qui peut être utilisé pour identifier les informations d’identification. Optional. Lorsqu’elle n’est pas fournie dans la charge utile, la valeur par défaut est l’empreinte numérique du certificat.
displayName String Nom convivial de la clé, avec une longueur maximale de 90 caractères. Les valeurs plus longues sont acceptées, mais raccourcies. Optional.
endDateTime DateTimeOffset Date et heure d’expiration des informations d’identification. Le type DateTimeOffset représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
clé Binary Valeur des informations d’identification de la clé. Doit être une valeur encodée en Base64. Retourné uniquement sur $select pour un seul objet, c’est-à-dire , GET applications/{applicationId}?$select=keyCredentials ou GET servicePrincipals/{servicePrincipalId}?$select=keyCredentials; sinon, il est toujours null.

À partir d’un certificat .cer, vous pouvez lire la clé à l’aide de la méthode Convert.ToBase64String(). Pour plus d’informations, consultez Obtenir la clé de certificat.
keyId Guid Identificateur unique de la clé.
startDateTime DateTimeOffset Date et heure auxquelles les informations d’identification deviennent valides. Le type Timestamp représente les informations de date et d’heure au format ISO 8601 et est toujours en heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
type String Type d’informations d’identification de clé ; par exemple, Symmetric, AsymmetricX509Certou X509CertAndPassword.
usage String Chaîne qui décrit l’objectif pour lequel la clé peut être utilisée ; par exemple, None, Verify, PairwiseIdentifier, DelegationDecrypt, Encrypt, HashedIdentifier, SelfSignedTls, ou Sign.

Si l’utilisation est Sign, le type doit être X509CertAndPassword, et les passwordCredentials pour la signature doivent être définis.

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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