Partilhar via


tipo de recurso keyCredential

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Contém uma credencial de chave associada a uma aplicação ou a um principal de serviço. A propriedade keyCredentials das entidadesapplication e servicePrincipal é uma coleção de keyCredential.

Para adicionar um keyCredential com o Microsoft Graph, consulte Adicionar um certificado a uma aplicação com o Microsoft Graph.

Propriedades

Propriedade Tipo Descrição
customKeyIdentifier Binária Um tipo binário de 40 carateres que pode ser utilizado para identificar a credencial. Opcional. Quando não for fornecido no payload, a predefinição é o thumbprint do certificado.
displayName Cadeia de caracteres O nome amigável da chave, com um comprimento máximo de 90 carateres. Os valores mais longos são aceites, mas encurtados. Opcional.
endDateTime DateTimeOffset A data e hora em que a credencial expira. O tipo DateTimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
chave Binária Valor da credencial da chave. Deve ser um valor codificado em Base64. Devolvido apenas para $select um único objeto, ou seja, GET applications/{applicationId}?$select=keyCredentials ou GET servicePrincipals/{servicePrincipalId}?$select=keyCredentialsseja, é sempre null.

A partir de um certificado .cer , pode ler a chave com o método Convert.ToBase64String( ). Para obter mais informações, veja Obter a chave de certificado.
keyId Guid O identificador exclusivo da chave.
startDateTime DateTimeOffset A data e hora em que a credencial se torna válida. O tipo carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre na hora UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
type Cadeia de caracteres O tipo de credencial de chave; por exemplo, Symmetric, AsymmetricX509Certou X509CertAndPassword.
utilização Cadeia de caracteres Uma cadeia que descreve a finalidade para a qual a chave pode ser utilizada; por exemplo, None, Verify, PairwiseIdentifier, Delegation, Decrypt, Encrypt, , HashedIdentifier, ou SignSelfSignedTls.

Se a utilização for Sign, o tipo deve ser X509CertAndPassworde a palavra-passeCredentials para assinatura deve ser definida.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o 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"
}