# 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/29/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/29/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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.velneo.com/29/velneo-vdevelop/scripts/lenguajes/javascript/clases/vsslcertificate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.