{"id":9724,"date":"2024-10-28T12:22:51","date_gmt":"2024-10-28T12:22:51","guid":{"rendered":"https:\/\/certillion.com\/videos\/"},"modified":"2025-04-15T17:34:03","modified_gmt":"2025-04-15T17:34:03","slug":"videotutorial","status":"publish","type":"page","link":"https:\/\/certillion.com\/es\/videotutorial\/","title":{"rendered":"V\u00eddeoTutorial"},"content":{"rendered":"\t\t
\n\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t
\n
V\u00eddeoTutorial<\/h5>
<\/div><\/div>\n <\/section>\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
\n\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t

Consulte los tutoriales de Certillion. Este v\u00eddeo proporciona una gu\u00eda completa paso a paso de las funciones principales de Certillion, con especial \u00e9nfasis en demostrar c\u00f3mo utilizar la API para realizar firmas digitales de una manera pr\u00e1ctica y eficiente.<\/p>\n\t\t\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

\n\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
<\/div>\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
\n\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t

Material de Apoio: Como Usar a API Certillion<\/p>

\u00a0<\/div>

1. Credenciales de acceso<\/strong><\/p>

Para acceder a la plataforma Certillion, necesita las credenciales a continuaci\u00f3n. Para saber c\u00f3mo obtener credenciales, visite la secci\u00f3n tutoriales.<\/a> <\/span><\/p>
\"client_id\": \".....\",<\/span>\n\n\"client_secret\": \"......\"\n<\/span><\/pre><\/td><\/tr><\/tbody><\/table>
2. Colecci\u00f3n del Postman<\/strong><\/p>
Accede a la Colecci\u00f3n Postman en la parte inferior de esta p\u00e1gina. <\/span>Utiliza las variables de entorno CLIENT_ID y CLIENT_SECRET.<\/span><\/p>
Puede:<\/span><\/p>
    1. Reemplace las variables directamente con los valores dados.<\/span><\/li>
    2. O bien configure las variables en el entorno Postman.<\/span><\/li><\/ol><\/li><\/ol>
      3. Flujo de firma digital con OAuth2<\/strong><\/p>
      El flujo de firma b\u00e1sico con Certillion es el siguiente:<\/span><\/p>
        1.  oauth\/client_token<\/span><\/li>
        2.  oauth\/document (subir documento)<\/span><\/li>
        3.  oauth\/authorize<\/span><\/li>
        4.  oauth\/token<\/span><\/li>
        5.  oauth\/signature<\/span><\/li>
        6.  oauth\/document (download) (opcional, solo si se carga)<\/span><\/li><\/ol><\/li><\/ol>
          Extra:<\/strong><\/p>
          El endpoint oauth\/find-psc-accounts se puede utilizar para averiguar qu\u00e9 PSC un CPF o CNPJ tiene un certificado digital disponible.<\/span><\/p>
          4. Generaci\u00f3n de desaf\u00edo de c\u00f3digo y verificador de c\u00f3digo (PKCE)<\/strong><\/p>
          En las llamadas a \/authorize y \/token, necesitar\u00e1 un code_challenge y un code_verifier.<\/span><\/p>
          Ejemplo de generaci\u00f3n en Node.js:<\/span><\/p>
          var crypto = require('crypto')<\/span>\nfunction base64URLEncode(str) {<\/span>\n    return str.toString('base64')<\/span>\n        .replace(\/\\+\/g, '-')<\/span>\n        .replace(\/\\\/\/g, '_')<\/span>\n        .replace(\/=\/g, '');<\/span>\n}<\/span>\nvar verifier = base64URLEncode(crypto.randomBytes(32));<\/span>\nconsole.log(\"verifier: \" + verifier);<\/span>\nfunction sha256(buffer) {<\/span>\n    return crypto.createHash('sha256').update(buffer).digest();<\/span>\n}<\/span>\nvar challenge = base64URLEncode(sha256(verifier));<\/span>\nconsole.log(\"challenge: \" + challenge);<\/span><\/pre><\/td><\/tr><\/tbody><\/table>
          Consejo:<\/strong><\/p>
          Puede ejecutar este c\u00f3digo en l\u00ednea haciendo clic  aqu\u00ed<\/a> <\/span><\/p>
          5. Ejecutar \/authorize<\/strong><\/p>
          En Postman, complete los campos obligatorios y copie la URL generada.<\/span><\/p>
          Abra esta URL en su navegador. Ser\u00e1s redirigido al PSC (por ejemplo, VIDAAS) para la autenticaci\u00f3n. <\/span><\/p>
          Despu\u00e9s de autenticarse, ser\u00e1 redirigido a una URL similar a: \u00abhttps:\/\/esec.com.br\/callback?code=a9ef7f76-1118-4731-95b5-4ead66ec9457&state=123\u00bb<\/span><\/p>
          6. Configuraciones importantes<\/strong><\/p>
          En el campo redirect_uri de las solicitudes \/authorize y \/token, utilice la URL base hasta \/callback, por ejemplo: \u00abhttps:\/\/esec.com.br\/callback\u00bb<\/span><\/p>
          El par\u00e1metro de c\u00f3digo obtenido de la URL se utilizar\u00e1 en la llamada oauth\/token.<\/span><\/p>
          7. PSC y endpoints<\/strong><\/p>
          El campo psc debe configurarse de acuerdo con el PSC que se utilizar\u00e1.<\/span><\/p>
          Para los certificados A1 o A3 conectados a la m\u00e1quina del usuario final, utilice: CERTILLION_SIGNER<\/span><\/p>
          Puntos finales:<\/span><\/p>
            1.  Para CERTILLION_SIGNER: \u00abhttps:\/\/cloud-ws.certillion.com\u00bb<\/span><\/li>
            2. Para otros PSC: \u00abhttps:\/\/cloud.certillion.com\u00bb<\/span><\/li><\/ol><\/li><\/ol>
              8. Documentaci\u00f3n oficial<\/strong><\/p>
              La documentaci\u00f3n completa de la API est\u00e1 disponible en certillion.com\/es\/api<\/a><\/span><\/p>
              9. Firmas separadas de CAdES (hash de archivo)<\/strong><\/p>
              Para las firmas CAdES independientes, es necesario calcular el hash sha256 del archivo y pasarlo en el campo hash de la solicitud.<\/span><\/p>
              Ejemplo en bash:<\/span><\/p>
              $ sha256sum.exe e-Sec_com_linha.jpg | awk '{ print $1}' | xxd -r -p | base64<\/span><\/pre><\/td><\/tr><\/tbody><\/table>
              Explicaci\u00f3n del comando:<\/span><\/p>
              sha256sum.exe e-Sec_com_linha.jpg: genera el hash sha256 del archivo.<\/span><\/pre>
              awk '{ print $1}': captura solo el valor hexadecimal del hash.<\/span>

              xxd -r -p: convierte hash hexadecimal a binario.<\/span>

              base64: transforma el hash binario en base64.<\/span><\/pre><\/td><\/tr><\/tbody><\/table>
              El resultado en base64 ser\u00e1 el valor que se utilizar\u00e1 en el campo hash de la solicitud de firma.<\/span><\/p>\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
              \n\t\t\t\t
              \n\t\t\t\t\t
              \n\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\tDescargar la colecci\u00f3n Postman<\/span>\n\t\t\t\t\t<\/span>\n\t\t\t\t\t<\/a>\n\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":"
              V\u00eddeoTutorial Consulte los tutoriales de Certillion. Este v\u00eddeo proporciona una gu\u00eda completa paso a paso de las funciones principales de Certillion, con especial \u00e9nfasis en demostrar c\u00f3mo utilizar la API para realizar firmas digitales de una manera pr\u00e1ctica y eficiente. https:\/\/youtu.be\/wMMa9L00Kgg Material de Apoio: Como Usar a API Certillion \u00a0 1. Credenciales de acceso Para acceder a la plataforma Certillion, necesita las credenciales a continuaci\u00f3n. Para saber c\u00f3mo obtener credenciales, visite la secci\u00f3n tutoriales. \u00abclient_id\u00bb: \u00ab…..\u00bb, \u00abclient_secret\u00bb: \u00ab……\u00bb 2. Colecci\u00f3n del Postman Accede a la Colecci\u00f3n Postman en la parte inferior de esta p\u00e1gina. Utiliza las variables de entorno CLIENT_ID y CLIENT_SECRET. Puede: Reemplace las variables directamente con los valores dados. O bien configure las variables en el entorno Postman. 3. Flujo de firma digital con OAuth2 El flujo de firma b\u00e1sico con Certillion es el siguiente: oauth\/client_token oauth\/document (subir documento) oauth\/authorize oauth\/token oauth\/signature oauth\/document (download) (opcional, solo si se carga) Extra: El endpoint oauth\/find-psc-accounts se puede utilizar para averiguar qu\u00e9 PSC un CPF o CNPJ tiene un certificado digital disponible. 4. Generaci\u00f3n de desaf\u00edo de c\u00f3digo y verificador de c\u00f3digo (PKCE) En las llamadas a \/authorize y \/token, necesitar\u00e1 un code_challenge y un code_verifier. Ejemplo de generaci\u00f3n en Node.js: var crypto = require(‘crypto’) function base64URLEncode(str) { return str.toString(‘base64’) .replace(\/+\/g, ‘-‘) .replace(\/\/\/g, ‘_’) .replace(\/=\/g, \u00bb); } var verifier = base64URLEncode(crypto.randomBytes(32)); console.log(\u00abverifier: \u00bb + verifier); function sha256(buffer) { return crypto.createHash(‘sha256’).update(buffer).digest(); } var challenge = base64URLEncode(sha256(verifier)); console.log(\u00abchallenge: \u00bb + challenge); Consejo: Puede ejecutar este c\u00f3digo en l\u00ednea haciendo clic aqu\u00ed 5. Ejecutar \/authorize En Postman, complete los campos obligatorios y copie la URL generada. Abra esta URL en su navegador. Ser\u00e1s redirigido al PSC (por ejemplo, VIDAAS) para la autenticaci\u00f3n. Despu\u00e9s de autenticarse, ser\u00e1 redirigido a una URL similar a: \u00abhttps:\/\/esec.com.br\/callback?code=a9ef7f76-1118-4731-95b5-4ead66ec9457&state=123\u00bb 6. Configuraciones importantes En el campo redirect_uri de las solicitudes \/authorize y \/token, utilice la URL base hasta \/callback, por ejemplo: \u00abhttps:\/\/esec.com.br\/callback\u00bb El par\u00e1metro de c\u00f3digo obtenido de la URL se utilizar\u00e1 en la llamada oauth\/token. 7. PSC y endpoints El campo psc debe configurarse de acuerdo con el PSC que se utilizar\u00e1. Para los certificados A1 o A3 conectados a la m\u00e1quina del usuario final, utilice: CERTILLION_SIGNER Puntos finales: Para CERTILLION_SIGNER: \u00abhttps:\/\/cloud-ws.certillion.com\u00bb Para otros PSC: \u00abhttps:\/\/cloud.certillion.com\u00bb 8. Documentaci\u00f3n oficial La documentaci\u00f3n completa de la API est\u00e1 disponible en certillion.com\/es\/api 9. Firmas separadas de CAdES (hash de archivo) Para las firmas CAdES independientes, es necesario calcular el hash sha256 del archivo y pasarlo en el campo hash de la solicitud. Ejemplo en bash: $ sha256sum.exe e-Sec_com_linha.jpg | awk ‘{ print $1}’ | xxd -r -p | base64 Explicaci\u00f3n del comando: sha256sum.exe e-Sec_com_linha.jpg: genera el hash sha256 del archivo. awk ‘{ print $1}’: captura solo el valor hexadecimal del hash.xxd -r -p: convierte hash hexadecimal a binario.base64: transforma el hash binario en base64. El resultado en base64 ser\u00e1 el valor que se utilizar\u00e1 en el campo hash de la solicitud de firma. Descargar la colecci\u00f3n Postman<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-9724","page","type-page","status-publish","hentry"],"yoast_head":"\nV\u00eddeoTutorial - Certillion<\/title>\n<meta name=\"description\" content=\"Descubre los Tutoriales de Certillion y c\u00f3mo realizar firmas digitales de forma pr\u00e1ctica y segura, con soporte para usuarios y desarrolladores.\" \/>\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\/tutoriais-certillion\/\" \/>\n<meta property=\"og:locale\" content=\"es_ES\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"V\u00eddeoTutorial\" \/>\n<meta property=\"og:description\" content=\"Descubre los Tutoriales de Certillion y c\u00f3mo realizar firmas digitales de forma pr\u00e1ctica y segura, con soporte para usuarios y desarrolladores.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/certillion.com\/tutoriais-certillion\/\" \/>\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=\"2025-04-15T17:34:03+00:00\" \/>\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=\"2 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/certillion.com\/tutoriais-certillion\/\",\"url\":\"https:\/\/certillion.com\/tutoriais-certillion\/\",\"name\":\"V\u00eddeoTutorial - Certillion\",\"isPartOf\":{\"@id\":\"https:\/\/certillion.com\/#website\"},\"datePublished\":\"2024-10-28T12:22:51+00:00\",\"dateModified\":\"2025-04-15T17:34:03+00:00\",\"description\":\"Descubre los Tutoriales de Certillion y c\u00f3mo realizar firmas digitales de forma pr\u00e1ctica y segura, con soporte para usuarios y desarrolladores.\",\"breadcrumb\":{\"@id\":\"https:\/\/certillion.com\/tutoriais-certillion\/#breadcrumb\"},\"inLanguage\":\"es\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/certillion.com\/tutoriais-certillion\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/certillion.com\/tutoriais-certillion\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"In\u00edcio\",\"item\":\"https:\/\/certillion.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"V\u00eddeoTutorial\"}]},{\"@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":"V\u00eddeoTutorial - Certillion","description":"Descubre los Tutoriales de Certillion y c\u00f3mo realizar firmas digitales de forma pr\u00e1ctica y segura, con soporte para usuarios y desarrolladores.","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\/tutoriais-certillion\/","og_locale":"es_ES","og_type":"article","og_title":"V\u00eddeoTutorial","og_description":"Descubre los Tutoriales de Certillion y c\u00f3mo realizar firmas digitales de forma pr\u00e1ctica y segura, con soporte para usuarios y desarrolladores.","og_url":"https:\/\/certillion.com\/tutoriais-certillion\/","og_site_name":"Certillion","article_publisher":"https:\/\/www.facebook.com\/certillion","article_modified_time":"2025-04-15T17:34:03+00:00","twitter_card":"summary_large_image","twitter_misc":{"Tiempo de lectura":"2 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/certillion.com\/tutoriais-certillion\/","url":"https:\/\/certillion.com\/tutoriais-certillion\/","name":"V\u00eddeoTutorial - Certillion","isPartOf":{"@id":"https:\/\/certillion.com\/#website"},"datePublished":"2024-10-28T12:22:51+00:00","dateModified":"2025-04-15T17:34:03+00:00","description":"Descubre los Tutoriales de Certillion y c\u00f3mo realizar firmas digitales de forma pr\u00e1ctica y segura, con soporte para usuarios y desarrolladores.","breadcrumb":{"@id":"https:\/\/certillion.com\/tutoriais-certillion\/#breadcrumb"},"inLanguage":"es","potentialAction":[{"@type":"ReadAction","target":["https:\/\/certillion.com\/tutoriais-certillion\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/certillion.com\/tutoriais-certillion\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"In\u00edcio","item":"https:\/\/certillion.com\/en\/"},{"@type":"ListItem","position":2,"name":"V\u00eddeoTutorial"}]},{"@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\/9724","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=9724"}],"version-history":[{"count":0,"href":"https:\/\/certillion.com\/es\/wp-json\/wp\/v2\/pages\/9724\/revisions"}],"wp:attachment":[{"href":"https:\/\/certillion.com\/es\/wp-json\/wp\/v2\/media?parent=9724"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}