Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Contiene una credencial de clave asociada a una aplicación o una entidad de servicio. Se configura en la propiedad keyCredentials de las entidades application y servicePrincipal , y en la propiedad verifiedCustomDomainKeyCredential de onPremisesPublishing para representar la credencial de clave de un dominio personalizado.
Para agregar una keyCredential mediante Microsoft Graph, consulte Agregar un certificado a una aplicación mediante Microsoft Graph.
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| customKeyIdentifier | Binario | Un tipo binario de 40 caracteres que puede usarse para identificar la credencial. Opcional. Cuando no se proporciona en la carga, el valor predeterminado es la huella digital del certificado. |
| displayName | Cadena | El nombre descriptivo de la clave, con una longitud máxima de 90 caracteres. Se aceptan valores más largos pero se acortan. Opcional. |
| endDateTime | DateTimeOffset | La fecha y hora en que expira la credencial. El tipo DateTimeOffset representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| clave | Binario | Valor de la credencial de clave. Debe ser un valor codificado en Base64. Requiere $select recuperar; solo está disponible para solicitudes de un solo objeto (GET /applications/{applicationId}?$select=keyCredentials o GET /servicePrincipals/{servicePrincipalId}?$select=keyCredentials); de lo contrario, siempre nulles . Desde un certificado .cer, puede leer la clave mediante el método Convert.ToBase64String(). Para obtener más información, consulte Obtener la clave de certificado. |
| keyId | Guid | El identificador único de la clave. |
| startDateTime | DateTimeOffset | La fecha y hora en que la credencial es válida. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| type | Cadena | El tipo de credencial clave; por ejemplo, Symmetric, , AsymmetricX509Certo X509CertAndPassword. |
| Uso | Cadena | Cadena que describe el propósito para el que se puede usar la clave; por ejemplo, None, Verify, PairwiseIdentifierEncryptDecryptHashedIdentifierDelegationSelfSignedTlso .Sign Si el uso es Sign, el tipo debe ser X509CertAndPasswordy se deben definir las passwordCredentials para firmar. |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.keyCredential",
"customKeyIdentifier": "Binary",
"displayName": "String",
"endDateTime": "String (timestamp)",
"key": "Binary",
"keyId": "Guid",
"startDateTime": "String (timestamp)",
"type": "String",
"usage": "String"
}