---
title: "Certificate (Certificado)"
description: "Extrae RFC, razón social, número de serie, vigencia y metadatos de certificados X.509 del SAT."
canonical_url: "https://nodecfdi.com/packages/credentials/usage/certificate"
---

> Index of every page on this site: [llms.txt](https://nodecfdi.com/llms.txt)

La clase `Certificate` permite cargar y analizar certificados X.509 emitidos por el SAT (tanto CSD como eFirma/FIEL). Soporta automáticamente tres formatos de entrada:

- **X.509 DER binario** (el archivo `.cer` tal como lo descarga el contribuyente del SAT).
- **X.509 PEM** (con encabezados `-----BEGIN CERTIFICATE-----`).
- **X.509 DER codificado en Base64** (el contenido del atributo `Certificado` de un CFDI XML).

## Carga de un certificado

<code-group>

```ts [Desde archivo (Node.js)]
import { openCertificateFile } from '@nodecfdi/credentials/node';

const certificate = openCertificateFile('/ruta/al/certificado.cer');
```

```ts [Desde contenido en memoria]
import { Certificate } from '@nodecfdi/credentials';

// Puede ser cadena binaria DER, texto PEM o cadena Base64
const certificate = new Certificate(certificateContents);
```

</code-group>

## Datos del contribuyente y tipo de certificado

`Certificate` decodifica adecuadamente atributos en UTF-8 del `subject` y del `issuer`:

```ts [certificate-subject.ts]
console.log(certificate.rfc()); // "AAA010101AAA"
console.log(certificate.legalName()); // "ACCEM SERVICIOS EMPRESARIALES SC"
console.log(certificate.branchName()); // Nombre de sucursal/unidad (OU) o "" si es FIEL
console.log(certificate.name()); // "/CN=..."

// Identificar si es FIEL o CSD
console.log(certificate.satType().isFiel()); // boolean
console.log(certificate.satType().isCsd()); // boolean
```

<note>

El SAT distingue un CSD de una eFirma (FIEL) a través del atributo `OU` (*Organizational Unit* / `branchName`): los certificados de **FIEL** tienen `branchName() === ''`, mientras que los **CSD** incluyen el nombre de la unidad o sucursal.

</note>

## Vigencia del certificado

Puedes consultar el rango de validez del certificado como objetos nativos `Date` de JavaScript, como instancias `DateTime` de **Luxon**, o verificar si es válido en una fecha determinada:

```ts [certificate-validity.ts]
import { DateTime } from 'luxon';

// Objetos Date nativos
const fromDate: Date = certificate.validFrom();
const toDate: Date = certificate.validTo();

// Objetos DateTime de Luxon
const fromLuxon: DateTime = certificate.validFromDateTime();
const toLuxon: DateTime = certificate.validToDateTime();

// Verificar si el certificado está vigente en este instante (DateTime.now())
console.log('¿Vigente ahora?:', certificate.validOn());

// Verificar vigencia en una fecha específica
const customDate = DateTime.fromISO('2026-06-15T12:00:00Z');
console.log('¿Vigente en fecha?:', certificate.validOn(customDate));
```

## Número de serie

El método `serialNumber()` devuelve una instancia de [`SerialNumber`](https://nodecfdi.com/packages/credentials/api-reference/exports-and-types). En los certificados del SAT, el número de serie de 20 dígitos que se coloca en el atributo `NoCertificado` del CFDI corresponde a la representación ASCII (`bytes()`) del número de serie hexadecimal:

```ts [certificate-serial.ts]
const serial = certificate.serialNumber();

console.log(serial.bytes()); // "30001000000500003416" (NoCertificado de 20 dígitos)
console.log(serial.hexadecimal()); // "3330303031303030303030353030303033343136"
console.log(serial.decimal()); // "292233162870206001759766198425879490508935869462"
```

## Formato PEM y datos de X.509

Cuando necesitas insertar el certificado en un XML (por ejemplo, en el atributo `Certificado` de un CFDI o en un nodo `<ds:X509Certificate>`) o consultar datos del emisor:

```ts [certificate-pem-issuer.ts]
// Contenido PEM completo (con encabezados -----BEGIN CERTIFICATE-----)
const pem = certificate.pem();

// Contenido PEM en una sola línea sin encabezados (ideal para atributo Certificado en CFDI)
const oneLine = certificate.pemAsOneLine();

// Cadena del emisor formateada conforme al estándar RFC 4514 (útil para XML-DSig / XAdES)
const issuerRfc4514 = certificate.issuerAsRfc4514();

// Llave pública asociada al certificado
const publicKey = certificate.publicKey();
```

### Otros métodos de inspección X.509

<table>
<thead>
  <tr>
    <th>
      Método
    </th>
    
    <th>
      Retorno
    </th>
    
    <th>
      Descripción
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        version()
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      Versión del certificado X.509.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        hash()
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      Hash del emisor (<code>
        issuer.hash
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        signatureTypeLN()
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      Identificador de la firma del certificado.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        subject()
      </code>
    </td>
    
    <td>
      <code>
        forge.pki.Certificate['subject']
      </code>
    </td>
    
    <td>
      Objeto <code>
        subject
      </code>
      
       completo de <code>
        node-forge
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        subjectData(key)
      </code>
    </td>
    
    <td>
      <code>
        forge.pki.CertificateField | undefined
      </code>
    </td>
    
    <td>
      Busca un campo del <code>
        subject
      </code>
      
       por nombre corto (<code>
        'CN'
      </code>
      
      , <code>
        'OU'
      </code>
      
      ) u opciones <code>
        { type: '2.5.4.45' }
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        issuer()
      </code>
    </td>
    
    <td>
      <code>
        forge.pki.Certificate['issuer']
      </code>
    </td>
    
    <td>
      Objeto <code>
        issuer
      </code>
      
       completo de <code>
        node-forge
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        issuerData(key)
      </code>
    </td>
    
    <td>
      <code>
        forge.pki.CertificateField
      </code>
    </td>
    
    <td>
      Busca un campo del <code>
        issuer
      </code>
      
       por nombre corto u OID.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        validity()
      </code>
    </td>
    
    <td>
      <code>
        { notBefore: Date, notAfter: Date }
      </code>
    </td>
    
    <td>
      Objeto crudo de validez del certificado.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        extensions()
      </code>
    </td>
    
    <td>
      <code>
        Record<string, unknown>[]
      </code>
    </td>
    
    <td>
      Arreglo de extensiones X.509 del certificado.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        parsed()
      </code>
    </td>
    
    <td>
      <code>
        Record<string, unknown>
      </code>
    </td>
    
    <td>
      Estructura interna con todos los campos extraídos.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        Certificate.convertDerToPem(contents)
      </code>
    </td>
    
    <td>
      <code>
        string
      </code>
    </td>
    
    <td>
      Método estático que convierte contenido DER binario o DER Base64 a formato PEM.
    </td>
  </tr>
</tbody>
</table>

## Sitemap

See the full [sitemap](https://nodecfdi.com/sitemap.md) for all pages.
