Idioma

KeyGenParameterSpec.Builder.SetAttestationChallenge(Byte[]) Método

Definição

Define se um certificado de atestado será gerado para esse par de chaves e qual valor de desafio será colocado no certificado.

[Android.Runtime.Register("setAttestationChallenge", "([B)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=24)]
public Android.Security.Keystore.KeyGenParameterSpec.Builder SetAttestationChallenge(byte[]? attestationChallenge);
[<Android.Runtime.Register("setAttestationChallenge", "([B)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=24)>]
member this.SetAttestationChallenge : byte[] -> Android.Security.Keystore.KeyGenParameterSpec.Builder

Parâmetros

attestationChallenge
Byte[]

Retornos

Atributos

Comentários

Define se um certificado de atestado será gerado para esse par de chaves e qual valor de desafio será colocado no certificado. A cadeia de certificados de atestado pode ser recuperada com java.security.KeyStore.getCertificateChain(String).

Se atestadoChallenge não for nulo, o certificado de chave pública para esse par de chaves conterá uma extensão que descreve os detalhes da configuração e das autorizações da chave, incluindo o valor de atestadoChallenge. Se a chave estiver em hardware seguro e se o hardware seguro der suporte ao atestado, o certificado será assinado por uma cadeia de certificados com raiz em uma chave de AC confiável. Caso contrário, a cadeia terá raiz em um certificado não confiável.

A finalidade do valor do desafio é permitir que as partes confiáveis verifiquem se a chave foi criada em resposta a uma solicitação específica. Se o atestado for desejado, mas nenhum desafio for necessário, qualquer valor não nulo poderá ser usado, incluindo uma matriz de bytes vazia.

Se atestadoChallenge for nulo e essa especificação for usada para gerar um par de chaves assimétrica (RSA ou EC), o certificado de chave pública será autoassinado se a chave tiver uma finalidade KeyProperties.PURPOSE_SIGN. Se a chave não tiver uma finalidade KeyProperties.PURPOSE_SIGN, não será possível usar a chave para assinar um certificado, portanto, o certificado de chave pública conterá uma assinatura de espaço reservado.

Chaves simétricas, como chaves AES e HMAC, não têm certificados de chave pública.

O desafio pode ser de até 128 bytes.

Referência do Android para android.security.keystore.KeyGenParameterSpec.Builder.setAttestationChallenge.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a