en English
X

Select Language

Powered by Google TranslateTranslate

We hope you will find the Google translation service helpful, but we don’t promise that Google’s translation will be accurate or complete. You should not rely on Google’s translation. English is the official language of our site.

en English
X

Select Language

Powered by Google TranslateTranslate

We hope you will find the Google translation service helpful, but we don’t promise that Google’s translation will be accurate or complete. You should not rely on Google’s translation. English is the official language of our site.

Fjärranslutning av dokument med eSigner CSC API

Den här guiden visar dig hur du registrerar en beställning av en dokumentsigneringscertifikat hos SSL.com eSigner tjänsten och använd Cloud Signature Consortium (CSC) API för att digitalt signera en dokumenthash och en PDF-fil. Du kan använda den här guiden med någon av dem ringla or Postman. Vi rekommenderar att Postman-användare installerar skrivbordsprogram för att arbeta igenom exemplen.

Exemplen i den här guiden använder SSL.coms produktions-eSigner-miljö. Om du vill experimentera med CSC API i SSL.coms Sandbox-testmiljö innan du arbetar med riktiga certifikatbeställningar, läs igenom Integrationsguide för testning av fjärrsignering med eSigner CSC API. Läs om du vill prova eSigner Sandbox med ett demo-konto och certifikat eSigner Demo-referenser och certifikat för referenser och konfigurationsinformation.

För att följa dessa instruktioner behöver du:

  • En validerad certifikatorder för dokumentsignering. Vänligen läs det här för fullständiga instruktioner om beställning och validering.
  • A kund-ID (även känd som en ansöknings-ID. Se till det här för instruktioner om hur du skapar denna referens).

Registrera dig i eSigner och konfigurera tvåfaktorautentisering

  1. Innan du kan börja använda CSC API måste du registrera dig för eSigner. Navigera till Beställningar fliken i ditt SSL.com-konto och hitta din beställning.
    Hitta ordning
  2. Klicka på beställningens detaljer länken.
    detaljer
  3. Skapa en och bekräfta en fyrsiffrig PIN-kod och klicka sedan på skapa PIN knapp.
    Läs om du behöver återställa din eSigner-PIN det här.
    Skapa PIN-kod
  4. En QR-kod visas.
    Nästa gång du laddar om sidan visas inte QR-koden. Läs om du behöver visa eller återställa din eSigner QR-kod det här.
    QR-kod
  5. Skanna koden till en 2-faktor autentiseringsapp på din mobila enhet, t.ex. Google Authenticator or Authy. Appen ger dig engångslösenord (OTP) för användning vid signering. Varje OTP är giltig i 30 sekunder.
    OTP i Authy
Dricks: Du kan använda eSigner för att dela organisationsvaliderade (OV) signeringscertifikat mellan lagkamrater. Vänligen läs Team Sharing för eSigner-dokument och EV-kodsigneringscertifikat för instruktioner.

Installera Postman och Import API-samlingar

Instruktionerna i detta avsnitt är endast avsedda för Postman-användare. Om du använder cURL med CSC API kan du gå vidare till nästa avsnitt.

  1. Ladda ner och packa upp den CSC API Postman-samling och Document Signering API Postman collection.
    Postboksamlingar
  2. Hämta och installera Postman REST Client.
    Postman REST Client nedladdning
  3. Starta Postman och skapa sedan ett nytt Postman-konto eller logga in på ett befintligt.
    Postman-inloggning
  4. Klicka på Importera knapp.
    Importera-knappen
  5. Klicka på Ladda upp filer , navigera till de unzippade API-samlingsfilerna (csc-api-prod.postman_collection.json och document-signing-api-prod.postman_collection.json) och öppna dem.
    Ladda upp filer
  6. Klicka på Importera knapp.
    Klicka på importknappen
  7. API-förfrågningarna du kommer att arbeta med finns nu tillgängliga i Kollektioner på vänster sida av brevbärarfönstret.
    API-förfrågningar

Hämta åtkomsttoken

Nästa steg är att hämta en åtkomsttoken från SSL.com. Du behöver din kund-ID tillgängligt, samt användarnamn och lösenord för ditt SSL.com-konto. Åtkomsttoken är giltigt i en timme efter det att de har utfärdats.

Använd de klickbara flikarna nedan för att välja instruktioner för Postman eller cURL:

Postman InstruktionerCURL-instruktioner
  1. Välj en API-begäran från CSC API-samlingen.
    välj API-begäran
  2. Välj Tillstånd Fliken och välj OAuth 2.0 från Typ meny.
    Fliken auktorisering
  3. Ange följande information i formuläret:
    • Rubrikprefix: Bearer
    • Tokenamn: SSLCOM CSC (eller något annat lätt att komma ihåg namn som du föredrar)
    • Bidragstyp: Authorization Code
    • Återuppringnings-URL: https://upload.esigner.com
    • Auktorisera med webbläsare: omarkerad
    • Auth-URL: https://login.ssl.com/oauth2/authorize
    • URL för åtkomsttoken: https://login.ssl.com/oauth2/token
    • Klient ID: [Ditt klient-ID]
    • Kundhemlighet: [lämna tom]
    • Omfattning: service
    • Ange: [lämna tom]
    • Klientautentisering: Send as Basic Auth header

    När du är klar klickar du på Skaffa ny åtkomsttoken knapp.
    Skaffa ny åtkomsttoken

  4. Ett inloggningsformulär visas. Ange ditt SSL.com-användarnamn och lösenord och klicka sedan på Logga in knapp.
    Kontoinloggning
  5. Din nya åtkomsttoken ska visas i Postman. Välj åtkomsttokenstext och kopiera den till Urklipp och stäng sedan Hantera åtkomsttoken dialog ruta. Klistra in din åtkomsttoken i en textredigerare där du enkelt kan komma åt den. Varje åtkomsttoken upphör efter en timme.
    Du kan också spara din token för återanvändning i Postman-förfrågningar, men vi har funnit att det är mest pålitligt att kopiera och klistra in token direkt i varje begäran.
    tillgång Token
  1. Använd följande kommando för att begära en åtkomsttoken. Ersätt värdena som visas i ALL-CAPS med dina faktiska värden:
    curl --location --request POST "https://login.ssl.com/oauth2/token" \ --header "Content-Type: application / json" \ --data-raw "{\" client_id \ ": \ "DITT-KLIENT-ID \", \ "grant_type \": \ "lösenord \", \ "användarnamn \": \ "DITT-ANVÄNDarnamn \", \ "lösenord \": \ "DITT-LÖSENORD \"} "
  2. Du bör få ett JSON-objekt som innehåller en åtkomsttoken och en uppdateringstoken. Kopiera åtkomsttokenvärdet för att klistra in i dina API-förfrågningar. Du behöver inte uppdateringstoken för dessa exempel.
    Hämta åtkomsttoken

Skriv en Hash

Nu när du har en åtkomsttoken kan du börja göra API-förfrågningar och skapa signaturer. Detta avsnitt leder dig genom de fem tillgängliga förfrågningarna i Postman CSC-samlingen, vilket resulterar i skapandet av en digital signatur från en dokumenthash.

Få CSC-information (valfritt)

Postman InstruktionerCURL-instruktioner
  1. Du kan använda CSC -information begär att få information om SSL.coms molntypservice. Observera att, till skillnad från de andra i samlingen, kräver denna begäran inte din åtkomsttoken. Välj för att skicka begäran CSC -information från CSC API samling och klicka sedan på Skicka knapp.
    Skicka CSC-informationsförfrågan
  2. Information om molnsignaturtjänsten visas i ett JSON-objekt i Postmans Svar fält.
    CSC -information
  1. Använd följande kommando för att få information om SSL.coms CSC API-tjänst:
    curl --location --request POST "https://cs.ssl.com/csc/v0/info" \ --header "Content-Type: application / json" \ --data-raw "{}"
  2. Du får ett JSON-objekt med information om tjänsten:
    Få CSC-information

CSC-referenslista

Du har nu möjlighet  CSC-referenslista begäran hämtar en referens som du använder i senare API-förfrågningar.

Postman InstruktionerCURL-instruktioner
  1. Välja CSC-referenslista och klicka på Tillstånd fliken.
    Fliken auktorisering
  2. Välja Bärartoken från Typ menyn, klistra in din åtkomsttoken i Pollett och klicka sedan på Skicka knapp.
    Skicka begäran om autentiseringslista
  3. Ett JSON-objekt med en lista över referens-ID: n som är associerade med användaren visas i Svar fält. Din lista kommer antagligen att innehålla ett värde. Kopiera och klistra in ditt referens-ID i en textredigerare för användning i senare förfrågningar.
    Inloggnings-ID
  1. Ange följande kommando. (Ersätt MY-ACCESS-TOKEN med din faktiska åtkomsttoken):
    curl --location --request POST "https://cs.ssl.com/csc/v0/credentials/list" \ --header "Content-Type: application / json" \ --header "Authorization: Bearer MY- ACCESS-TOKEN "\ --data-raw" {} "
  2. Du bör få ett JSON-objekt med en lista över autentiserings-ID som är associerade med användaren. Din lista kommer antagligen att innehålla ett värde. Kopiera och klistra in ditt referens-ID i en textredigerare för användning i senare förfrågningar.
    Inloggnings-ID

Information om CSC-referenser (valfritt)

Du har nu möjlighet Information om CSC-referenser begäran returnerar certifikat och annan information som är associerad med ett referens-ID och krävs inte för signering.

Postman InstruktionerCURL-instruktioner
  1. För att använda denna begäran, välj Information om CSC-referenser från samlingen och klicka på Tillstånd fliken.
    fliken auktorisering
  2. Välja Bärartoken från Typ menyn och klistra sedan in din åtkomsttoken i Pollett fält.
    Klistra in token
  3. Välj Kaross fliken och klistra sedan in ditt referens-ID som värdet för credentialID.
    Klistra in referens-ID
  4. Klicka på Skicka knapp.
    Skicka
  5. Ett JSON-objekt med din signaturcertifikatkedja och annan information visas i Svar fält.
    Information om referenser
  1. Ange följande kommando. Byta ut MY-ACCESS-TOKEN och MY-CREDENTIAL-ID med din faktiska information:
    curl --location --request POST "https://cs.ssl.com/csc/v0/credentials/info" \ --header "Content-Type: application / json" \ --header "Auktorisering: Bearer MY- ACCESS-TOKEN "\ --data-raw" {\ "credentialID \": \ "MY-CREDENTIAL-ID \", \ "certifikat \": \ "kedja \", \ "certInfo \": sant, \ " authInfo \ ": true}"
  2. Du bör få ett JSON-objekt med din signeringscertifikatkedja och annan information:
    Information om CSC-referenser

Autentiseringsuppgifter Auktoriserar

Du har nu möjlighet Autentiseringsuppgifter Auktoriserar begäran hämtar auktorisation för att underteckna en hash.

Postman InstruktionerCURL-instruktioner
  1. Börja med att välja Autentiseringsuppgifter Auktoriserar från samlingen och klicka på Tillstånd fliken.
    Fliken auktorisering
  2. Välja Bärartoken från Typ menyn och klistra sedan in din åtkomsttoken i Pollett fält.
    klistra in token
  3. Välj Kaross flik. Klistra in ditt referens-ID som credentialID värde och en hash av det dokument som du vill underteckna som hash värde. Hämta och ange en OTP från din autentiseringsapp och ange den som värdet för OTP, klicka sedan på Skicka knapp.
    Kroppsflik
  4. Ett JSON-objekt med dina signaturaktiveringsdata (SAD) visas i Svar fält. Kopiera och klistra in det här värdet i en textredigerare för användning i hashsigneringsförfrågan.
    SAD
  1. Använd följande kommando. Byta ut MY-ACCESS-TOKEN, MY-CREDENTIAL-IDoch MY-HASH med din faktiska information. Få ett engångslösenord från din 2FA-applikation och användningen är värdet för MY-OTP.
    curl --location --request POST "https://cs.ssl.com/csc/v0/credentials/authorize" \ --header "Content-Type: application / json" \ --header "Auktorisering: Bearer MY- ACCESS-TOKEN "\ --data-raw" {\ "credentialID \": \ "MY-CREDENTIAL-ID \", \ "numSignatures \": 1, \ "hash \": [\ "MY-HASH \" ], \ "OTP \": \ "MY-OTP \"} "
  2. Du bör få ett JSON-objekt med dina signaturaktiveringsdata (SAD). Kopiera och klistra in detta värde i en textredigerare för användning i hashsigneringsförfrågan.
    Autentiseringsuppgifter Auktoriserar

Signera Hash

Nu är du redo att underteckna dokumenthashen.

Postman InstruktionerCURL-instruktioner
  1. Välja Signera Hash från samlingen och välj sedan Tillstånd fliken.
    Fliken auktorisering
  2. Välja Bärartoken från Typ menyn och klistra sedan in din åtkomsttoken i Pollett fält.
    Klistra in token
  3. Välj Kaross flik. Klistra in ditt referens-ID som credentialID värde, dina signaturaktiveringsdata som SAD värde och en hash av dokumentet som du vill underteckna som hash och klicka sedan på Skicka knapp.
    Kroppsflik
  4. Ett JSON-objekt med din signatur kommer att visas i Svar fält.
    namnteckning
  1. Ange följande kommando. Byta ut MY-ACCESS-TOKENMY-CREDENTIAL-ID, MY-SADoch MY-HASH med din faktiska information:
    curl --location --request POST "https://cs.ssl.com/csc/v0/signatures/signHash" \ --header "Content-Type: application / json" \ --header "Auktorisering: Bearer MY- ACCESS-TOKEN "\ --data-raw" {\ "credentialID \": \ "MY-CREDENTIAL-ID \", \ "SAD \": \ "MY-SAD \", \ "hash \": [\ "MY-HASH \"], \ "signAlgo \": \ "1.2.840.113549.1.1.11 \"} "
  2. Du bör få ett JSON-objekt som innehåller din signatur.
    Tecken hash

Skriv en PDF

Förutom att underteckna dokumenthashar kan du också ladda upp och signera en PDF-fil.

När du signerar en PDF kommer du att arbeta med två POST-förfrågningar:

  • Ladda upp PDF-dokument
  • Underteckna PDF-dokument

Samling av API för dokumentsignering

Du kan återanvända referensen du hämtat ovan med CSC-referenslista begäran. Du kommer antagligen också att behöva hämta en ny access token.

Ladda upp PDF-dokument

Postman InstruktionerCURL-instruktioner
  1. Välj Ladda upp PDF-dokument begäran och klicka på Tillstånd fliken.
    Fliken auktorisering
  2. Välja Bärartoken från Typ menyn och klistra sedan in din åtkomsttoken i Pollett fält.
    Klistra in token
  3. Välj Headers fliken och klistra in ditt referens-ID i Värde kolonn.
    Fliken rubriker
  4. Välj Kaross fliken och klicka på × bredvid hello.pdf för att ta bort det här platshållarens filnamn.
    ta bort exempel filnamn
  5. Klicka på Välj fil och sedan navigera till filen du vill ladda upp.
    Välj fil
  6. Klicka på Skicka knapp.
    Skicka
  7. Välj och kopiera id värde i svaret som ska användas i nästa begäran.
    ID
  1. Använd följande kommando. Byta ut MY-CREDENTIAL-ID, MY-ACCESS-TOKENoch /PATH/TO/FILE.pdf med din faktiska information:
    curl --location --request POST "https://ds.ssl.com/v1/pdf/upload" \ --header "Credential-Id: MY-CREDENTIAL-ID" \ --header "Authorization: Bearer MY- ACCESS-TOKEN "\ --header" Content-Type: application / pdf "\ --data-binary" @ / PATH / TO / FILE.pdf "
  2. Du får ett JSON-objekt med ett värde för id. Kopiera detta värde för att använda i nästa begäran.
    Ladda upp PDF

Underteckna PDF-dokument

Nu kan du underteckna PDF-filen.

Postman InstruktionerCURL-instruktioner
  1. Välj Ladda upp PDF-dokument begäran och klicka på Tillstånd fliken.
       Tillstånd
  2. Välja Bärartoken från Typ menyn och klistra sedan in din åtkomsttoken i Pollett fält.
    Klistra in token
  3. Välj fliken Kropp, klistra in i id värde från föregående steg och en OTP från din autentiseringsapp och klicka sedan på Skicka knapp.
    Skicka förfrågan
  4. PDF-uppgifterna visas nedan i Svar fält. Välja Spara i en fil från Spara svar menyn och ge sedan filen ett namn.
    Spara PDF i fil
  5. Öppna filen i Acrobat för att bekräfta att filen har signerats.
    Giltig signatur
  1. Ange följande kommando. Byta ut MY-CREDENTIAL-ID, MY-FILE-IDoch OUTPUT-FILENAME med din faktiska information. Få ett engångslösenord (OTP) från din 2FA-app och ange det som MY-OTP:
    curl --location --request POST 'https://ds.ssl.com/v1/pdf/sign' \ --header 'Content-Transfer-Encoding: application / json' \ --header 'Content-Type: application / json '\ --header' Auktorisering: Bearer MY-ACCESS-TOKEN '\ --data-raw' {"id": "MY-FILE-ID", "otp": "MY-OTP"} '\ - -utgång OUTPUT-FILENAME
  2. cURL hämtar den signerade filen och sparar den i det angivna filnamnet:
    Underteckna PDF
  3. Öppna PDF-filen i Acrobat eller Acrobat Reader för att kontrollera att signaturen är giltig.
    Giltig signatur

Behöver du ett certifikat? SSL.com erbjuder ett brett utbud av digitala certifikat, inklusive:

JÄMFÖR SSL /TLS INTYG

Dela på twitter
Twitter
Dela på facebook
Facebook
Dela på Linkedin
Link
Resurs på Reddit
reddit
Dela på e-post
E-post