Requisito previo

Antes de comenzar a probar con la API de Certillion, son necesarios algunos requisitos previos:

• Obtener credenciales de acceso
• Tener un certificado ICP-Brasil válido para probar su integración o solicitar un certificado de prueba
• Instalar app Certillion si el certificado es tipo A1 (archivo) o A3 en soporte físico (tarjeta o token)

Las credenciales se pueden obtener en Contacto, solicitando una cuenta de prueba. Al solicitar una cuenta de prueba, debe enviar la siguiente información:

1. Nombre de la empresa
2. Nombre visible de la empresa (que aparecerá en la pantalla de autenticación del usuario)
3. CNPJ
4. Contacto técnico: nalgunos,correo electrónico, tteléfono

Información del sistema de autenticación

Para poder llamar a los métodos API de Certillion, primero debe autenticar el sistema que realizará las solicitudes. Con las credenciales proporcionadas (ver Pre- requisitos), autenticar utilizando el método:

Lista de certificados de nube admitidos

Certillion soporta todos los proveedores de certificados en la nube en ICP-Brasil (PSC – Proveedor de Servicios de Certificación).El servidor Certillion proporciona y actualiza automáticamente la lista completa de nombres de PSC tan pronto como se genera un nuevo Se agrega el tipo de certificado de nube.

El desarrollador puede utilizar esta lista para generar la interfaz de usuario, de modo que pueda identificar y utilizar fácilmente los certificados digitales a través de Certillion.

Ubicación del certificado

Utilizando la API también es posible localizar los certificados que tiene el usuario en la nube, en función del identificador legal que se quiera buscar.

Nota: Este método devolverá una lista cuyas entradas son los resultados de la búsqueda en cada uno de los PSC. Cada entrada en esta lista contendrá el identificador de PSC y un estado que indica si el usuario está certificado (estado=”S”). Si todas las entradas tienen estado=”N”, la única posibilidad que se ofrece al usuario es firmar usando la aplicación Certillion con certificados locales, A1 en archivo o A3 en soporte físico (tarjeta o token).

Autenticación de usuario (firmante)

Antes de firmar cualquier documento, el usuario deberá autorizar el acceso a su certificado digital.

Puedes otorgar autorización de tres maneras:

1. firma única: Proceso de firmar un único documento por vez.
2. firma por lotes: proceso de firma de varios documentos en un solo proceso.
3. creación de sesión de firma: proceso en el que se crea una sesión temporal para realizar tanto una firma única como firmas por lotes.

Firma de documentos

Siga los pasos descritos en el diagrama siguiente para firmar el documento.

¡Importante! Manejo correcto de errores

Si alguno de los 3 métodos anteriores utilizados en la firma falla, SÓLO repita la llamada a ese método:

• si el segundo método /signature falla, simplemente llame a este método,NOes necesario volver a cargar el archivo
• si el tercer método /document (get) falla, simplemente haga otra llamada para descargar el documento firmado, NOes necesario subir nuevamente o solicitar una nueva firma

Repetir solicitudes processadas s correctamente puede generar cargos adicionales para el sistema que solicita firmas.

Verificación de Firmas

Certillion verifica cualquier firma digital de ICP-Brasil, incluso si la firma fue realizada por un sistema externo. Para hacer esto, utilice la llamada /verify.

Sube el documento a firmar.

Para comprobar los posibles códigos de retorno de Certillion, consulte la API en línea en el método Códigos de estado devueltos por llamadas a Certillion

Optimización del secreto y rendimiento

Como se ve en el proceso de firma, debe enviar el documento a los servidores de Certillion para que sea firmado o verificado. Después de firmar, el documento también debe firmarse siguiendo las siguientes prácticas:

1. 1. ningún procesamiento excepto el necesario para procesar la firma digital;
   2. el documento se almacena cifrado en servidores;
   3. el documento permanece en los servidores un mínimo de 24 horas y un máximo de 48 horas para descargarse después de firmar, después de lo cual se elimina irreversiblemente.

A pesar de esto, cuando utilizan el servidor en la nube Certillion, es posible que algunos solicitantes prefieran no tener que enviar documentos a un servicio de terceros A través del componente Certillion Agent es posible preprocesar el documento en el entorno del solicitante, evitando la necesidad de cargar De manera similar, después de completar la firma, el sistema genera el documento firmado localmente. Este enfoque tiene las siguientes ventajas:

1. 1. 1. Cumplimiento de posibles normas de la empresa de no subcontratar documentos con información confidencial o privada;
      2. La firma es más rápida porque no es necesario transmitir documentos en ambas direcciones.
      3. No se requiere ningún cambio en el código de integración, Certillion Agent es un componente neutral de la red.

Después Para completar la integración de su sistema , solicite la instalación de la versión Certillion Agent en su entorno.

Certillion Signer

Los certificados digitales en la nube no requieren el uso de ninguna aplicación en el entorno del usuario que firme el documentos.El entorno del PSC, debidamente acreditado al efecto, procesa los certificados digitales de forma segura.

Cuando el usuario dispone de certificados digitales tradicionales (A1 en archivo o A3 en tarjeta o token) supone un grave fallo de seguridad solicitar que se le proporcione para su sistema. Esto puede invalidar la firma y generar responsabilidad legal para quien la recibió.

Para proteger el sistema que solicita la firma realizada con certificados tradicionales , se debe solicitar al usuario que utilice el firmante local de Certillion (consulte este enlace en el nuevo sitio web).Esta aplicación garantiza que genere la firma de forma segura y compatible 

Si desarrolló su sistema con Certillion API, no necesita cambiar el código de integración, ¡ya que ya es compatible con el firmante!

Otras grandes ventajas del firmante Certillion:

1. 1. 1. No se necesitan complementos para que funcione en sistemas web;
      2. Funciona en las principales plataformas: Windows, Mac, Android, iPhone, iPad y Linux;
      3. No tiene coste adicional, incluso se puede descargar gratis