---
title: "Introducción al CLI"
description: "Utiliza la herramienta de línea de comandos nc-credentials para inspeccionar, firmar, verificar y exportar certificados."
canonical_url: "https://nodecfdi.com/packages/credentials/cli/overview"
---

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

Al instalar `@nodecfdi/credentials` se incluye el ejecutable **nc-credentials**, que te permite trabajar con archivos CSD, eFirma (FIEL) y PFX directamente desde la terminal o en scripts de automatización sin escribir código JavaScript.

## Ejecución

Puedes invocarlo mediante `npx`, `pnpm dlx` o directamente si el paquete está instalado en tu proyecto o de forma global:

```bash
nc-credentials --help
nc-credentials --version
```

## Resumen de comandos

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

<tbody>
  <tr>
    <td>
      <code>
        data
      </code>
      
       (alias <code>
        info
      </code>
      
      )
    </td>
    
    <td>
      Extrae información de un certificado (<code>
        .cer
      </code>
      
      , <code>
        .pem
      </code>
      
      ) o archivo <code>
        .pfx
      </code>
      
       (en texto, JSON o un campo individual).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        sign
      </code>
    </td>
    
    <td>
      Firma texto, un archivo o <code>
        stdin
      </code>
      
       usando una llave privada (<code>
        .key
      </code>
      
      , <code>
        .pem
      </code>
      
      ) o archivo <code>
        .pfx
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        verify
      </code>
    </td>
    
    <td>
      Verifica una firma contra un certificado, llave pública o archivo <code>
        .pfx
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        pfx export
      </code>
    </td>
    
    <td>
      Empaqueta y exporta un certificado y llave privada a un archivo <code>
        .pfx
      </code>
      
       (PKCS#12).
    </td>
  </tr>
</tbody>
</table>

Consulta los detalles y opciones de cada comando en la página [Comandos del CLI](https://nodecfdi.com/packages/credentials/cli/commands).

## Manejo seguro de contraseñas

El CLI ofrece tres mecanismos para proporcionar contraseñas de llaves privadas o archivos PFX (en orden de recomendación):

1. **Archivo de contraseña (--password-file / --pfx-password-file)**: Lee la contraseña desde un archivo (eliminando saltos de línea finales `\r` o `\n`).
2. **Variables de entorno (NODECFDI_PASSWORD / NODECFDI_PFX_PASSWORD)**: Define la contraseña en el entorno sin exponerla en los argumentos del comando.
3. **Argumento directo (-p, --password / --pfx-password)**: Pasa la contraseña en la línea de comandos.

<warning>

El uso de `--password` o `--pfx-password` expone la contraseña en la lista de procesos del sistema operativo y en el historial del shell. Cuando los utilizas, el CLI emite una advertencia en `stderr` recomendando usar `--password-file` o `NODECFDI_PASSWORD`.

</warning>

## Seguridad en archivos de salida y validación

- **Permisos restringidos (0600)**: Todos los archivos creados mediante `--output` (tanto firmas como archivos `.pfx`) se escriben con permisos `0600` (lectura y escritura únicamente para el propietario).
- **Protección contra sobrescritura**: Por defecto, `--output` falla si el archivo destino ya existe. Usa la bandera `--force` cuando desees permitir que se sobrescriba.
- **Validación estricta de argumentos**: Cualquier opción desconocida, repetida, vacía, argumento posicional sobrante o combinación inválida detiene inmediatamente la ejecución antes de realizar operaciones criptográficas.

## Códigos de salida

<table>
<thead>
  <tr>
    <th>
      Código
    </th>
    
    <th>
      Significado
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        0
      </code>
    </td>
    
    <td>
      Ejecución exitosa (o firma válida en <code>
        verify
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        1
      </code>
    </td>
    
    <td>
      Error durante la ejecución (archivo no encontrado, contraseña incorrecta) o firma <strong>
        inválida
      </strong>
      
       en <code>
        verify
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        2
      </code>
    </td>
    
    <td>
      Error de validación en los argumentos u opciones de la línea de comandos.
    </td>
  </tr>
</tbody>
</table>

## Sitemap

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