Compartilhar 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 um aplicativo ou uma entidade de serviço. A propriedade keyCredentials das entidades servicePrincipal e aplicativo é uma coleção de keyCredential.

Para adicionar uma chaveCredential usando o Microsoft Graph, consulte Adicionar um certificado a um aplicativo usando o Microsoft Graph.

Propriedades

Propriedade Tipo Descrição
customKeyIdentifier Binário Um tipo binário de 40 caracteres que pode ser usado para identificar a credencial. Opcional. Quando não for fornecido na carga, o padrão é a impressão digital do certificado.
displayName Cadeia de caracteres Nome amigável para a chave. Opcional.
endDateTime DateTimeOffset A data e a 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ário Valor para a credencial de chave. Deve ser um valor codificado base64. Retornado apenas $select para um único objeto, ou seja, GET applications/{applicationId}?$select=keyCredentials ou GET servicePrincipals/{servicePrincipalId}?$select=keyCredentials; caso contrário, ele é sempre null.

Em um certificado .cer, você pode ler a chave usando o método Convert.ToBase64String(). Para obter mais informações, consulte Obter a chave de certificado.
keyId Guid O identificador exclusivo da chave.
startDateTime DateTimeOffset A data e a hora em que a credencial se torna válida. O tipo carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em tempo 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.
Uso Cadeia de caracteres Uma cadeia de caracteres que descreve a finalidade para a qual a chave pode ser usada; por exemplo, None, Verify, , PairwiseIdentifier, DecryptDelegation, Encrypt, HashedIdentifier, , SelfSignedTlsou Sign.

Se o uso for Sign, o tipo deverá ser X509CertAndPassworde as senhasCredentials para assinatura devem ser definidas.

Representação JSON

Veja a seguir uma representação JSON do recurso.

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