---
title: "Comandos del CLI"
description: "Referencia completa y ejemplos de los comandos data, sign, verify y pfx export de nc-credentials."
canonical_url: "https://nodecfdi.com/packages/credentials/cli/commands"
---

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

A continuación se describen todas las opciones y ejemplos de los cuatro comandos disponibles en [`nc-credentials`](https://nodecfdi.com/packages/credentials/cli/overview).

## `data` (alias `info`)

Extrae información de un certificado X.509 (`.cer`, `.pem`) o archivo `.pfx`.

### Opciones de `data`

<table>
<thead>
  <tr>
    <th>
      Opción
    </th>
    
    <th>
      Descripción
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        -c, --cer <ruta>
      </code>
    </td>
    
    <td>
      Ruta al archivo de certificado (<code>
        .cer
      </code>
      
       / <code>
        .pem
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --pfx <ruta>
      </code>
    </td>
    
    <td>
      Ruta al archivo <code>
        .pfx
      </code>
      
       / <code>
        .p12
      </code>
      
       (alternativa a <code>
        --cer
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -p, --password <texto>
      </code>
    </td>
    
    <td>
      Contraseña del archivo <code>
        .pfx
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --password-file <ruta>
      </code>
    </td>
    
    <td>
      Archivo con la contraseña del <code>
        .pfx
      </code>
      
       (o usa <code>
        NODECFDI_PASSWORD
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -f, --field <campo>
      </code>
    </td>
    
    <td>
      Imprime únicamente el valor de un campo específico.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --json
      </code>
    </td>
    
    <td>
      Muestra toda la información estructurada en formato JSON.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -h, --help
      </code>
    </td>
    
    <td>
      Muestra la ayuda del comando.
    </td>
  </tr>
</tbody>
</table>

**Campos válidos para --field**:
`rfc`, `legal-name`, `serial-number`, `serial-number-hex`, `serial-number-decimal`, `type`, `branch-name`, `valid-from`, `valid-to`, `valid`, `issuer`, `version`, `pem`, `pem-one-line`.

### Ejemplos de `data`

```bash
# Resumen legible en consola
nc-credentials data --cer CSD01_AAA010101AAA.cer

# Salida completa en formato JSON
nc-credentials data --cer CSD01_AAA010101AAA.cer --json

# Obtener únicamente el RFC o el número de serie de 20 dígitos
nc-credentials data --cer CSD01_AAA010101AAA.cer --field rfc
nc-credentials data --cer CSD01_AAA010101AAA.cer --field serial-number

# Inspeccionar el certificado dentro de un archivo PFX
nc-credentials info --pfx credencial.pfx --password-file password.txt --json
```

---

## `sign`

Firma datos provenientes de un argumento de texto, un archivo o la entrada estándar (`stdin`) usando una llave privada o un archivo `.pfx`.

### Opciones de `sign`

<table>
<thead>
  <tr>
    <th>
      Opción
    </th>
    
    <th>
      Descripción
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        -k, --key <ruta>
      </code>
    </td>
    
    <td>
      Ruta a la llave privada (<code>
        .key
      </code>
      
       / <code>
        .pem
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -c, --cer <ruta>
      </code>
    </td>
    
    <td>
      Ruta al certificado (<code>
        .cer
      </code>
      
       / <code>
        .pem
      </code>
      
      ), opcional para validar que forme par con <code>
        --key
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --pfx <ruta>
      </code>
    </td>
    
    <td>
      Ruta al archivo <code>
        .pfx
      </code>
      
       / <code>
        .p12
      </code>
      
       (alternativa a <code>
        --key
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -p, --password <texto>
      </code>
    </td>
    
    <td>
      Contraseña de la llave privada o <code>
        .pfx
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --password-file <ruta>
      </code>
    </td>
    
    <td>
      Archivo con la contraseña (o variable <code>
        NODECFDI_PASSWORD
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -d, --data <texto>
      </code>
    </td>
    
    <td>
      Texto en UTF-8 a firmar.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -f, --file <ruta>
      </code>
    </td>
    
    <td>
      Archivo cuyo contenido se firmará byte a byte (si se omiten <code>
        --data
      </code>
      
       y <code>
        --file
      </code>
      
      , lee de <code>
        stdin
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -a, --algorithm <alg>
      </code>
    </td>
    
    <td>
      Algoritmo de firma: <code>
        sha256
      </code>
      
       (por defecto), <code>
        sha1
      </code>
      
      , <code>
        sha384
      </code>
      
      , <code>
        sha512
      </code>
      
      , <code>
        md5
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -e, --encoding <enc>
      </code>
    </td>
    
    <td>
      Codificación de salida: <code>
        base64
      </code>
      
       (por defecto), <code>
        hex
      </code>
      
      , <code>
        binary
      </code>
      
       (<code>
        binary
      </code>
      
       requiere <code>
        --output
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -o, --output <ruta>
      </code>
    </td>
    
    <td>
      Guarda la firma en un archivo con permisos <code>
        0600
      </code>
      
       (si se omite, imprime en <code>
        stdout
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --force
      </code>
    </td>
    
    <td>
      Permite sobrescribir el archivo indicado en <code>
        --output
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -h, --help
      </code>
    </td>
    
    <td>
      Muestra la ayuda del comando.
    </td>
  </tr>
</tbody>
</table>

### Ejemplos de `sign`

```bash
# Firmar una cadena original validando que el .cer y .key sean pareja (imprime Base64 en stdout)
nc-credentials sign \
  --cer CSD01_AAA010101AAA.cer \
  --key CSD01_AAA010101AAA.key \
  --password-file password.txt \
  --data "||4.0|A|1|2026-01-01T12:00:00||"

# Firmar un archivo y guardar la firma en disco
nc-credentials sign \
  --key CSD01_AAA010101AAA.key \
  --password-file password.txt \
  --file cadena-original.txt \
  --output firma.b64

# Firmar desde stdin usando un archivo PFX y algoritmo sha1 en formato hexadecimal
echo -n "texto a firmar" | nc-credentials sign \
  --pfx credencial.pfx \
  --password-file password.txt \
  --algorithm sha1 \
  --encoding hex
```

---

## `verify`

Verifica si una firma corresponde a los datos originales y al certificado, llave pública o archivo `.pfx`.

### Opciones de `verify`

<table>
<thead>
  <tr>
    <th>
      Opción
    </th>
    
    <th>
      Descripción
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        -c, --cer <ruta>
      </code>
    </td>
    
    <td>
      Ruta al certificado (<code>
        .cer
      </code>
      
       / <code>
        .pem
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --public-key <ruta>
      </code>
    </td>
    
    <td>
      Ruta a la llave pública (<code>
        .pem
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --pfx <ruta>
      </code>
    </td>
    
    <td>
      Ruta al archivo <code>
        .pfx
      </code>
      
       / <code>
        .p12
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -p, --password <texto>
      </code>
    </td>
    
    <td>
      Contraseña del archivo <code>
        .pfx
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --password-file <ruta>
      </code>
    </td>
    
    <td>
      Archivo con la contraseña del <code>
        .pfx
      </code>
      
       (o <code>
        NODECFDI_PASSWORD
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -d, --data <texto>
      </code>
    </td>
    
    <td>
      Texto original que fue firmado.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -f, --file <ruta>
      </code>
    </td>
    
    <td>
      Archivo con el contenido original (si se omiten <code>
        --data
      </code>
      
       y <code>
        --file
      </code>
      
      , lee de <code>
        stdin
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -s, --signature <firma>
      </code>
    </td>
    
    <td>
      Firma a verificar (en <code>
        base64
      </code>
      
       o <code>
        hex
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --signature-file <ruta>
      </code>
    </td>
    
    <td>
      Archivo que contiene la firma a verificar.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -a, --algorithm <alg>
      </code>
    </td>
    
    <td>
      Algoritmo de firma: <code>
        sha256
      </code>
      
       (por defecto), <code>
        sha1
      </code>
      
      , <code>
        sha384
      </code>
      
      , <code>
        sha512
      </code>
      
      , <code>
        md5
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -e, --encoding <enc>
      </code>
    </td>
    
    <td>
      Codificación de la firma: <code>
        base64
      </code>
      
       (por defecto), <code>
        hex
      </code>
      
      , <code>
        binary
      </code>
      
       (<code>
        binary
      </code>
      
       requiere <code>
        --signature-file
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -q, --quiet
      </code>
    </td>
    
    <td>
      No imprime mensaje en salida; solo devuelve código de salida (<code>
        0
      </code>
      
       válida, <code>
        1
      </code>
      
       inválida).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -h, --help
      </code>
    </td>
    
    <td>
      Muestra la ayuda del comando.
    </td>
  </tr>
</tbody>
</table>

### Ejemplos de `verify`

```bash
# Verificar una firma en Base64 contra un certificado y texto directo
nc-credentials verify \
  --cer CSD01_AAA010101AAA.cer \
  --data "||4.0|A|1|2026-01-01T12:00:00||" \
  --signature "<firma-en-base64>"

# Verificar un archivo contra un archivo de firma en modo silencioso (para scripts CI/bash)
nc-credentials verify \
  --cer CSD01_AAA010101AAA.cer \
  --file cadena-original.txt \
  --signature-file firma.b64 \
  --quiet
```

---

## `pfx export`

Exporta un certificado y su llave privada a un archivo PFX (PKCS#12) con permisos `0600`.

### Opciones de `pfx export`

<table>
<thead>
  <tr>
    <th>
      Opción
    </th>
    
    <th>
      Descripción
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        -c, --cer <ruta>
      </code>
    </td>
    
    <td>
      Ruta al certificado (<code>
        .cer
      </code>
      
       / <code>
        .pem
      </code>
      
      ) <strong>
        <span>
          requerido
        </span>
      </strong>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -k, --key <ruta>
      </code>
    </td>
    
    <td>
      Ruta a la llave privada (<code>
        .key
      </code>
      
       / <code>
        .pem
      </code>
      
      ) <strong>
        <span>
          requerido
        </span>
      </strong>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -p, --password <texto>
      </code>
    </td>
    
    <td>
      Contraseña de la llave privada.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --password-file <ruta>
      </code>
    </td>
    
    <td>
      Archivo con la contraseña de la llave privada (o <code>
        NODECFDI_PASSWORD
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --pfx-password <texto>
      </code>
    </td>
    
    <td>
      Contraseña del PFX generado (por defecto reutiliza la contraseña de la llave privada).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --pfx-password-file <ruta>
      </code>
    </td>
    
    <td>
      Archivo con la contraseña del PFX generado (o <code>
        NODECFDI_PFX_PASSWORD
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -o, --output <ruta>
      </code>
    </td>
    
    <td>
      Ruta del archivo <code>
        .pfx
      </code>
      
       de salida <strong>
        <span>
          requerido
        </span>
      </strong>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --force
      </code>
    </td>
    
    <td>
      Permite sobrescribir el archivo de salida si ya existe.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -a, --algorithm <alg>
      </code>
    </td>
    
    <td>
      Algoritmo de cifrado PFX: <code>
        aes128
      </code>
      
      , <code>
        aes192
      </code>
      
      , <code>
        aes256
      </code>
      
      , <code>
        3des
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        -h, --help
      </code>
    </td>
    
    <td>
      Muestra la ayuda del comando.
    </td>
  </tr>
</tbody>
</table>

### Ejemplos de `pfx export`

```bash
# Exportar usando la misma contraseña de la llave privada y cifrado aes256
nc-credentials pfx export \
  --cer CSD01_AAA010101AAA.cer \
  --key CSD01_AAA010101AAA.key \
  --password-file password.txt \
  --algorithm aes256 \
  --output credencial.pfx

# Exportar asignando una contraseña distinta al archivo PFX resultante
nc-credentials pfx export \
  --cer CSD01_AAA010101AAA.cer \
  --key CSD01_AAA010101AAA.key \
  --password-file key-pass.txt \
  --pfx-password-file pfx-pass.txt \
  --output credencial.pfx \
  --force
```

## Sitemap

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