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.

Integratiegids voor het testen van ondertekening op afstand met eSigner CSC API

Deze handleiding helpt u bij het ondertekenen van een document-hash en pdf-bestand met SSL.com's eSigner cloud-ondertekeningsservice en de Cloud Signature Consortium (CSC) API. Alle voorbeelden van API-verzoeken worden weergegeven met Postbode, en we raden aan om het Postman desktop-app op uw computer als u de voorbeelden wilt doornemen. cURL-opdrachtvoorbeelden van de API-verzoeken zijn ook opgenomen.

Deze gids behandelt het gebruik van de CSC API in SSL.com's sandbox testomgeving, zodat u gerust kunt experimenteren met de API zonder dat u zich zorgen hoeft te maken over kosten. Raadpleeg onze Sandbox-gids voor instructies over het instellen van uw Sandbox-account.

Als u klaar bent om met de CSC-API te werken in de eSigner-productieomgeving van SSLcom, lees dan Ondertekening van documenten op afstand met eSigner CSC API.

Maak een testorder

Als u het aanmaken van een Sandbox-account en testbestelling wilt overslaan, kunt u de eSigner Sandbox ook proberen met een demo-account en certificaat. Gelieve te lezen Inloggegevens en certificaten voor eSigner-demo voor referenties en configuratie-informatie.
  1. Eerst moet u een documentondertekeningsopdracht aanmaken in de Sandbox. Begin door in te loggen op uw Sandbox-account en naar het Dashboard Tab.
    Sandbox-dashboard
  2. Klik ontwikkeltools.
    ontwikkeltools
  3. kies eSigner-documentondertekening, klik dan op de knop Testorder maken knop.
  4. Er verschijnt een dialoogvenster. Klik op de OK knop.
  5. Zoek uw testbestelling en klik op het gegevens link.
    details link
  6. Klik registrant bewerken om te beginnen met het invoeren van informatie over de aanvrager en ontvanger voor uw testbestelling. Merk op dat aangezien deze informatie niet zal worden gebruikt om een ​​geldig documentondertekeningscertificaat af te geven, u indien gewenst fictieve informatie kunt invoeren.
    registrant bewerken
  7. Voeg informatie over de aanvrager toe voor het testcertificaat en klik op het Volgende >> knop.
    Informatie voor aanvragers
  8. Voer de informatie van de ontvanger in en klik op het Volgende >> knop.
    informatie voor ontvanger
  9. Klik op de overslaan om het uploaden van validatiedocumenten voor het testcertificaat over te slaan.
    Skip-knop
  10. Uw testbestelling zou nu de status moeten hebben van in afwachting van goedkeuring. Neem contact op met het ondersteuningsteam van SSL.com op Support@SSL.com om uw testcertificaat te laten valideren.
    in afwachting van goedkeuring

Schrijf u in voor eSigner en stel twee-factorenauthenticatie in

  1. Zodra uw testbestelling is gevalideerd door het ondersteuningspersoneel van SSL.com, kunt u deze in eSigner registreren. Navigeer naar het Bestellingen tab in uw SSL.com sandbox-account en zoek uw testbestelling.
    Navigeer naar bestelling
  2. Klik op de bestelling gegevens link.
    details link
  3. Maak en bevestig een 4-cijferige pincode en klik op het PIN maken knop.
    Als u uw eSigner-pincode opnieuw moet instellen, lees dan a.u.b. deze how-to.
    Maak een pincode
  4. Er verschijnt een QR-code.
    De volgende keer dat u de pagina opnieuw laadt, is de QR-code niet zichtbaar. Als u uw eSigner QR-code moet bekijken of resetten, lees dan a.u.b. deze how-to.
    QR Code
  5. Scan de code naar een 2-factor authenticatie-app op uw mobiele apparaat, zoals Google Authenticator of Authy. De app geeft u eenmalige wachtwoorden (OTP's) die u kunt gebruiken bij het ondertekenen. Elke OTP is 30 seconden geldig.
    OTP in Authy

Installeer Postman en importeer CSC API Collection

  1. Download en pak het uit CSC API Postman-collectie.
    CSC API Postman-collectie
  2. Download en installeer de Postman REST-client.
    Postman REST Client downloaden
  3. Start Postman en maak vervolgens een nieuw Postman-account aan of log in op een bestaand account.
    Postbode Login
  4. Klik op de import knop.
    Importeer knop
  5. Klik op de Upload bestanden knop, navigeer naar het uitgepakte API-verzamelingsbestand (CSC-API.postman_collection.json), en open het.
    Upload bestanden
  6. Klik op de import knop.
    Importeer knop
  7. Klik op de Collecties tab in Postman en vouw de CSC API-collectie uit om de vijf POST-verzoeken te bekijken waarmee je gaat werken:
    • CSC-info
    • CSC-referentieslijst
    • CSC-inloggegevens
    • Inloggegevens autoriseren
    • Teken Hash

    CSC API-verzameling

Toegangstoken ophalen

  1. De volgende stap is om een ​​toegangstoken op te halen bij SSL.com. Voordat u uw toegangstoken aanvraagt, heeft u een klant-ID (ook bekend als een Applicatie ID. Raadpleeg deze how-to voor instructies over het genereren van deze referentie).
  2. Selecteer het autorisatie tab, selecteer OAuth 2.0 van de Type menu en klik op Krijg een nieuw toegangstoken knop.
    Krijg een nieuw toegangstoken
  3. Voer de volgende informatie in het formulier in:
    • Token Naam: SandBox CSC (of een andere gemakkelijk te onthouden naam die u verkiest)
    • Soort subsidie: Authorisatie Code
    • Terugbel-URL: [Leeg laten]
    • Autoriseren via browser: gecontroleerd
    • Verificatie-URL: https://oauth-sandbox.ssl.com/oauth2/authorize
    • Toegangstoken-URL: https://oauth-sandbox.ssl.com/oauth2/token
    • Klant identificatie: [Uw klant-ID]
    • Cliëntgeheim: [Leeg laten]
    • Domein: service
    • Staat: [Leeg laten]
    • Clientverificatie: Verzenden als Basic Auth-header

    Als u klaar bent, klikt u op het Verzoektoken knop.
    Krijg een nieuw toegangstoken

  4. Een inlogformulier zal in uw webbrowser verschijnen. Voer uw SSL.com gebruikersnaam en wachtwoord in en klik op het Leden knop.
    Account aanmeldingsformulier
  5. Uw nieuwe toegangstoken zou in Postman moeten verschijnen. Selecteer de toegangstoken-tekst en kopieer deze naar het klembord en sluit het Beheer toegangstokens dialoog venster. Plak uw toegangstoken in een teksteditor waar u deze gemakkelijk kunt openen. Elk toegangstoken vervalt na een uur.
    U kunt uw token ook opslaan voor hergebruik in Postman-verzoeken, maar we hebben geconstateerd dat het het meest betrouwbaar is om het token rechtstreeks in elk verzoek te kopiëren en te plakken.
    Toegangstoken

Teken een hash

Nu u een toegangstoken heeft, kunt u beginnen met het doen van API-verzoeken en het maken van handtekeningen. Dit gedeelte leidt u door de vijf beschikbare verzoeken in de Postman CSC-collectie, wat resulteert in het maken van een digitale handtekening op basis van een documenthash.

CSC-info opvragen (optioneel)

  1. U kunt gebruik maken van de CSC-info verzoek om informatie over de cloudhandtekeningservice van SSL.com. Merk op dat dit verzoek, in tegenstelling tot de andere in de collectie, uw toegangstoken niet vereist. Selecteer om het verzoek te verzenden CSC-info van de CSC-API verzameling en klik vervolgens op het Verstuur knop.
    CSC Info-aanvraag
  2. Informatie over de cloud-handtekeningservice wordt weergegeven in een JSON-object in Postman's antwoord veld.
    CSC-info

cURL-opdracht

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

CSC-referentieslijst

  1. Het CSC-referentieslijst request haalt een referentie op die je in latere API-verzoeken zult gebruiken. Selecteer CSC-referentieslijst En klik op de knop autorisatie Tab.
    CSC-referentieslijst
  2. Kies Token aan toonder van de Type menu, plak je toegangstoken in het Token veld en klik vervolgens op Verstuur knop.
    Voeg token toe en verzend verzoek
  3. Een JSON-object met een lijst met referentie-ID's die aan de gebruiker zijn gekoppeld, wordt weergegeven in het antwoord veld. Uw lijst bevat waarschijnlijk één waarde. Kopieer en plak uw identificatie-ID in een teksteditor voor gebruik in latere verzoeken.
    Identificatie-ID

cURL-opdracht

vervangen MY-ACCESS-TOKEN met uw daadwerkelijke toegangstoken:

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

CSC-inloggegevens (optioneel)

  1. Het CSC-inloggegevens request retourneert certificaten en andere informatie die aan een identificatie-ID is gekoppeld en is niet vereist voor ondertekening. Selecteer om dit verzoek te gebruiken CSC-inloggegevens uit de verzameling en klik op het autorisatie Tab.
    CSC-inloggegevens
  2. Kies Token aan toonder van de Type menu en plak vervolgens uw toegangstoken in het Token veld.
    plak autorisatie token
  3. Selecteer het Lichaam tabblad en plak vervolgens uw referentie-ID als de waarde voor credentialID.
    Voer referentie-ID in
  4. Klik op de Verstuur knop.
    Klik op de verzendknop
  5. Een JSON-object met uw handtekeningcertificaatketen en andere informatie verschijnt in het antwoord veld.
    Referentie-ID-informatie

cURL-opdracht

vervangen MY-ACCESS-TOKEN als MY-CREDENTIAL-ID met uw actuele informatie:

curl --location --request POST "https://cs-try.ssl.com/csc/v0/credentials/info" \ --header "Content-Type: application / json" \ --header "Autorisatie: Bearer MY-ACCESS-TOKEN "\ --data-raw" {\ "credentialID \": \ "MY-CREDENTIAL-ID \", \ "certificaten \": \ "chain \", \ "certInfo \": waar, \ "authInfo \": true} "

Inloggegevens autoriseren

  1. Het Inloggegevens autoriseren request haalt de autorisatie op voor het ondertekenen van een hash. Begin met het selecteren Inloggegevens autoriseren uit de verzameling en klik op de autorisatie Tab.
    Inloggegevens autoriseren
  2. Kies Token aan toonder van de Type menu en plak vervolgens uw toegangstoken in het Token veld.
    plak token
  3. Selecteer het Lichaam tabblad. Plak uw referentie-ID als het credentialID waarde en een hash van het document dat u wilt ondertekenen als de hash waarde. Haal een OTP op van uw authenticatie-app en voer deze in als de waarde voor OTP, klik dan op de knop Verstuur knop.
    voer referentie-ID, hash en OTP in
  4. Een JSON-object met uw Signature Activation Data (SAD) verschijnt in het antwoord veld. Kopieer en plak deze waarde in een teksteditor voor gebruik in het verzoek om hash-ondertekening.
    ED

cURL-opdracht

vervangen MY-ACCESS-TOKENMY-CREDENTIAL-ID, MY-HASHen MY-OTP met uw actuele informatie:

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

Teken Hash

  1. Nu zijn we klaar om de document-hash te ondertekenen. Selecteer Teken Hash uit de verzameling en selecteer vervolgens het autorisatie Tab.
    Teken Hash
  2. Kies Token aan toonder van de Type menu en plak vervolgens uw toegangstoken in het Token veld.
    plak token
  3. Selecteer het Lichaam tabblad. Plak uw referentie-ID als het credentialID waarde, uw handtekeningactiveringsgegevens als de SAD waarde en een hash van het document dat u wilt ondertekenen als de hash waarde en klik vervolgens op het Verstuur knop.
    Plak SAD en hash, verzoek verzenden
  4. Een JSON-object met uw handtekening verschijnt in het antwoord veld.
    handtekening

cURL-opdracht

vervangen MY-ACCESS-TOKENMY-CREDENTIAL-ID, MY-SADen MY-HASH met uw actuele informatie:

curl --location --request POST "https://cs-try.ssl.com/csc/v0/signatures/signHash" \ --header "Content-Type: application / json" \ --header "Autorisatie: Bearer MY-ACCESS-TOKEN "\ --data-raw" {\ "credentialID \": \ "MY-CREDENTIAL-ID \", \ "SAD \": \ "MY-SAD \", \ "hash \": [\ "MY-HASH \"], \ "signAlgo \": \ "1.2.840.113549.1.1.11 \"} "

Teken een pdf

Naast het ondertekenen van document-hashes, kunt u ook een pdf-bestand uploaden en ondertekenen. Begin met het downloaden en importeren van het Document Signing API Postman-collectie, hetzelfde volgend installatiestappen je volgde hierboven voor de CSC API-collectie. Bij het ondertekenen van een pdf werkt u met twee POST-verzoeken:

  • Upload PDF-document
  • Teken PDF-document

API-verzameling voor ondertekening van documenten

U kunt de inloggegevens die u hierboven heeft opgehaald opnieuw gebruiken met de CSC-referentieslijst verzoek. U zult waarschijnlijk ook een nieuw toegangstoken.

Upload PDF-document

  1. Selecteer het Upload PDF-document verzoek en klik op het autorisatie Tab.
    Upload PDF-document
  2. Kies Token aan toonder van de Type menu en plak vervolgens uw toegangstoken in het Token veld.
    Plak token
  3. Selecteer het Headers tabblad en plak uw referentie-ID in het Waarde kolom.
    voeg referentie-ID toe aan koptekst
  4. Selecteer het Lichaam Tab en klik op de knop × naast hello.pdf om deze tijdelijke bestandsnaam te verwijderen.
    verwijder placeholder-bestand
  5. Klik op de Selecteer bestand knop en navigeer vervolgens naar het bestand dat u wilt uploaden.
    Selecteer bestand
  6. Klik op de Verstuur knop.
    Verzend verzoek
  7. Selecteer en kopieer het id waarde in het antwoord dat in het volgende verzoek moet worden gebruikt.
    bestands-ID

cURL-opdracht

vervangen MY-CREDENTIAL-ID, MY-ACCESS-TOKENen /PATH/TO/FILE.pdf met uw actuele informatie:

curl --location --request POST "https://ds-try.ssl.com/v1/pdf/upload" \ --header "Credential-Id: MY-CREDENTIAL-ID" \ --header "Autorisatie: Bearer MY-ACCESS-TOKEN "\ --header" Content-Type: application / pdf "\ --data-binary" @ / PATH / TO / FILE.pdf "

Teken PDF-document

  1. Nu kunt u de pdf ondertekenen. Selecteer de Upload PDF-document verzoek en klik op het autorisatie Tab.
      
  2. Kies Token aan toonder van de Type menu en plak vervolgens uw toegangstoken in het Token veld.
    plak token
  3. Selecteer het tabblad Hoofdgedeelte en plak in het id waarde uit de vorige stap.
    voer ID in
  4. Voer een OTP in vanuit uw authenticatie-app en klik op het Verstuur knop.
    voer OTP in en klik op Verzenden
  5. De PDF-gegevens verschijnen hieronder in het antwoord veld. Kiezen Opslaan in een bestand van de Sla reactie op menu en geef het bestand een naam.
    Bewaar in een bestand
  6. Open het bestand in Acrobat om te bevestigen dat het bestand is ondertekend. (Merk op dat in de onderstaande schermafbeelding de RSA Development-root van SSL.com handmatig wordt vertrouwd in Acrobat.)
    digitale handtekening in Adobe Acrobat

cURL-opdracht

vervangen MY-CREDENTIAL-ID, MY-FILE-IDen MY-OTP met uw actuele informatie:

curl --location --request POST "https://ds-try.ssl.com/v1/pdf/sign" \ --header "Content-Transfer-Encoding: application / json" \ --header "Content-Type : application / json "\ --header" Autorisatie: Bearer MY-ACCESS-TOKEN "\ --data-raw" {\ "id \": \ "MY-FILE-ID \", \ "otp \": \ "MY-OTP \"} "

 Live gaan met productie

Om live te gaan, moet u "-try" uit het subdomein verwijderen. Om bijvoorbeeld live te gaan met ds-try.ssl.com, verwijdert u “-try” zodat het subdomein ds.ssl.com wordt.

EV Code Signing-certificaten van SSL.com kan nu worden ingeschreven in eSigner, de cloudgebaseerde code en documentondertekeningsservice van SSL.com. Gelieve te lezen EV-codeondertekening op afstand met eSigner voor volledige details over aanmelden en het gebruik van eSigner, of klik op de onderstaande knop voor algemene eSigner-informatie en prijzen.

eSIGNER INFORMATIE EN PRIJS

Delen op Twitter
Twitter
Delen op Facebook
Facebook
Delen op LinkedIn
LinkedIn
Share on reddit
Reddit
Deel via e-mail
E-mail