Type de ressource keyCredential
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"
}