SatCredentialsNet 1.0.0

SatCredentialsNet

SatCredentialsNet es una librería .NET para trabajar con certificados del SAT (Servicio de Administración Tributaria) de México, incluyendo certificados CSD (Certificado de Sello Digital) y FIEL/e.firma.

Soporta carga, validación, extracción de datos, encriptación, firma digital y exportación de claves. Compatible con .NET 8, 9, 10 sobre Windows, Linux y macOS.

Características

• Carga de certificados .cer y llaves privadas .key (PKCS#8 DER encriptado) desde archivos, bytes o streams.
• Validaciones automáticas al inicializar:
  • Vigencia del certificado.
  • Correspondencia entre certificado y llave privada.
  • Emisor: Servicio de Administración Tributaria (SAT).
• Extracción de datos del certificado:
  • RFC, RFC del representante legal (personas morales).
  • CURP, CURP del representante legal.
  • Razón social, nombre de sucursal, email y número de serie.
  • Tipo de persona (física o moral) y tipo de certificado (CSD o FIEL).
• Operaciones criptográficas:
  • Firma y verificación con SHA256 y SHA1.
  • Encriptación y desencriptación RSA PKCS#1.
• Exportación de claves y certificados en múltiples formatos: PEM, DER, Base64, PKCS#8, PFX.

Instalación

dotnet add package SatCredentialsNet

Uso básico

using SatCredentialsNet;
using System.Text;

// Desde archivos
using var credentials = new SatCredentials("cert.cer", "private_key.key", "contraseña");

// Desde bytes
var cerBytes = File.ReadAllBytes("cert.cer");
var keyBytes = File.ReadAllBytes("private_key.key");
using var credentials = new SatCredentials(cerBytes, keyBytes, "contraseña");

// Desde streams
using var cerStream = File.OpenRead("cert.cer");
using var keyStream = File.OpenRead("private_key.key");
using var credentials = new SatCredentials(cerStream, keyStream, "contraseña");

// Datos del contribuyente
Console.WriteLine($"RFC:          {credentials.Rfc}");
Console.WriteLine($"Razón social: {credentials.RazonSocial}");
Console.WriteLine($"Tipo:         {credentials.TipoCertificado}"); // CSD o FIEL
Console.WriteLine($"Persona:      {credentials.TipoPersona}");     // FISICA o MORAL
Console.WriteLine($"Vigente:      {credentials.IsInForce}");
Console.WriteLine($"Válido hasta: {credentials.ValidTo:yyyy-MM-dd}");

Nota: SatCredentials implementa IDisposable. Usa using o llama a Dispose() para liberar correctamente los recursos criptográficos.

Constructores

En todos los casos se valida automáticamente que:

1. El certificado sea legible y con formato válido.
2. La contraseña sea correcta y la llave privada sea descifrable.
3. La llave privada corresponda al certificado.
4. El certificado esté vigente.
5. El emisor sea el SAT.

Propiedades

Datos del contribuyente

Datos del certificado

Claves y exportaciones

Métodos

Encriptación / Desencriptación

byte[] Encrypt(byte[] data)
byte[] Decrypt(byte[] data)

Usa RSA con padding PKCS#1. La encriptación se realiza con la clave pública y la desencriptación con la clave privada.

var data = Encoding.UTF8.GetBytes("Datos confidenciales");
var encrypted = credentials.Encrypt(data);
var decrypted = credentials.Decrypt(encrypted);

Firma digital

byte[] SingSHA256(byte[] data)
byte[] SingSHA1(byte[] data)

Firma los datos con la clave privada usando PKCS#1 y el algoritmo indicado. SHA256 es el estándar requerido para la generación de sellos digitales en CFDI.

var cadena = Encoding.UTF8.GetBytes("||cadena original||");
var sello = credentials.SingSHA256(cadena);
var selloBase64 = Convert.ToBase64String(sello);

Verificación de firma

bool VerifySHA256(byte[] data, byte[] signature)
bool VerifySHA1(byte[] data, byte[] signature)

Verifica que la firma corresponda a los datos usando la clave pública.

var esValido = credentials.VerifySHA256(cadena, sello);
Console.WriteLine($"Firma válida: {esValido}");

Manejo de errores

Todas las excepciones lanzadas por la librería son del tipo SatCredentialsError, que extiende Exception e incluye un código de error tipado.

try
{
    using var credentials = new SatCredentials(cerBytes, keyBytes, password);
}
catch (SatCredentialsError ex)
{
    Console.WriteLine($"Error {ex.ErrorCode}: {ex.Message}");
    // Ejemplo: "[1007] CertificateExpired: The certificate is expired."
}

Códigos de error

Enumeraciones

SatCredentialsConstants.CertificateType

SatCredentialsConstants.TaxpayerType

Ejemplo completo: Generar sello para CFDI

using SatCredentialsNet;
using System.Text;

using var credentials = new SatCredentials(
    "/ruta/al/certificado.cer",
    "/ruta/a/la/llave.key",
    "contraseña_llave"
);

Console.WriteLine($"RFC:             {credentials.Rfc}");
Console.WriteLine($"Tipo:            {credentials.TipoCertificado}");
Console.WriteLine($"No. Certificado: {credentials.SerialNumber}");
Console.WriteLine($"Certificado:     {credentials.CertificateB64}");

// Generar sello digital SHA256
var cadenaOriginal = "||cadena original del CFDI||";
var selloBytes = credentials.SingSHA256(Encoding.UTF8.GetBytes(cadenaOriginal));
var sello = Convert.ToBase64String(selloBytes);

Console.WriteLine($"Sello: {sello}");

Requisitos

• Certificado en formato DER (.cer binario descargado del SAT, no PEM).
• Llave privada en formato PKCS#8 DER encriptado (.key binario descargado del SAT).

Compatibilidad

Plataformas: Windows, Linux, macOS.

Licencia

Este proyecto está bajo la licencia MIT.