# 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/30/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 );
```

## Indice de funciones

### **Generales**

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 generales <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/30/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.