X509CertSelector.AddSubjectAlternativeName Método

Definição

Namespace:

Java.Security.Cert

Assembly:

Mono.Android.dll

Sobrecargas

AddSubjectAlternativeName(Int32, Byte[])	Adiciona um nome ao critério subjectAlternativeNames.
AddSubjectAlternativeName(Int32, String)	Adiciona um nome ao critério subjectAlternativeNames.

AddSubjectAlternativeName(Int32, Byte[])

Adiciona um nome ao critério subjectAlternativeNames.

[Android.Runtime.Register("addSubjectAlternativeName", "(I[B)V", "GetAddSubjectAlternativeName_IarrayBHandler")]
public virtual void AddSubjectAlternativeName (int type, byte[]? name);

[<Android.Runtime.Register("addSubjectAlternativeName", "(I[B)V", "GetAddSubjectAlternativeName_IarrayBHandler")>]
abstract member AddSubjectAlternativeName : int * byte[] -> unit
override this.AddSubjectAlternativeName : int * byte[] -> unit

Parâmetros

type

Int32

o tipo de nome (0-8, conforme listado acima)

name

Byte[]

uma matriz de bytes que contém o nome no formato codificado ASN.1 DER

Atributos

RegisterAttribute

Exceções

IOException

se a decodificação do nome falhar.

Comentários

Adiciona um nome ao critério subjectAlternativeNames. O X509Certificate deve conter todos ou pelo menos um dos subjectAlternativeNames especificados, dependendo do valor do sinalizador matchAllNames (consulte #setMatchAllSubjectAltNames setMatchAllSubjectAltNames).

Esse método permite que o chamador adicione um nome ao conjunto de nomes alternativos de entidade. O nome especificado é adicionado a qualquer valor anterior para o critério subjectAlternativeNames. Se o nome especificado for uma duplicata, ele poderá ser ignorado.

O nome é fornecido como uma matriz de bytes. Essa matriz de bytes deve conter o nome codificado por DER, como apareceria na estrutura GeneralName definida em RFC 5280 e X.509. A matriz de bytes codificados deve conter apenas o valor codificado do nome e não deve incluir a marca associada ao nome na estrutura GeneralName. A definição ASN.1 dessa estrutura aparece abaixo.

{@code
             GeneralName ::= CHOICE {
                  otherName                       [0]     OtherName,
                  rfc822Name                      [1]     IA5String,
                  dNSName                         [2]     IA5String,
                  x400Address                     [3]     ORAddress,
                  directoryName                   [4]     Name,
                  ediPartyName                    [5]     EDIPartyName,
                  uniformResourceIdentifier       [6]     IA5String,
                  iPAddress                       [7]     OCTET STRING,
                  registeredID                    [8]     OBJECT IDENTIFIER}
            }

Observe que a matriz de bytes fornecida aqui é clonada para proteger contra modificações subsequentes.

Documentação Java para java.security.cert.X509CertSelector.addSubjectAlternativeName(int, byte[]).

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

AddSubjectAlternativeName(Int32, String)

Adiciona um nome ao critério subjectAlternativeNames.

[Android.Runtime.Register("addSubjectAlternativeName", "(ILjava/lang/String;)V", "GetAddSubjectAlternativeName_ILjava_lang_String_Handler")]
public virtual void AddSubjectAlternativeName (int type, string? name);

[<Android.Runtime.Register("addSubjectAlternativeName", "(ILjava/lang/String;)V", "GetAddSubjectAlternativeName_ILjava_lang_String_Handler")>]
abstract member AddSubjectAlternativeName : int * string -> unit
override this.AddSubjectAlternativeName : int * string -> unit

Parâmetros

type

Int32

o tipo de nome (0-8, conforme especificado na RFC 5280, seção 4.2.1.6)

name

String

o nome em forma de cadeia de caracteres (não null)

Atributos

RegisterAttribute

Exceções

IOException

se a análise do nome falhar.

Comentários

Adiciona um nome ao critério subjectAlternativeNames. O X509Certificate deve conter todos ou pelo menos um dos subjectAlternativeNames especificados, dependendo do valor do sinalizador matchAllNames (consulte #setMatchAllSubjectAltNames setMatchAllSubjectAltNames).

Esse método permite que o chamador adicione um nome ao conjunto de nomes alternativos de entidade. O nome especificado é adicionado a qualquer valor anterior para o critério subjectAlternativeNames. Se o nome especificado for uma duplicata, ele poderá ser ignorado.

O nome é fornecido no formato de cadeia de caracteres. Os nomes RFC 822, DNS e URI usam os formatos de cadeia de caracteres bem estabelecidos para esses tipos (sujeito às restrições incluídas na RFC 5280). Os nomes de endereços IPv4 são fornecidos usando notação quádrupla pontilhada. Os nomes de endereços OID são representados como uma série de inteiros não negativos separados por pontos. E os nomes de diretório (nomes distintos) são fornecidos no formato RFC 2253. Nenhum formato de cadeia de caracteres padrão é definido para otherNames, nomes X.400, nomes de partes EDI, nomes de endereços IPv6 ou qualquer outro tipo de nomes. Eles devem ser especificados usando o #addSubjectAlternativeName(int type, byte [] name) addSubjectAlternativeName(int type, byte [] name) método.

<strong>Nota:</strong> para nomes distintos, use #addSubjectAlternativeName(int, byte[]) em vez disso. Esse método não deve ser invocado, pois ele pode falhar ao corresponder a alguns certificados devido a uma perda de informações de codificação no formulário RFC 2253 String de alguns nomes distintos.

Documentação Java para java.security.cert.X509CertSelector.addSubjectAlternativeName(int, java.lang.String).

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