# VSSLCertificate

Esta clase representa un certificado lo que nos permite obtener información acerca de éste.

La función correspondiente a la clase [VSSLInfo](https://doc.velneo.com/24/velneo-vdevelop/scripts/lenguajes/javascript/clases/vsslinfo) nos permite acceder a los certificados de la conexión segura TLS/SSL establecida:

theApp.sslInfo().peerCertificateChain( nCertificado )

## Funciones

**Funciones**

| Retorno | Función                                          |
| ------- | ------------------------------------------------ |
| String  | [digest](#digest)( Number nAlgorithm )           |
| Date    | [effectiveDate](#effectivedate)()                |
| Date    | [expiryDate](#expirydate)()                      |
| Boolean | [isBlacklisted](#isblacklisted)()                |
| Boolean | [isNull](#isnull)()                              |
| String  | [issuerInfo](#issuerinfo)( String szAtributo )   |
| String  | [serialNumber](#serialnumber)()                  |
| Array   | [subjectInfo](#subjectinfo)( String szAtributo ) |
| String  | [toText](#totext)()                              |
| String  | [version](#version)()                            |

## Documentación de funciones

### Funciones <a href="#fnc" id="fnc"></a>

#### String digest( Number nAlgorithm ) <a href="#digest" id="digest"></a>

Devuelve un resumen o hash del certificado con el algoritmo que indiquemos como parámetro (por defecto MD5).

Parámetros:

* Algoritmo: ver enums de algoritmos en [VApp](https://doc.velneo.com/24/velneo-vdevelop/scripts/lenguajes/javascript/clases/vapp) (AlgoritmoHash).

#### Date effectiveDate() <a href="#effectivedate" id="effectivedate"></a>

Devuelve la fecha a partir de la que el certificado es válido.

#### Date expiryDate() <a href="#expirydate" id="expirydate"></a>

Devuelve la fecha a partir de la que el certificado deja de ser válido.

#### Boolean isBlacklisted() <a href="#isblacklisted" id="isblacklisted"></a>

Devuelve true si el certificado está en la lista negra en caso contrario devolverá false.

#### Boolean isNull() <a href="#isnull" id="isnull"></a>

Devuelve true si el certificado es nulo, es decir, un certificado sin contenido, en caso contrario, devuelve false.

#### String issuerInfo( String szAtributo ) <a href="#issuerinfo" id="issuerinfo"></a>

Devuelve un dato del certificado correspondiente a la información de generación, en función del parámetro indicado.

Parámetros:

* szAtributo: cadena que indica el dato correspondiente al certificado que queremos obtener. Ver siguiente lista:

"O": nombre de la organización.

"CN": nombre común. Normalmente es el nombre del host.

"L": localidad.

"OU": nombre de la unidad organizacional.

"C": país.

"ST": estado o provincia.

"emailAdress": correo electrónico.

#### String serialNumber() <a href="#serialnumber" id="serialnumber"></a>

Número de serie del certificado en formato hexadecimal.

#### Array subjectInfo( String szAtributo ) <a href="#subjectinfo" id="subjectinfo"></a>

Devuelve un array de cadenas con la información añadida al atributo que indicamos como parámetro.

Parámetros:

* szAtributo: cadena que indica el dato correspondiente al certificado que queremos obtener. Ver siguiente lista:

"O": nombre de la organización.

"CN": nombre común. Normalmente es el nombre del host.

"L": localidad.

"OU": nombre de la unidad organizacional.

"C": país.

"ST": estado o provincia.

"emailAdress": correo electrónico.

#### String toText() <a href="#totext" id="totext"></a>

Devuelve el certificado en una representación en texto legible.

#### String version() <a href="#version" id="version"></a>

Devuelve la versión del certificado.