X509CertSelector.AddSubjectAlternativeName Método

Definición

Espacio de nombres:

Java.Security.Cert

Ensamblado:

Mono.Android.dll

Sobrecargas

AddSubjectAlternativeName(Int32, Byte[])	Agrega un nombre al criterio subjectAlternativeNames.
AddSubjectAlternativeName(Int32, String)	Agrega un nombre al criterio subjectAlternativeNames.

AddSubjectAlternativeName(Int32, Byte[])

Agrega un nombre al criterio 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

el tipo de nombre (0-8, como se indicó anteriormente)

name

Byte[]

matriz de bytes que contiene el nombre en formato codificado de DER de ASN.1

Atributos

RegisterAttribute

Excepciones

IOException

si se produce un error en la descodificación del nombre.

Comentarios

Agrega un nombre al criterio subjectAlternativeNames. X509Certificate debe contener todos o al menos uno de los subjectAlternativeNames especificados, en función del valor de la marca matchAllNames (vea #setMatchAllSubjectAltNames setMatchAllSubjectAltNames).

Este método permite al autor de la llamada agregar un nombre al conjunto de nombres alternativos del firmante. El nombre especificado se agrega a cualquier valor anterior para el criterio subjectAlternativeNames. Si el nombre especificado es un duplicado, se puede omitir.

El nombre se proporciona como una matriz de bytes. Esta matriz de bytes debe contener el nombre codificado de DER, como aparecería en la estructura GeneralName definida en RFC 5280 y X.509. La matriz de bytes codificada solo debe contener el valor codificado del nombre y no debe incluir la etiqueta asociada al nombre en la estructura GeneralName. La definición asn.1 de esta estructura aparece a continuación.

{@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}
            }

Tenga en cuenta que la matriz de bytes proporcionada aquí se clona para protegerse frente a modificaciones posteriores.

Documentación de Java para java.security.cert.X509CertSelector.addSubjectAlternativeName(int, byte[]).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

AddSubjectAlternativeName(Int32, String)

Agrega un nombre al criterio 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

el tipo de nombre (0-8, como se especifica en RFC 5280, sección 4.2.1.6)

name

String

el nombre en forma de cadena (no null)

Atributos

RegisterAttribute

Excepciones

IOException

si se produce un error en el análisis del nombre.

Comentarios

Agrega un nombre al criterio subjectAlternativeNames. X509Certificate debe contener todos o al menos uno de los subjectAlternativeNames especificados, en función del valor de la marca matchAllNames (vea #setMatchAllSubjectAltNames setMatchAllSubjectAltNames).

Este método permite al autor de la llamada agregar un nombre al conjunto de nombres alternativos del firmante. El nombre especificado se agrega a cualquier valor anterior para el criterio subjectAlternativeNames. Si el nombre especificado es un duplicado, se puede omitir.

El nombre se proporciona en formato de cadena. Los nombres de RFC 822, DNS y URI usan los formatos de cadena bien establecidos para esos tipos (sujetos a las restricciones incluidas en RFC 5280). Los nombres de dirección IPv4 se proporcionan mediante la notación cuádruple de puntos. Los nombres de direcciones OID se representan como una serie de enteros no negativo separados por puntos. Y los nombres de directorio (nombres distintivos) se proporcionan en formato RFC 2253. No se define ningún formato de cadena estándar para otros nombres, nombres X.400, nombres de entidad EDI, nombres de direcciones IPv6 o cualquier otro tipo de nombres. Deben especificarse mediante el #addSubjectAlternativeName(int type, byte [] name) addSubjectAlternativeName(int type, byte [] name) método .

<strong>Note:</strong> para nombres distintivos, use #addSubjectAlternativeName(int, byte[]) en su lugar. Este método no debe basarse en , ya que puede no coincidir con algunos certificados debido a una pérdida de información de codificación en el formato de cadena RFC 2253 de algunos nombres distintivos.

Documentación de Java para java.security.cert.X509CertSelector.addSubjectAlternativeName(int, java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.