{"id":9081,"date":"2024-04-07T21:27:50","date_gmt":"2024-04-07T21:27:50","guid":{"rendered":"https:\/\/certillion.com\/api\/tutorials\/"},"modified":"2024-12-17T15:54:50","modified_gmt":"2024-12-17T15:54:50","slug":"tutorials","status":"publish","type":"page","link":"https:\/\/certillion.com\/en\/api\/tutorials\/","title":{"rendered":"Tutorials"},"content":{"rendered":"\t\t<div data-elementor-type=\"wp-page\" data-elementor-id=\"9081\" class=\"elementor elementor-9081 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\">Documentation<\/h5><div class=\"aux-modern-heading-divider\"><\/div><h4 class=\"aux-modern-heading-secondary\"><span class=\"aux-head-before\">Tutorials<\/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\tTutorials\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>Prerequisite<\/h1><p><span style=\"font-weight: 400;\">Before starting testing with the Certillion API, some prerequisites are necessary:<\/span><\/p><ul><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Obtain access credentials<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Have a valid ICP-Brasil certificate to test your integration or request a test certificate<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Install the <\/span><a href=\"http:\/\/download.certillion.com\/\"><span style=\"font-weight: 400;\">Certillion app<\/span><\/a><span style=\"font-weight: 400;\"> if the certificate is type A1 (file) or physical media A3 (card or token)<\/span><\/li><\/ul><p><span style=\"font-weight: 400;\">The credentials can be obtained in the <\/span><a href=\"https:\/\/certillion.com\/en\/contact\/\"><span style=\"font-weight: 400;\">Contact,<\/span><\/a><span style=\"font-weight: 400;\"> requesting a test account. When requesting a test account, you must send the following information:<\/span><\/p><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Company Name<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Visible name of the company (which will appear on the authentication screen for the user)<\/span><\/li><li style=\"font-weight: 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;\">Technical Contact: n<\/span><span style=\"font-weight: 400;\">ame, <\/span><span style=\"font-weight: 400;\">email, t<\/span><span style=\"font-weight: 400;\">elephone<\/span><\/li><\/ol><h1>System Authentication<\/h1><p><span style=\"font-weight: 400;\">To be able to call the Certillion API methods, you must first authenticate the system that will make the requests. With the credentials provided (see Prerequisites), authenticate using the method:\u00a0<\/span><\/p><p><img decoding=\"async\" class=\"alignnone wp-image-9912\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6.png\" alt=\"\" width=\"341\" height=\"89\" srcset=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6.png 2441w, https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-1536x402.png 1536w, https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6-2048x536.png 2048w\" sizes=\"(max-width: 341px) 100vw, 341px\" \/><\/p><table><tbody><tr><td><b>Step<\/b><\/td><td><b> Description<\/b><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">1: \/client_token<\/span><\/td><td><span style=\"font-weight: 400;\">Call for authentication using credentials.<\/span><\/td><\/tr><\/tbody><\/table><h1>List of Supported Cloud Certificates<\/h1><p><span style=\"font-weight: 400;\">Certillion supports all cloud certificate providers in ICP-Brasil (PSC \u2013 Trust Service Providers). The Certillion server provides and automatically updates the complete list of PSC identifiers.<\/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><b>Step<\/b><\/td><td><b>Description<\/b><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">1: access the login page via digital certificate<\/span><\/td><td><span style=\"font-weight: 400;\">Access the page using your PSC.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">2: Request the login page<\/span><\/td><td><span style=\"font-weight: 400;\">Make the authentication request.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">3: \/psc-info<\/span><\/td><td><span style=\"font-weight: 400;\">Call that searches for all PSCs compatible with Certillion.<\/span><\/td><\/tr><\/tbody><\/table><p><span style=\"font-weight: 400;\">The developer can use this list to generate the interface for their user, so that they can easily identify and use digital certificates through Certillion.<\/span><\/p><h1>Location of Certificates<\/h1><p><span style=\"font-weight: 400;\">Using the API, it is also possible to locate the certificates that the user has in the cloud, based on the legal identifier that you want to search for.<\/span><\/p><p><img decoding=\"async\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/07\/image-1.png\" alt=\"\" width=\"500\" height=\"800\" \/><\/p><table><tbody><tr><td><b>Step<\/b><\/td><td><b>Description<\/b><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">1: enter CPF or CNPJ<\/span><\/td><td><span style=\"font-weight: 400;\">Legal identifier required to search for the PSC.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">2: request list of PSCs<\/span><\/td><td><span style=\"font-weight: 400;\">Request for PSCs using the legal identifier.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">3: \/find-psc-accounts<\/span><\/td><td><span style=\"font-weight: 400;\">Call that finds PSC accounts using a legal identifier.<\/span><\/td><\/tr><\/tbody><\/table><p><span style=\"font-weight: 400;\"><strong>Note<\/strong>: This method will return a list whose entries are the result of the search in each of the PSCs. Each entry in this list will contain the PSC identifier and a status indicating whether the user has a certificate (<strong>status=\u201dY\u201d<\/strong>). If all entries have the <strong>status=\u201dN\u201d<\/strong>, the only option offered to the user is to sign using the Certillion app with local certificates, A1 in a file or A3 on physical media (card or token).<\/span><\/p><h1>User Authentication (Signatory)<\/h1><p><span style=\"font-weight: 400;\">Before signing any document, the user must authorize access to their digital certificate.<\/span><\/p><p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/07\/image-2.png\" alt=\"\" width=\"700\" height=\"800\" \/><\/p><table><tbody><tr><td><b>Step<\/b><\/td><td><b>Description<\/b><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">1: select the PSC<\/span><\/td><td><span style=\"font-weight: 400;\">Selects your PSC.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">2: Forwards the chosen PSC<\/span><\/td><td><span style=\"font-weight: 400;\">Sends the selected PSC.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">3: \/authorize (returns authentication page)<\/span><\/td><td><span style=\"font-weight: 400;\">Authorization call for the PSC to identify the signer and Certillion.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">4: Displays authentication page<\/span><\/td><td><span style=\"font-weight: 400;\">Application displays authentication page authentication.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">5: provides authentication data<\/span><\/td><td><span style=\"font-weight: 400;\">Signatory provides credentials.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">6: \/token<\/span><\/td><td><span style=\"font-weight: 400;\">Call to obtain the security code (token).<\/span><\/td><\/tr><\/tbody><\/table><p><span style=\"font-weight: 400;\">You can grant authorization in three ways:<\/span><\/p><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">single_signature: User grants authorization for the system to execute ONE request for signing ONE document.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">multiple_signature: User grants authorization for the system to execute ONE request for a batch of documents (ONE or more).<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">signature_session: User grants authorization for the system to execute, for a specific period of time, as many requests as desired. Each request can be for a batch of one or more files.<\/span><\/li><\/ol><h1>Signing Documents<\/h1><p>Follow the steps outlined in the diagram below to sign the document.<\/p><p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/07\/image-3.png\" alt=\"\" width=\"550\" height=\"900\" \/><\/p><table><tbody><tr><td><b>Step<\/b><\/td><td><b>Description<\/b><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">1: Click sign<\/span><\/td><td><span style=\"font-weight: 400;\">Signer selects option to sign.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">2: Request signature<\/span><\/td><td><span style=\"font-weight: 400;\">Calls the method that requests the document signature.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">3: \/document (POST)<\/span><\/td><td><span style=\"font-weight: 400;\">Call that uploads the document to be signed.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">4: \/signature<\/span><\/td><td><span style=\"font-weight: 400;\">Call that signs the document.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">5: \/document (GET)<\/span><\/td><td><span style=\"font-weight: 400;\">Call that downloads the signed document.<\/span><\/td><\/tr><\/tbody><\/table><p><span style=\"font-weight: 400;\">To sign a document by multiple people, you do a single initial upload, followed by requesting signatures from each person sequentially. <\/span><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">You do not need to repeat all the steps three times; simply request the signature from each signer.<\/span><\/p><h1>Important! Correct Error Handling<\/h1><p><span style=\"font-weight: 400;\">If any of the 3 methods used above for signing fails, repeat ONLY the call to that method:<\/span><\/p><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">if the 2nd method \/signature fails, call only this method, it is NOT necessary to upload the file again<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">if the 3rd method \/document (get) fails, just make another call to download the signed document, it is NOT necessary to upload it again or request a new signature<\/span><\/li><\/ol><p><b>Repeating requests that were processed correctly may generate additional charges for the system that requests the signatures<\/b><span style=\"font-weight: 400;\">.<\/span><\/p><h1>Signature Verification<\/h1><p>Certillion verifies any ICP-Brasil digital signature, even if an external system made the signature. To do this, use the \/verify call.<\/p><p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-9918\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-7.png\" alt=\"\" width=\"344\" height=\"75\" srcset=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-7.png 2673w, https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-7-1536x336.png 1536w, https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-7-2048x447.png 2048w\" sizes=\"(max-width: 344px) 100vw, 344px\" \/><\/p><table><tbody><tr><td><b>Step<\/b><\/td><td><b>Description<\/b><\/td><\/tr><tr><td>1: \/document (POST)<\/td><td><span style=\"font-weight: 400;\">Uploads the document to be signed.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">2: \/verify<\/span><\/td><td><span style=\"font-weight: 400;\">Call that verifies any digital signature ICP-Brasil.<\/span><\/td><\/tr><\/tbody><\/table><p><span style=\"font-weight: 400;\">To check the possible return codes from Certillion, consult the Online API in the method<\/span> <a href=\"https:\/\/certillion.com\/en\/api\/online-api\/\"><span style=\"font-weight: 400;\">Status Codes returned by calls to Certillion<\/span><\/a><\/p><h1>Confidentially and Performace Optimization<\/h1><p>As seen in the signing process, you must send the document to the servers Certillion for it to be signed or verified. After signing, the document must also be signed. At Certillion, we guarantee the confidentiality of documents through the following practices:<\/p><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">no processing is performed beyond what is necessary for the processing of the digital signature;<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">no information contained in the documents is extracted or analyzed, even anonymously;<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">the document is stored in encrypted form on the servers;<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">the document remains on the servers for at least 24 hours and a maximum of 48 hours so that it can be downloaded after signing, after which it is irreversibly deleted.<\/span><\/li><\/ol><p><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">Despite this, when using the Certillion cloud server, some applicants may prefer, however, not to have to send documents to a third-party service<\/span><span style=\"font-weight: 400;\">. Through the <\/span><b>Certillion Agent<\/b><span style=\"font-weight: 400;\"> component, it is possible for the document to be pre-processed in the applicant&#8217;s environment, avoiding the need for uploading. <\/span><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">Similarly, after completing the signature, the system generates the signed document locally<\/span><span style=\"letter-spacing: -0.7px; text-align: var(--text-align);\">. This approach has the following advantages:<\/span><\/p><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Compliance with possible company regulations of not externalizing documents with confidential or private information;<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\">Signing is faster because it is not necessary to transmit the documents in both directions.<\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">No need to change the integration code, the Certillion Agent is a network-neutral component.<\/span><\/li><\/ol><p>After completing the integration of your system, request the installation of the Certillion Agent version in your environment.<\/p><p><img loading=\"lazy\" decoding=\"async\" style=\"letter-spacing: -0.7px; text-align: var(--text-align);\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/07\/image-4.png\" alt=\"\" width=\"600\" height=\"900\" \/><\/p><table><tbody><tr><td><b>Step<\/b><\/td><td><b>Description<\/b><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">1: \/document (POST)<\/span><\/td><td><span style=\"font-weight: 400;\">Call that uploads the document to be signed on the signer&#8217;s local server.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">2: hash calculation<\/span><\/td><td><span style=\"font-weight: 400;\">Summary of the document that was sent.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">3: \/signature<\/span><\/td><td>Call: that performs the signing of the document on the signatory&#8217;s local server.<\/td><\/tr><tr><td><span style=\"font-weight: 400;\">4: \/signature<\/span><\/td><td><span style=\"font-weight: 400;\">Call that performs the signing of the document on the Certillion server.<\/span><\/td><\/tr><tr><td>5: \/ document (GET)<\/td><td><span style=\"font-weight: 400;\">Call that downloads the signed document from the signatory&#8217;s local server.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">6: generates signed document<\/span><\/td><td><span style=\"font-weight: 400;\">Application requests the signed document from the signatory&#8217;s local server.<\/span><\/td><\/tr><\/tbody><\/table><h1>Certillion Signer<\/h1><p><span style=\"font-weight: 400;\">Cloud-based digital certificates eliminate the need for any application in the user environment that will sign the documents. The PSC environment, duly accredited for this purpose, processes digital certificates securely. When the user has traditional digital certificates (A1 in a file and A3 on a card or token), it is a serious security breach to ask them to provide the certificate to your system.\u00a0<\/span><\/p><p><span style=\"font-weight: 400;\">This can invalidate the signature and generate legal liability for the person who received it. To protect the system that requests the signature made with traditional certificates, the user must be asked to use the Certillion local signer. This application ensures that you generate the signature securely and in compliance with the standards. If you developed your system with the Certillion API, you do not need to change the integration code, as it is already compatible with the signer! Other great advantages of the Certillion signer:<\/span><\/p><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">No plugins are required for it to work in web systems;<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">It works on the main platforms: Windows, Mac, Android, iPhone, iPad and Linux;<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">It has no additional cost, and is even free to download;<\/span><\/li><\/ol><p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/07\/image-5.png\" alt=\"\" width=\"600\" height=\"994\" \/><\/p><table><tbody><tr><td><b>Step<\/b><\/td><td><b>Description<\/b><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">1: select the chosen PSC<\/span><\/td><td><span style=\"font-weight: 400;\">Select your PSC.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">2: forward the PSC chosen<\/span><\/td><td><span style=\"font-weight: 400;\">Send the PSC selected.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">3: \/authorize (returns authentication page)<\/span><\/td><td><span style=\"font-weight: 400;\">Authorization call to PSC to identify signer and Certillion.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">4: displays authentication page<\/span><\/td><td><span style=\"font-weight: 400;\">Application displays authentication page.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">5: provides authentication data<\/span><\/td><td><span style=\"font-weight: 400;\">Signer provides credentials.<\/span><\/td><\/tr><tr><td><span style=\"font-weight: 400;\">6: \/token<\/span><\/td><td><span style=\"font-weight: 400;\">Call to get the security code (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>Documentation Tutorials Tutorials Prerequisite Before starting testing with the Certillion API, some prerequisites are necessary: Obtain access credentials Have a valid ICP-Brasil certificate to test your integration or request a test certificate Install the Certillion app if the certificate is type A1 (file) or physical media A3 (card or token) The credentials can be obtained in the Contact, requesting a test account. When requesting a test account, you must send the following information: Company Name Visible name of the company (which will appear on the authentication screen for the user) CNPJ Technical Contact: name, email, telephone System Authentication To be able to call the Certillion API methods, you must first authenticate the system that will make the requests. With the credentials provided (see Prerequisites), authenticate using the method:\u00a0 Step Description 1: \/client_token Call for authentication using credentials. List of Supported Cloud Certificates Certillion supports all cloud certificate providers in ICP-Brasil (PSC \u2013 Trust Service Providers). The Certillion server provides and automatically updates the complete list of PSC identifiers. \u00a0 Step Description 1: access the login page via digital certificate Access the page using your PSC. 2: Request the login page Make the authentication request. 3: \/psc-info Call that searches for all PSCs compatible with Certillion. The developer can use this list to generate the interface for their user, so that they can easily identify and use digital certificates through Certillion. Location of Certificates Using the API, it is also possible to locate the certificates that the user has in the cloud, based on the legal identifier that you want to search for. Step Description 1: enter CPF or CNPJ Legal identifier required to search for the PSC. 2: request list of PSCs Request for PSCs using the legal identifier. 3: \/find-psc-accounts Call that finds PSC accounts using a legal identifier. Note: This method will return a list whose entries are the result of the search in each of the PSCs. Each entry in this list will contain the PSC identifier and a status indicating whether the user has a certificate (status=\u201dY\u201d). If all entries have the status=\u201dN\u201d, the only option offered to the user is to sign using the Certillion app with local certificates, A1 in a file or A3 on physical media (card or token). User Authentication (Signatory) Before signing any document, the user must authorize access to their digital certificate. Step Description 1: select the PSC Selects your PSC. 2: Forwards the chosen PSC Sends the selected PSC. 3: \/authorize (returns authentication page) Authorization call for the PSC to identify the signer and Certillion. 4: Displays authentication page Application displays authentication page authentication. 5: provides authentication data Signatory provides credentials. 6: \/token Call to obtain the security code (token). You can grant authorization in three ways: single_signature: User grants authorization for the system to execute ONE request for signing ONE document. multiple_signature: User grants authorization for the system to execute ONE request for a batch of documents (ONE or more). signature_session: User grants authorization for the system to execute, for a specific period of time, as many requests as desired. Each request can be for a batch of one or more files. Signing Documents Follow the steps outlined in the diagram below to sign the document. Step Description 1: Click sign Signer selects option to sign. 2: Request signature Calls the method that requests the document signature. 3: \/document (POST) Call that uploads the document to be signed. 4: \/signature Call that signs the document. 5: \/document (GET) Call that downloads the signed document. To sign a document by multiple people, you do a single initial upload, followed by requesting signatures from each person sequentially. You do not need to repeat all the steps three times; simply request the signature from each signer. Important! Correct Error Handling If any of the 3 methods used above for signing fails, repeat ONLY the call to that method: if the 2nd method \/signature fails, call only this method, it is NOT necessary to upload the file again if the 3rd method \/document (get) fails, just make another call to download the signed document, it is NOT necessary to upload it again or request a new signature Repeating requests that were processed correctly may generate additional charges for the system that requests the signatures. Signature Verification Certillion verifies any ICP-Brasil digital signature, even if an external system made the signature. To do this, use the \/verify call. Step Description 1: \/document (POST) Uploads the document to be signed. 2: \/verify Call that verifies any digital signature ICP-Brasil. To check the possible return codes from Certillion, consult the Online API in the method Status Codes returned by calls to Certillion Confidentially and Performace Optimization As seen in the signing process, you must send the document to the servers Certillion for it to be signed or verified. After signing, the document must also be signed. At Certillion, we guarantee the confidentiality of documents through the following practices: no processing is performed beyond what is necessary for the processing of the digital signature; no information contained in the documents is extracted or analyzed, even anonymously; the document is stored in encrypted form on the servers; the document remains on the servers for at least 24 hours and a maximum of 48 hours so that it can be downloaded after signing, after which it is irreversibly deleted. Despite this, when using the Certillion cloud server, some applicants may prefer, however, not to have to send documents to a third-party service. Through the Certillion Agent component, it is possible for the document to be pre-processed in the applicant&#8217;s environment, avoiding the need for uploading. Similarly, after completing the signature, the system generates the signed document locally. This approach has the following advantages: Compliance with possible company regulations of not externalizing documents with confidential or private information; Signing is faster because it is not necessary to transmit the documents in both directions. No need to change the integration code, the Certillion Agent is a network-neutral component. After<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":8994,"menu_order":26,"comment_status":"closed","ping_status":"closed","template":"templates\/page-builder-content.php","meta":{"footnotes":""},"class_list":["post-9081","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>Tutorials - Certillion<\/title>\n<meta name=\"description\" content=\"Tutorials available with the main questions related to the Certillion API.\" \/>\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=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Tutorials\" \/>\n<meta property=\"og:description\" content=\"Tutorials available with the main questions related to the Certillion API.\" \/>\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-17T15:54:50+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6.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=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"8 minutes\" \/>\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\":\"Tutorials - 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.png\",\"datePublished\":\"2024-04-07T21:27:50+00:00\",\"dateModified\":\"2024-12-17T15:54:50+00:00\",\"description\":\"Tutorials available with the main questions related to the Certillion API.\",\"breadcrumb\":{\"@id\":\"https:\/\/certillion.com\/certillion-api\/tutoriais\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/certillion.com\/certillion-api\/tutoriais\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/certillion.com\/certillion-api\/tutoriais\/#primaryimage\",\"url\":\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6.png\",\"contentUrl\":\"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6.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\/en\/api\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Tutorials\"}]},{\"@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\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/certillion.com\/#organization\",\"name\":\"E-sec Seguran\u00e7a Digital\",\"url\":\"https:\/\/certillion.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@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":"Tutorials - Certillion","description":"Tutorials available with the main questions related to the Certillion API.","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":"en_US","og_type":"article","og_title":"Tutorials","og_description":"Tutorials available with the main questions related to the Certillion API.","og_url":"https:\/\/certillion.com\/certillion-api\/tutoriais\/","og_site_name":"Certillion","article_publisher":"https:\/\/www.facebook.com\/certillion","article_modified_time":"2024-12-17T15:54:50+00:00","og_image":[{"width":2441,"height":639,"url":"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"8 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/certillion.com\/certillion-api\/tutoriais\/","url":"https:\/\/certillion.com\/certillion-api\/tutoriais\/","name":"Tutorials - 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.png","datePublished":"2024-04-07T21:27:50+00:00","dateModified":"2024-12-17T15:54:50+00:00","description":"Tutorials available with the main questions related to the Certillion API.","breadcrumb":{"@id":"https:\/\/certillion.com\/certillion-api\/tutoriais\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/certillion.com\/certillion-api\/tutoriais\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/certillion.com\/certillion-api\/tutoriais\/#primaryimage","url":"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6.png","contentUrl":"https:\/\/certillion.com\/wp-content\/uploads\/2024\/12\/image-6.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\/en\/api\/"},{"@type":"ListItem","position":3,"name":"Tutorials"}]},{"@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":"en-US"},{"@type":"Organization","@id":"https:\/\/certillion.com\/#organization","name":"E-sec Seguran\u00e7a Digital","url":"https:\/\/certillion.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@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\/en\/wp-json\/wp\/v2\/pages\/9081","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/certillion.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/certillion.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/certillion.com\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/certillion.com\/en\/wp-json\/wp\/v2\/comments?post=9081"}],"version-history":[{"count":0,"href":"https:\/\/certillion.com\/en\/wp-json\/wp\/v2\/pages\/9081\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/certillion.com\/en\/wp-json\/wp\/v2\/pages\/8994"}],"wp:attachment":[{"href":"https:\/\/certillion.com\/en\/wp-json\/wp\/v2\/media?parent=9081"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}