{"id":9083,"date":"2024-04-07T21:27:50","date_gmt":"2024-04-07T21:27:50","guid":{"rendered":"https:\/\/certillion.com\/api\/tutoriales\/"},"modified":"2024-12-17T16:03:39","modified_gmt":"2024-12-17T16:03:39","slug":"tutoriales","status":"publish","type":"page","link":"https:\/\/certillion.com\/es\/api\/tutoriales\/","title":{"rendered":"Tutoriales"},"content":{"rendered":"\t\t<div data-elementor-type=\"wp-page\" data-elementor-id=\"9083\" class=\"elementor elementor-9083 elementor-3246\" data-elementor-post-type=\"page\">\n\t\t\t\t\t\t<section class=\"elementor-section elementor-top-section elementor-element elementor-element-893797c elementor-section-boxed elementor-section-height-default elementor-section-height-default wpr-particle-no wpr-jarallax-no wpr-parallax-no wpr-sticky-section-no\" data-id=\"893797c\" data-element_type=\"section\">\n\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-no\">\n\t\t\t\t\t<div class=\"aux-parallax-section elementor-column elementor-col-100 elementor-top-column elementor-element elementor-element-02470b5\" data-id=\"02470b5\" data-element_type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<div class=\"elementor-element elementor-element-9e2c601 elementor-widget__width-initial elementor-widget elementor-widget-aux_modern_heading\" data-id=\"9e2c601\" data-element_type=\"widget\" data-widget_type=\"aux_modern_heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t<section class=\"aux-widget-modern-heading\">\n            <div class=\"aux-widget-inner\"><h5 class=\"aux-modern-heading-primary\">Documentaci\u00f3n<\/h5><div class=\"aux-modern-heading-divider\"><\/div><h4 class=\"aux-modern-heading-secondary\"><span class=\"aux-head-before\">Tutoriales<\/span><\/h4><\/div>\n        <\/section>\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t<div class=\"elementor-element elementor-element-1d17512 e-flex e-con-boxed wpr-particle-no wpr-jarallax-no wpr-parallax-no wpr-sticky-section-no e-con e-parent\" data-id=\"1d17512\" data-element_type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t<div class=\"elementor-element elementor-element-d9e4292 e-con-full e-flex wpr-particle-no wpr-jarallax-no wpr-parallax-no wpr-sticky-section-no e-con e-child\" data-id=\"d9e4292\" data-element_type=\"container\">\n\t\t\t\t<div class=\"aux-sticky-piece elementor-element elementor-element-7ee8b07 elementor-toc--minimized-on-tablet elementor-widget elementor-widget-table-of-contents\" data-boundaries=\"1\" data-use-transform=\"1\" data-sticky-margin=\"30\" data-sticky-off=\"\" data-id=\"7ee8b07\" data-element_type=\"widget\" data-settings=\"{&quot;headings_by_tags&quot;:[&quot;h1&quot;],&quot;exclude_headings_by_selector&quot;:[],&quot;marker_view&quot;:&quot;numbers&quot;,&quot;minimize_box&quot;:&quot;yes&quot;,&quot;minimized_on&quot;:&quot;tablet&quot;,&quot;hierarchical_view&quot;:&quot;yes&quot;,&quot;min_height&quot;:{&quot;unit&quot;:&quot;px&quot;,&quot;size&quot;:&quot;&quot;,&quot;sizes&quot;:[]},&quot;min_height_tablet&quot;:{&quot;unit&quot;:&quot;px&quot;,&quot;size&quot;:&quot;&quot;,&quot;sizes&quot;:[]},&quot;min_height_mobile&quot;:{&quot;unit&quot;:&quot;px&quot;,&quot;size&quot;:&quot;&quot;,&quot;sizes&quot;:[]}}\" data-widget_type=\"table-of-contents.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<div class=\"elementor-toc__header\">\n\t\t\t<h4 class=\"elementor-toc__header-title\">\n\t\t\t\tTutoriales\t\t\t<\/h4>\n\t\t\t\t\t\t\t<div class=\"elementor-toc__toggle-button elementor-toc__toggle-button--expand\" role=\"button\" tabindex=\"0\" aria-controls=\"elementor-toc__7ee8b07\" aria-expanded=\"true\" aria-label=\"Open table of contents\"><i aria-hidden=\"true\" class=\"fas fa-chevron-down\"><\/i><\/div>\n\t\t\t\t<div class=\"elementor-toc__toggle-button elementor-toc__toggle-button--collapse\" role=\"button\" tabindex=\"0\" aria-controls=\"elementor-toc__7ee8b07\" aria-expanded=\"true\" aria-label=\"Close table of contents\"><i aria-hidden=\"true\" class=\"fas fa-chevron-up\"><\/i><\/div>\n\t\t\t\t\t<\/div>\n\t\t<div id=\"elementor-toc__7ee8b07\" class=\"elementor-toc__body\">\n\t\t\t<div class=\"elementor-toc__spinner-container\">\n\t\t\t\t<i class=\"elementor-toc__spinner eicon-animation-spin eicon-loading\" aria-hidden=\"true\"><\/i>\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-13d569a e-con-full e-flex wpr-particle-no wpr-jarallax-no wpr-parallax-no wpr-sticky-section-no e-con e-child\" data-id=\"13d569a\" data-element_type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-b7cec54 elementor-widget elementor-widget-text-editor\" data-id=\"b7cec54\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<h1>Requisito previo<\/h1><p><span style=\"font-weight: 400;\">Antes de comenzar a probar con la API de Certillion, son necesarios algunos requisitos previos:<\/span><\/p><ul><li aria-level=\"1\"><span style=\"font-weight: 400;\">Obtener credenciales de acceso<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Tener un certificado ICP-Brasil v\u00e1lido para probar su integraci\u00f3n o solicitar un certificado de prueba<\/span><\/li><li style=\"peso de fuente: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Instalar <\/span><a href=\"http:\/\/download.certillion.com\/\"><span style=\"font - peso: 400;\">app Certillion<\/span><\/a><span style=\"font-weight: 400;\"> si el certificado es tipo A1 (archivo) o A3 en soporte f\u00edsico (tarjeta o token)<\/span><\/li><\/ul><p><span style=\"font-weight: 400;\">Las credenciales se pueden obtener en <\/span><a href=\"https:\/\/certillion.com\/es\/contactar\/\"><span style=\"font-weight: 400;\">Contacto,<\/span><\/a><span style=\"font-weight: 400;\">\u00a0solicitando una cuenta de prueba. Al solicitar una cuenta de prueba, debe enviar la siguiente informaci\u00f3n:<\/span><\/p><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Nombre de la empresa<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Nombre visible de la empresa (que aparecer\u00e1 en la pantalla de autenticaci\u00f3n del usuario)<\/span><\/li><li style=\"font -peso: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">CNPJ<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Contacto t\u00e9cnico: n<\/span><span style=\"font-weight: 400;\">algunos,<\/span><span style=\"font-weight: 400;\">correo electr\u00f3nico, t<\/span><span style=\"font-weight: 400;\">tel\u00e9fono<\/span><\/li><\/ol><h1>Informaci\u00f3n del sistema de autenticaci\u00f3n<\/h1><p><span style=\"font-weight: 400;\">Para poder llamar a los m\u00e9todos API de Certillion, primero debe autenticar el sistema que realizar\u00e1 las solicitudes. Con las credenciales proporcionadas (ver <\/span><a href=\"https:\/\/certillion.com\/es\/api\/tutoriales\/\"><span style=\"font-weight: 400;\">Pre- requisitos<\/span><\/a><span style=\"font-weight: 400;\">), autenticar utilizando el m\u00e9todo:<\/span><\/p><p><img decoding=\"async\" class=\"wp-image-9955 aligncenter\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1.png\" alt=\"\" width=\"349\" height=\"91\" srcset=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1.png 2441w, https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1-1536x402.png 1536w, https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1-2048x536.png 2048w\" sizes=\"(max-width: 349px) 100vw, 349px\" \/><\/p><table><tbody><tr><td><b>Paso<\/b><\/td><td><b>Descripci\u00f3n<\/b><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">1: \/client_token<\/span><\/td><td><span style=\"font-weight: 400;\">Llamar para la autenticaci\u00f3n mediante credenciales.<\/span><\/td><\/tr><\/tbody><\/table><h1>Lista de certificados de nube admitidos<\/h1><p><span style=\"font -weight: 400;\">Certillion soporta todos los proveedores de certificados en la nube en ICP-Brasil (PSC &#8211; Proveedor de Servicios de Certificaci\u00f3n).<\/span><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">El servidor Certillion proporciona y actualiza autom\u00e1ticamente la lista completa de nombres de PSC tan pronto como se genera un nuevo Se agrega el tipo de certificado de nube.<\/span><\/p><div><div><div><div>\u00a0<\/div><\/div><\/div><\/div><p><img fetchpriority=\"high\" decoding=\"async\" src=\" https:\/\/certillion.com\/wp-content\/uploads\/2024\/07\/image-e1721074112845.png\" alt=\"\" width=\"1629\" height=\"852\" \/><\/p><table><tbody><tr><td><strong>Passo<\/strong><\/td><td><strong>Descri\u00e7\u00e3o<\/strong><\/td><\/tr><tr><td>1: acceda a la p\u00e1gina de inicio de sesi\u00f3n mediante certificado digital<\/td><td>Acceda a la p\u00e1gina utilizando su PSC.<\/td><\/tr><tr><td>2: Solicita la p\u00e1gina de inicio de sesi\u00f3n.<\/td><td>Realiza una solicitud de autenticaci\u00f3n.<\/td><\/tr><tr><td>3: \/psc-info<\/td><td><span style=\"font-weight: 400;\">Llamada que busca todos los PSC compatibles con Certillion.<\/span><\/td><\/tr><\/tbody><\/table><p>El desarrollador puede utilizar esta lista para generar la interfaz de usuario, de modo que pueda identificar y utilizar f\u00e1cilmente los certificados digitales a trav\u00e9s de Certillion.<\/p><h1>Ubicaci\u00f3n del certificado<\/h1><p>Utilizando la API tambi\u00e9n es posible localizar los certificados que tiene el usuario en la nube, en funci\u00f3n del identificador legal que se quiera buscar.<\/p><p><img decoding=\"async\" class=\"wp-image-9925 aligncenter\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-8.png\" alt=\"\" width=\"344\" height=\"267\" \/><\/p><table><tbody><tr><td><strong>Passo<\/strong><\/td><td><strong>Descri\u00e7\u00e3o<\/strong><\/td><\/tr><tr><td>1: informar al CPF o al CNPJ<\/td><td>Identificador legal necesario para buscar el PSC.<\/td><\/tr><tr><td>2: solicitar lista de PSC<\/td><td>Solicitar PSC utilizando el identificador legal.<\/td><\/tr><tr><td>3: \/find-psc-accounts<\/td><td>Llamada que busca cuentas de PSC utilizando un identificador legal.<\/td><\/tr><\/tbody><\/table><p><strong>Nota<\/strong>: Este m\u00e9todo devolver\u00e1 una lista cuyas entradas son los resultados de la b\u00fasqueda en cada uno de los PSC. Cada entrada en esta lista contendr\u00e1 el identificador de PSC y un estado que indica si el usuario est\u00e1 certificado <strong>(estado=\u201dS\u201d)<\/strong>. Si todas las entradas tienen <strong>estado=\u201dN\u201d<\/strong>, la \u00fanica posibilidad que se ofrece al usuario es firmar usando la aplicaci\u00f3n Certillion con certificados locales, A1 en archivo o A3 en soporte f\u00edsico (tarjeta o token).<\/p><h1>Autenticaci\u00f3n de usuario (firmante)<\/h1><p>Antes de firmar cualquier documento, el usuario deber\u00e1 autorizar el acceso a su certificado digital.<\/p><p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-9934 aligncenter\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-9-1.png\" alt=\"\" width=\"363\" height=\"220\" srcset=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-9-1.png 1605w, https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-9-1-1536x931.png 1536w\" sizes=\"(max-width: 363px) 100vw, 363px\" \/><\/p><table><tbody><tr><td><b>Paso<\/b><\/td><td><b>Descripci\u00f3n<\/b><\/td><\/tr><tr><td>1: seleccione PSC<\/td><td>Seleccione su PSC<\/td><\/tr><tr><td>2: reenv\u00eda el PSC elegido<\/td><td>Env\u00eda el PSC seleccionado.<\/td><\/tr><tr><td>3: \/authorize (devuelve la p\u00e1gina de autenticaci\u00f3n)<\/td><td>Llamada de autorizaci\u00f3n para que el PSC identifique al firmante y al Certillion.<\/td><\/tr><tr><td>4: muestra la p\u00e1gina de autenticaci\u00f3n.<\/td><td><span style=\"font-weight: 400;\">La aplicaci\u00f3n muestra la p\u00e1gina de autenticaci\u00f3n.<\/span><\/td><\/tr><tr><td>5: proporciona datos de autenticaci\u00f3n.<\/td><td>El firmante proporciona credenciales.<\/td><\/tr><tr><td>6: \/token<\/td><td>Llamada para obtener el c\u00f3digo de seguridad (token).<\/td><\/tr><\/tbody><\/table><p>Puedes otorgar autorizaci\u00f3n de tres maneras:<\/p><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">firma \u00fanica: Proceso de firmar un \u00fanico documento por vez.<\/span><\/li><li style=\"font- peso: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">firma por lotes: proceso de firma de varios documentos en un solo proceso.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">creaci\u00f3n de sesi\u00f3n de firma: proceso en el que se crea una sesi\u00f3n temporal para realizar tanto una firma \u00fanica como firmas por lotes.<\/span><\/li><\/ol><h1>Firma de documentos<\/h1><p>Siga los pasos descritos en el diagrama siguiente para firmar el documento.<\/p><table><tbody><tr><td><b>Paso<\/b><\/td><td><b>Descripci\u00f3n<\/b><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">1: haga clic en firmar<\/span><\/td><td><span style=\"font-weight: 400;\">El firmante selecciona la opci\u00f3n de firmar.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">2: solicita firma<\/span><\/td><td><span style=\"font-weight: 400;\">Llamada que sube el documento a firmar.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">3: \/document (POST)<\/span><\/td><td><span style=\"font-weight: 400;\">Llamada que sube el documento a firmar.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">4: \/signature<\/span><\/td><td><span style=\"font-weight: 400;\">Llamada que firma el documento.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">5: \/documento (GET)<\/span><\/td><td><span style=\"font- peso: 400;\">Llamada que descarga el documento firmado.<\/span><\/td><\/tr><\/tbody><\/table><h1>\u00a1Importante! Manejo correcto de errores<\/h1><p><span style=\"font-weight: 400;\">Si alguno de los 3 m\u00e9todos anteriores utilizados en la firma falla, S\u00d3LO repita la llamada a ese m\u00e9todo:<\/span><\/p><ul><li aria-level=\"1\"><span style=\"font-weight: 400;\">si el segundo m\u00e9todo <\/span><span style=\"font-weight: 400;\">\/signature<\/span><span style=\"font-weight: 400;\"> falla, simplemente llame a este m\u00e9todo,<\/span><b>NO<\/b><span style=\"font-weight: 400;\">es necesario volver a cargar el archivo <\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">si el tercer m\u00e9todo <\/span><span style=\"font-weight: 400;\">\/document<\/span><span style=\"font-weight: 400;\"> (get) falla, simplemente haga otra llamada para descargar el documento firmado, <\/span><b>NO<\/b><span style=\"font-weight: 400;\">es necesario subir nuevamente o solicitar una nueva firma<\/span><\/li><\/ul><p><b>Repetir solicitudes processadas s correctamente<\/b> <b>puede generar cargos adicionales para el sistema que solicita firmas<\/b><span style=\"font-weight: 400;\">.<\/span><\/p><h1>Verificaci\u00f3n de Firmas<\/h1><p>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.<\/p><p><img decoding=\"async\" src=\"https:\/\/certillion.com.grupodemidiahost.com.br\/wp-content\/uploads\/2024\/06\/image-10. png \" alt=\"\" \/><span style=\"font-weight: 400;\">Sube el documento a firmar.<\/span><\/p><table><tbody><tr><td><b>Paso<\/b><\/td><td><b>Descripci\u00f3n<\/b><\/td><\/tr><tr><td>1: \/document (POST) [opcional]<\/td><td>Carga el documento a firmar.<\/td><\/tr><tr><td>2: \/validate<\/td><td>Llamada que verifica cualquier firma digital del ICP-Brasil.<\/td><\/tr><\/tbody><\/table><p><span style=\"font-weight: 400;\">Para comprobar los posibles c\u00f3digos de retorno de Certillion, consulte la API en l\u00ednea en el m\u00e9todo<\/span> <a href=\"https:\/\/certillion.com\/es\/api\/api-en-linea\/\"><span style=\"font-weight: 400;\">C\u00f3digos de estado devueltos por llamadas a Certillion<\/span><\/a><\/p><h1>Optimizaci\u00f3n del secreto y rendimiento<\/h1><p>Como se ve en el proceso de firma, debe enviar el documento a los servidores de Certillion para que sea firmado o verificado. Despu\u00e9s de firmar, el documento tambi\u00e9n debe firmarse siguiendo las siguientes pr\u00e1cticas:<\/p><ol><li style=\"list-style-type: none;\"><ol><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">ning\u00fan procesamiento excepto el necesario para procesar la firma digital;<\/span><\/li><li style=\"font-weight: 400;\">el documento se almacena cifrado en servidores;<\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">el documento permanece en los servidores un m\u00ednimo de 24 horas y un m\u00e1ximo de 48 horas para descargarse despu\u00e9s de firmar, despu\u00e9s de lo cual se elimina irreversiblemente.<\/span><\/li><\/ol><\/li><\/ol><p><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">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<\/span><span style=\"font-weight: 400;\"> A trav\u00e9s del componente <\/span><b>Certillion Agent<\/b><span style=\"font-weight: 400;\"> es posible preprocesar el documento en el entorno del solicitante, evitando la necesidad de cargar <\/span><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">De manera similar, despu\u00e9s de completar la firma, el sistema genera el documento firmado localmente<\/span><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">. Este enfoque tiene las siguientes ventajas:<\/span><\/p><ol><li style=\"list-style-type: none;\"><ol><li style=\"list-style-type: none;\"><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Cumplimiento de posibles normas de la empresa de no subcontratar documentos con informaci\u00f3n confidencial o privada;<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\">La firma es m\u00e1s r\u00e1pida porque no es necesario transmitir documentos en ambas direcciones.<\/li><li style=\"font-weight: 400;\" aria-level=\"1 \">No se requiere ning\u00fan cambio en el c\u00f3digo de integraci\u00f3n, Certillion Agent es un componente neutral de la red.<\/li><\/ol><\/li><\/ol><\/li><\/ol><p>Despu\u00e9s Para completar la integraci\u00f3n de su sistema , solicite la instalaci\u00f3n de la versi\u00f3n Certillion Agent en su entorno.<\/p><p><img decoding=\"async\" style=\"letter-spacing: -0.7px; alineaci\u00f3n de texto: var(--text-align);\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/07\/image-4.png\" alt=\"\" height=\"900\" \/><\/p><table><tbody><tr><td><b>Paso<\/b><\/td><td><b>Descripci\u00f3n<\/b><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">1: \/documento (POST)<\/span><\/td><td><span style=\"font-weight: 400;\">Llamada que sube el documento a firmar en el servidor r ubicaci\u00f3n del firmante.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">2: c\u00e1lculo de hash<\/span><\/td><td><span style=\"font-weight: 400;\">Resumen del documento enviado. <\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">3: \/signature<\/span><\/td><td><span style=\"fuente -weight: 400;\">Llamada que realiza la firma del documento en el servidor local del firmante.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">4: \/signature<\/span><\/td><td><span style=\"font-weight: 400;\">Llamada que firma el documento en el servidor Certillion.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">5: \/documento (GET)<\/span><\/td><td><span style=\"font-weight: 400;\">Llamada que descarga el documento firmado al servidor local del firmante.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">6: genera el documento firmado <\/span><\/td><td><span style=\"font-weight: 400;\">La aplicaci\u00f3n solicita el documento firmado al servidor local del firmante.<\/span><\/td><\/tr><\/tbody><\/table><h1>Certillion Signer<\/h1><p><span style=\"font-weight: 400;\">Los certificados digitales en la nube no requieren el uso de ninguna aplicaci\u00f3n en el entorno del usuario que firme el documentos.<\/span><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">El entorno del PSC, debidamente acreditado al efecto, procesa los certificados digitales de forma segura.<\/span><\/p><p><span style=\"font-weight: 400;\">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\u00f3.<\/span><\/p><p><span style=\"font-weight: 400;\">Para proteger el sistema que solicita la firma realizada con certificados tradicionales , se debe solicitar al usuario que utilice el <\/span><span style=\"color: #000000;\"><a style=\"color: #000000;\" href=\"http:\/\/download.certillion.com\">firmante local de Certillion\u00a0(consulte este enlace en el nuevo sitio web).Esta aplicaci\u00f3n garantiza que genere la firma de forma segura y compatible\u00a0<\/a><\/span><\/p><p><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">Si desarroll\u00f3 su sistema con Certillion API, no necesita cambiar el c\u00f3digo de integraci\u00f3n, \u00a1ya que ya es compatible con el firmante!<\/span><\/p><p><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">Otras grandes ventajas del firmante Certillion:<\/span><\/p><ol><li style=\"list-style-type: none;\"><ol><li style=\"list-style-type: none;\"><ol><li><span style=\"font-weight: 400;\">No se necesitan complementos para que funcione en sistemas web;<\/span><\/li><li>Funciona<span style=\"font-weight: 400;\"> en las principales plataformas: Windows, Mac, Android, iPhone, iPad y Linux;<\/span><\/li><li><span style=\"font-weight: 400;\">No tiene coste adicional, incluso se puede descargar gratis<\/span><\/li><\/ol><\/li><\/ol><\/li><\/ol><table><tbody><tr><td><b>Paso<\/b><\/td><td><b>Descripci\u00f3n<\/b><\/td><\/tr><tr><td><span style=\"font- peso: 400;\"> 1: seleccione el PSC elegido<\/span><\/td><td><span style=\"font-weight: 400;\">Seleccione su PSC.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">2: reenv\u00eda el PSC elegido<\/span><\/td><td><span style=\"font-weight: 400;\">Env\u00eda el PSC seleccionado.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">3: \/authorize (devuelve la p\u00e1gina de autenticaci\u00f3n)<\/span><\/td><td><span style=\"font-weight: 400;\">Llamada de autorizaci\u00f3n para que el PSC identifique al firmante y al Certillion.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">4: muestra la p\u00e1gina de autenticaci\u00f3n<\/span><\/td><td><span style=\"font-weight: 400;\">La aplicaci\u00f3n muestra la p\u00e1gina de autenticaci\u00f3n.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">5: proporciona datos de autenticaci\u00f3n<\/span><\/td><td><span style=\"font -weight: 400;\">El firmante proporciona las credenciales.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">6: \/token<\/span><\/td><td><span style=\"font-weight: 400;\">Llame para obtener el c\u00f3digo de seguridad (token).<\/span><\/td><\/tr><\/tbody><\/table>\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"<p>Documentaci\u00f3n Tutoriales Tutoriales 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\u00e1lido para probar su integraci\u00f3n o solicitar un certificado de prueba Instalar app Certillion si el certificado es tipo A1 (archivo) o A3 en soporte f\u00edsico (tarjeta o token) Las credenciales se pueden obtener en Contacto,\u00a0solicitando una cuenta de prueba. Al solicitar una cuenta de prueba, debe enviar la siguiente informaci\u00f3n: Nombre de la empresa Nombre visible de la empresa (que aparecer\u00e1 en la pantalla de autenticaci\u00f3n del usuario) CNPJ Contacto t\u00e9cnico: nalgunos,correo electr\u00f3nico, ttel\u00e9fono Informaci\u00f3n del sistema de autenticaci\u00f3n Para poder llamar a los m\u00e9todos API de Certillion, primero debe autenticar el sistema que realizar\u00e1 las solicitudes. Con las credenciales proporcionadas (ver Pre- requisitos), autenticar utilizando el m\u00e9todo: Paso Descripci\u00f3n 1: \/client_token Llamar para la autenticaci\u00f3n mediante credenciales. Lista de certificados de nube admitidos Certillion soporta todos los proveedores de certificados en la nube en ICP-Brasil (PSC &#8211; Proveedor de Servicios de Certificaci\u00f3n).El servidor Certillion proporciona y actualiza autom\u00e1ticamente la lista completa de nombres de PSC tan pronto como se genera un nuevo Se agrega el tipo de certificado de nube. \u00a0 Passo Descri\u00e7\u00e3o 1: acceda a la p\u00e1gina de inicio de sesi\u00f3n mediante certificado digital Acceda a la p\u00e1gina utilizando su PSC. 2: Solicita la p\u00e1gina de inicio de sesi\u00f3n. Realiza una solicitud de autenticaci\u00f3n. 3: \/psc-info Llamada que busca todos los PSC compatibles con Certillion. El desarrollador puede utilizar esta lista para generar la interfaz de usuario, de modo que pueda identificar y utilizar f\u00e1cilmente los certificados digitales a trav\u00e9s de Certillion. Ubicaci\u00f3n del certificado Utilizando la API tambi\u00e9n es posible localizar los certificados que tiene el usuario en la nube, en funci\u00f3n del identificador legal que se quiera buscar. Passo Descri\u00e7\u00e3o 1: informar al CPF o al CNPJ Identificador legal necesario para buscar el PSC. 2: solicitar lista de PSC Solicitar PSC utilizando el identificador legal. 3: \/find-psc-accounts Llamada que busca cuentas de PSC utilizando un identificador legal. Nota: Este m\u00e9todo devolver\u00e1 una lista cuyas entradas son los resultados de la b\u00fasqueda en cada uno de los PSC. Cada entrada en esta lista contendr\u00e1 el identificador de PSC y un estado que indica si el usuario est\u00e1 certificado (estado=\u201dS\u201d). Si todas las entradas tienen estado=\u201dN\u201d, la \u00fanica posibilidad que se ofrece al usuario es firmar usando la aplicaci\u00f3n Certillion con certificados locales, A1 en archivo o A3 en soporte f\u00edsico (tarjeta o token). Autenticaci\u00f3n de usuario (firmante) Antes de firmar cualquier documento, el usuario deber\u00e1 autorizar el acceso a su certificado digital. Paso Descripci\u00f3n 1: seleccione PSC Seleccione su PSC 2: reenv\u00eda el PSC elegido Env\u00eda el PSC seleccionado. 3: \/authorize (devuelve la p\u00e1gina de autenticaci\u00f3n) Llamada de autorizaci\u00f3n para que el PSC identifique al firmante y al Certillion. 4: muestra la p\u00e1gina de autenticaci\u00f3n. La aplicaci\u00f3n muestra la p\u00e1gina de autenticaci\u00f3n. 5: proporciona datos de autenticaci\u00f3n. El firmante proporciona credenciales. 6: \/token Llamada para obtener el c\u00f3digo de seguridad (token). Puedes otorgar autorizaci\u00f3n de tres maneras: firma \u00fanica: Proceso de firmar un \u00fanico documento por vez. firma por lotes: proceso de firma de varios documentos en un solo proceso. creaci\u00f3n de sesi\u00f3n de firma: proceso en el que se crea una sesi\u00f3n temporal para realizar tanto una firma \u00fanica como firmas por lotes. Firma de documentos Siga los pasos descritos en el diagrama siguiente para firmar el documento. Paso Descripci\u00f3n 1: haga clic en firmar El firmante selecciona la opci\u00f3n de firmar. 2: solicita firma Llamada que sube el documento a firmar. 3: \/document (POST) Llamada que sube el documento a firmar. 4: \/signature Llamada que firma el documento. 5: \/documento (GET) Llamada que descarga el documento firmado. \u00a1Importante! Manejo correcto de errores Si alguno de los 3 m\u00e9todos anteriores utilizados en la firma falla, S\u00d3LO repita la llamada a ese m\u00e9todo: si el segundo m\u00e9todo \/signature falla, simplemente llame a este m\u00e9todo,NOes necesario volver a cargar el archivo si el tercer m\u00e9todo \/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\u00f3n 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. Paso Descripci\u00f3n 1: \/document (POST) [opcional] Carga el documento a firmar. 2: \/validate Llamada que verifica cualquier firma digital del ICP-Brasil. Para comprobar los posibles c\u00f3digos de retorno de Certillion, consulte la API en l\u00ednea en el m\u00e9todo C\u00f3digos de estado devueltos por llamadas a Certillion Optimizaci\u00f3n 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\u00e9s de firmar, el documento tambi\u00e9n debe firmarse siguiendo las siguientes pr\u00e1cticas: ning\u00fan procesamiento excepto el necesario para procesar la firma digital; el documento se almacena cifrado en servidores; el documento permanece en los servidores un m\u00ednimo de 24 horas y un m\u00e1ximo de 48 horas para descargarse despu\u00e9s de firmar, despu\u00e9s 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\u00e9s del componente Certillion Agent es posible preprocesar el documento en el entorno del solicitante, evitando la necesidad de cargar De manera similar, despu\u00e9s de completar la firma, el sistema genera el documento firmado localmente. Este enfoque tiene las siguientes ventajas: Cumplimiento de posibles normas de la empresa de no subcontratar documentos con informaci\u00f3n confidencial o privada; La firma es m\u00e1s r\u00e1pida porque no es necesario transmitir documentos en ambas direcciones. No se requiere ning\u00fan cambio en el c\u00f3digo de integraci\u00f3n, Certillion Agent es un componente neutral de la red. Despu\u00e9s Para completar la integraci\u00f3n de su sistema , solicite la instalaci\u00f3n de la<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":8996,"menu_order":26,"comment_status":"closed","ping_status":"closed","template":"templates\/page-builder-content.php","meta":{"footnotes":""},"class_list":["post-9083","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v22.5 (Yoast SEO v23.7) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Tutoriales - Certillion<\/title>\n<meta name=\"description\" content=\"Hay tutoriales disponibles con las principales preguntas relacionadas con la API de Certillion.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/certillion.com\/certillion-api\/tutoriais\/\" \/>\n<meta property=\"og:locale\" content=\"es_ES\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Tutoriales\" \/>\n<meta property=\"og:description\" content=\"Hay tutoriales disponibles con las principales preguntas relacionadas con la API de Certillion.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/certillion.com\/certillion-api\/tutoriais\/\" \/>\n<meta property=\"og:site_name\" content=\"Certillion\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/certillion\" \/>\n<meta property=\"article:modified_time\" content=\"2024-12-17T16:03:39+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1.png\" \/>\n\t<meta property=\"og:image:width\" content=\"2441\" \/>\n\t<meta property=\"og:image:height\" content=\"639\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Tiempo de lectura\" \/>\n\t<meta name=\"twitter:data1\" content=\"8 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/certillion.com\/certillion-api\/tutoriais\/\",\"url\":\"https:\/\/certillion.com\/certillion-api\/tutoriais\/\",\"name\":\"Tutoriales - Certillion\",\"isPartOf\":{\"@id\":\"https:\/\/certillion.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/certillion.com\/certillion-api\/tutoriais\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/certillion.com\/certillion-api\/tutoriais\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1.png\",\"datePublished\":\"2024-04-07T21:27:50+00:00\",\"dateModified\":\"2024-12-17T16:03:39+00:00\",\"description\":\"Hay tutoriales disponibles con las principales preguntas relacionadas con la API de Certillion.\",\"breadcrumb\":{\"@id\":\"https:\/\/certillion.com\/certillion-api\/tutoriais\/#breadcrumb\"},\"inLanguage\":\"es\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/certillion.com\/certillion-api\/tutoriais\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@id\":\"https:\/\/certillion.com\/certillion-api\/tutoriais\/#primaryimage\",\"url\":\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1.png\",\"contentUrl\":\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/certillion.com\/certillion-api\/tutoriais\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"In\u00edcio\",\"item\":\"https:\/\/certillion.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API\",\"item\":\"https:\/\/certillion.com\/certillion-api\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Tutoriales\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/certillion.com\/#website\",\"url\":\"https:\/\/certillion.com\/\",\"name\":\"Certillion - Certifica\u00e7\u00e3o Digital\",\"description\":\"Simples, R\u00e1pido e Seguro\",\"publisher\":{\"@id\":\"https:\/\/certillion.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/certillion.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"es\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/certillion.com\/#organization\",\"name\":\"E-sec Seguran\u00e7a Digital\",\"url\":\"https:\/\/certillion.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@id\":\"https:\/\/certillion.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/certillion.com\/wp-content\/uploads\/2021\/07\/Certillion-Dark.svg\",\"contentUrl\":\"https:\/\/certillion.com\/wp-content\/uploads\/2021\/07\/Certillion-Dark.svg\",\"width\":218,\"height\":62,\"caption\":\"E-sec Seguran\u00e7a Digital\"},\"image\":{\"@id\":\"https:\/\/certillion.com\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/certillion\",\"https:\/\/www.linkedin.com\/company\/certillion\/\",\"https:\/\/www.instagram.com\/certillion\/\"]}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Tutoriales - Certillion","description":"Hay tutoriales disponibles con las principales preguntas relacionadas con la API de Certillion.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/certillion.com\/certillion-api\/tutoriais\/","og_locale":"es_ES","og_type":"article","og_title":"Tutoriales","og_description":"Hay tutoriales disponibles con las principales preguntas relacionadas con la API de Certillion.","og_url":"https:\/\/certillion.com\/certillion-api\/tutoriais\/","og_site_name":"Certillion","article_publisher":"https:\/\/www.facebook.com\/certillion","article_modified_time":"2024-12-17T16:03:39+00:00","og_image":[{"width":2441,"height":639,"url":"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Tiempo de lectura":"8 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/certillion.com\/certillion-api\/tutoriais\/","url":"https:\/\/certillion.com\/certillion-api\/tutoriais\/","name":"Tutoriales - Certillion","isPartOf":{"@id":"https:\/\/certillion.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/certillion.com\/certillion-api\/tutoriais\/#primaryimage"},"image":{"@id":"https:\/\/certillion.com\/certillion-api\/tutoriais\/#primaryimage"},"thumbnailUrl":"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1.png","datePublished":"2024-04-07T21:27:50+00:00","dateModified":"2024-12-17T16:03:39+00:00","description":"Hay tutoriales disponibles con las principales preguntas relacionadas con la API de Certillion.","breadcrumb":{"@id":"https:\/\/certillion.com\/certillion-api\/tutoriais\/#breadcrumb"},"inLanguage":"es","potentialAction":[{"@type":"ReadAction","target":["https:\/\/certillion.com\/certillion-api\/tutoriais\/"]}]},{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/certillion.com\/certillion-api\/tutoriais\/#primaryimage","url":"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1.png","contentUrl":"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1.png"},{"@type":"BreadcrumbList","@id":"https:\/\/certillion.com\/certillion-api\/tutoriais\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"In\u00edcio","item":"https:\/\/certillion.com\/en\/"},{"@type":"ListItem","position":2,"name":"API","item":"https:\/\/certillion.com\/certillion-api\/"},{"@type":"ListItem","position":3,"name":"Tutoriales"}]},{"@type":"WebSite","@id":"https:\/\/certillion.com\/#website","url":"https:\/\/certillion.com\/","name":"Certillion - Certifica\u00e7\u00e3o Digital","description":"Simples, R\u00e1pido e Seguro","publisher":{"@id":"https:\/\/certillion.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/certillion.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"es"},{"@type":"Organization","@id":"https:\/\/certillion.com\/#organization","name":"E-sec Seguran\u00e7a Digital","url":"https:\/\/certillion.com\/","logo":{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/certillion.com\/#\/schema\/logo\/image\/","url":"https:\/\/certillion.com\/wp-content\/uploads\/2021\/07\/Certillion-Dark.svg","contentUrl":"https:\/\/certillion.com\/wp-content\/uploads\/2021\/07\/Certillion-Dark.svg","width":218,"height":62,"caption":"E-sec Seguran\u00e7a Digital"},"image":{"@id":"https:\/\/certillion.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/certillion","https:\/\/www.linkedin.com\/company\/certillion\/","https:\/\/www.instagram.com\/certillion\/"]}]}},"_links":{"self":[{"href":"https:\/\/certillion.com\/es\/wp-json\/wp\/v2\/pages\/9083","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/certillion.com\/es\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/certillion.com\/es\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/certillion.com\/es\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/certillion.com\/es\/wp-json\/wp\/v2\/comments?post=9083"}],"version-history":[{"count":0,"href":"https:\/\/certillion.com\/es\/wp-json\/wp\/v2\/pages\/9083\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/certillion.com\/es\/wp-json\/wp\/v2\/pages\/8996"}],"wp:attachment":[{"href":"https:\/\/certillion.com\/es\/wp-json\/wp\/v2\/media?parent=9083"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}