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.

Integrationsguide för testning av fjärrsignering med eSigner CSC API

Den här guiden leder dig genom att signera en dokumenthash och PDF-fil med SSL.com eSigner molnsigneringstjänst och Cloud Signature Consortium (CSC) API. Alla API-förfrågningsexempel visas med Postman, och vi rekommenderar att du installerar Postman stationär app på din dator om du vill arbeta igenom exemplen. cURL-kommandoexempel på API-förfrågningar ingår också.

Den här guiden omfattar användning av CSC API i SSL.com sandlåda testmiljö, så att du gärna kan experimentera med API: t utan att oroa dig för att bli fakturerad. Se vår Sandlådeguide för instruktioner om hur du konfigurerar ditt Sandbox-konto.

Läs om du är redo att arbeta med CSC API i SSLcoms produktions eSigner-miljö Fjärranslutning av dokument med eSigner CSC API.

Skapa en testorder

Om du vill hoppa över att skapa ett Sandbox-konto och testorder kan du också prova eSigner Sandbox med ett demo-konto och certifikat. Vänligen läs eSigner Demo-referenser och certifikat för referenser och konfigurationsinformation.
  1. Först måste du skapa en dokumentsigneringsorder i Sandbox. Börja med att logga in på ditt Sandbox-konto och gå till Dashboard fliken.
    Sandlåda instrumentpanel
  2. Klicka utvecklingsverktyg.
    utvecklingsverktyg
  3. Välja eSigner Dokumentsignering, klicka sedan på Skapa testorder knapp.
  4. En dialogruta visas. Klicka på OK knapp.
  5. Leta reda på din testorder och klicka sedan på detaljer länken.
    detaljer länk
  6. Klicka redigera registrant för att börja ange sökande och mottagarinformation för din testorder. Observera att eftersom denna information inte kommer att användas för att utfärda ett giltigt dokumentsigneringscertifikat kan du ange fiktiv information om så önskas.
    redigera registrant
  7. Lägg till sökandes information för testcertifikatet och klicka sedan på Nästa >> knapp.
    Sökande Information
  8. Ange mottagarinformation och klicka sedan på Nästa >> knapp.
    mottagar information
  9. Klicka på Hoppa -knappen för att hoppa över uppladdning av valideringsdokument för testcertifikatet.
    Hoppa över knapp
  10. Din testorder ska nu ha status som väntande validering. Kontakta SSL.com supportteam på Support@SSL.com för att få ditt testcertifikat validerat.
    väntande validering

Registrera dig i eSigner och konfigurera tvåfaktorautentisering

  1. När din testorder har validerats av SSL.com supportpersonal kan du registrera den i eSigner. Navigera till Beställningar fliken i ditt SSL.com sandbox-konto och leta reda på din testorder.
    Navigera till beställning
  2. Klicka på beställningens detaljer länken.
    detaljer länk
  3. Skapa 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, till exempel Google Authenticator eller Authy. Appen ger dig engångslösenord (OTP) för användning vid signering. Varje OTP är giltig i 30 sekunder.
    OTP i Authy

Installera Postman och importera CSC API Collection

  1. Ladda ner och packa upp den CSC API Postman-samling.
    CSC API Postman Collection
  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 den unzippade API-samlingsfilen (CSC-API.postman_collection.json) och öppna den.
    Ladda upp filer
  6. Klicka på Importera knapp.
    Importera-knappen
  7. Klicka på Kollektioner fliken i Postman och utöka CSC API-samlingen för att se de fem POST-förfrågningarna du kommer att arbeta med:
    • CSC -information
    • CSC-referenslista
    • Information om CSC-referenser
    • Autentiseringsuppgifter Auktoriserar
    • Signera Hash

    CSC API -samling

Hämta åtkomsttoken

  1. Nästa steg är att hämta en åtkomsttoken från SSL.com. Innan du begär din åtkomsttoken behöver du en kund-ID (även känd som en ansöknings-ID. Se till det här för instruktioner om hur du skapar denna referens).
  2. Välj Tillstånd fliken, välj OAuth 2.0 från Typ och klicka på Skaffa ny åtkomsttoken knapp.
    Skaffa ny åtkomsttoken
  3. Ange följande information i formuläret:
    • Tokenamn: SandBox CSC (eller något annat lätt att komma ihåg namn som du föredrar)
    • Bidragstyp: Behörighetskod
    • Återuppringnings-URL: [lämna tom]
    • Auktorisera med webbläsare: kontrollerade
    • Auth-URL: https://oauth-sandbox.ssl.com/oauth2/authorize
    • URL för åtkomsttoken: https://oauth-sandbox.ssl.com/oauth2/token
    • Klient ID: [Ditt klient-ID]
    • Kundhemlighet: [lämna tom]
    • Omfattning: SERVICE
    • Ange: [lämna tom]
    • Klientautentisering: Skicka som Basic Auth-rubrik

    När du är klar klickar du på Begär token knapp.
    Få ny åtkomsttoken

  4. Ett inloggningsformulär visas i din webbläsare. Ange ditt SSL.com-användarnamn och lösenord och klicka sedan på Logga in knapp.
    Kontoinloggningsformulär
  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

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)

  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.
    CSC-informationsförfrågan
  2. Information om molnsignaturtjänsten visas i ett JSON-objekt i Postmans Svar fält.
    CSC -information

cURL-kommando

curl --location --request POST "https://cs-try.ssl.com/csc/v0/info" \ --header "Content-Type: application / json" \ --data-raw "{}"

CSC-referenslista

  1. Du har nu möjlighet  CSC-referenslista begäran hämtar en referens som du kommer att använda i senare API-förfrågningar. Välj CSC-referenslista och klicka på Tillstånd fliken.
    CSC-referenslista
  2. Välja Bärartoken från Typ menyn, klistra in din åtkomsttoken i Pollett och klicka sedan på Skicka knapp.
    Lägg till token och skicka begäran
  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

cURL-kommando

ersätta MY-ACCESS-TOKEN med din faktiska åtkomsttoken:

curl --location --request POST "https://cs-try.ssl.com/csc/v0/credentials/list" \ --header "Content-Type: application / json" \ --header "Authorization: Bearer MY-ACCESS-TOKEN "\ --data-raw" {} "

Information om CSC-referenser (valfritt)

  1. 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. För att använda denna begäran, välj Information om CSC-referenser från samlingen och klicka på Tillstånd fliken.
    Information om CSC-referenser
  2. Välja Bärartoken från Typ menyn och klistra sedan in din åtkomsttoken i Pollett fält.
    klistra in auktoriseringstoken
  3. Välj Kaross fliken och klistra sedan in ditt referens-ID som värdet för credentialID.
    Ange legitimations-ID
  4. Klicka på Skicka knapp.
    Klicka på knappen Skicka
  5. Ett JSON-objekt med din signaturcertifikatkedja och annan information visas i Svar fält.
    Referens-ID-information

cURL-kommando

ersätta MY-ACCESS-TOKEN och MY-CREDENTIAL-ID med din faktiska information:

curl --location --request POST "https://cs-try.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} "

Autentiseringsuppgifter Auktoriserar

  1. Du har nu möjlighet Autentiseringsuppgifter Auktoriserar begäran hämtar auktorisation för att underteckna en hash. Börja med att välja Autentiseringsuppgifter Auktoriserar från samlingen och klicka på Tillstånd fliken.
    Autentiseringsuppgifter Auktoriserar
  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.
    ange autentiserings-id, hash och OTP
  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

cURL-kommando

ersätta MY-ACCESS-TOKENMY-CREDENTIAL-ID, MY-HASHoch MY-OTP med din faktiska information:

curl --location --request POST "https://cs-try.ssl.com/csc/v0/credentials/authorize" \ --header "Content-Type: application / json" \ --header "Authorization: Bearer MY-ACCESS-TOKEN "\ --data-raw" {\ "credentialID \": \ "MY-CREDENTIAL-ID \", \ "numSignatures \": 1, \ "hash \": [\ "MY-HASH \ "], \" OTP \ ": \" MY-OTP \ "}

Signera Hash

  1. Nu är vi redo att underteckna dokumenthash. Välj Signera Hash från samlingen och välj sedan Tillstånd fliken.
    Signera Hash
  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.
    Klistra in SAD och hash, skicka begäran
  4. Ett JSON-objekt med din signatur kommer att visas i Svar fält.
    namnteckning

cURL-kommando

ersätta MY-ACCESS-TOKENMY-CREDENTIAL-ID, MY-SADoch MY-HASH med din faktiska information:

curl --location --request POST "https://cs-try.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 \"} "

Skriv en PDF

Förutom att underteckna dokumenthashar kan du också ladda upp och signera en PDF-fil. Börja med att ladda ner och importera Document Signering API Postman collectionefter samma installationssteg du följde ovan för CSC API -samlingen.

OTP -behörighet krävs inte vid signering med ett certifikat för signering av esealing -dokument. Ignorera alla OTP -parametrar i följande guide om du använder ett esealing -dokument som signerar certifikat.
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

  1. Välj Ladda upp PDF-dokument begäran och klicka på Tillstånd fliken.
    Ladda upp PDF-dokument
  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.
    lägg till referens-ID i rubriken
  4. Välj Kaross fliken och klicka på × bredvid hello.pdf för att ta bort det här platshållarens filnamn.
    ta bort platshållarfilen
  5. Klicka på Välj fil och sedan navigera till filen du vill ladda upp.
    Välj fil
  6. Klicka på Skicka knapp.
    Skicka förfrågan
  7. Välj och kopiera id värde i svaret som ska användas i nästa begäran.
    fil-ID

cURL-kommando

ersätta MY-CREDENTIAL-ID, MY-ACCESS-TOKENoch /PATH/TO/FILE.pdf med din faktiska information:

curl --location --request POST "https://ds-try.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 "

Underteckna PDF-dokument

  1. Nu kan du underteckna PDF-filen. Välj Ladda upp PDF-dokument begäran och klicka på Tillstånd fliken.
      
  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 Body och klistra in i id värde från föregående steg.
    ange ID
  4. Ange en OTP från din autentiseringsapp och klicka på Skicka knapp.
    ange OTP och klicka på Skicka
  5. 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 i en fil
  6. Öppna filen i Acrobat för att bekräfta att filen har signerats. (Observera att SSL.coms RSA-utvecklingsrot på skärmdumpen nedan har varit betrodd manuellt i Acrobat.)
    digital signatur i Adobe Acrobat

cURL-kommando

ersätta MY-CREDENTIAL-ID, MY-FILE-IDoch MY-OTP med din faktiska information:

curl --location --request POST "https://ds-try.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 \"} "

 Går live med produktion

För att gå live måste du ta bort "-try" från underdomänen. Till exempel, för att gå live med ds-try.ssl.com, ta bort "-try" så att underdomänen blir ds.ssl.com.

 

eSIGNERINFORMATION OCH PRISER

 

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