- Problem: Använda en otillförlitlig certifikatutfärdare eller ett självsignerat certifikat
Åtgärd: använd ett offentligt utfärdat SSL-certifikat för webhookens återanropsserver.
Användarhandbok för Adobe Acrobat Sign
Nyheter
Kom igång
Administrera
Skicka, signera och hantera avtal
Avancerade avtalsfunktioner och arbetsflöden
Integrera med andra produkter
Adobe Sign-utvecklare
Support och felsökning
Tvåvägs-SSL, ofta kallad Client-Side SSL eller ömsesidig TLS, är ett SSL-läge där både servern och klienten (webbläsaren) presenterar certifikat för att identifiera sig själva.
Kontoadministratörer kan konfigurera ett klientcertifikat på sidan Säkerhetsinställningar.
Acrobat Sign verifierar SSL-certifikat vid leverans av nyttolaster till webhook-URL. Webhookar som misslyckas med SSL-certifikatverifiering kan inte leverera JSON-nyttolast.
Använd tvåvägs SSL för att autentisera klienten (Acrobat Sign) och lyssningstjänsten för att säkerställa att endast Acrobat Sign kan nå webhook-URL:en.
Om en webhook skapades av ett Partnerprogram kommer denna webhook att använda ett klientcertifikat (om tillgängligt) från partnerprogrammets konto för att identifiera sig själv när den skickar webhook-meddelanden.
Nedan visas de vanligaste frågorna för både verifiering av webbserver och verifiering av klientcertifikat.
När en webhook registreras verifierar Acrobat Sign webhookserverns URL.
Kunder kommer inte att kunna registrera webhooken om anslutningen till webhookens återanrops-URL inte kan slutföras från Acrobat Sign.
Nej.
Återanrops-URL för webhook kan bara vara HTTPS på port 443 eller 8443.
Acrobat Sign blockerar utgående HTTPS-trafik till alla andra portar.
Ett bra sätt att verifiera servercertifikatet är att använda Diagnostikverktyget för DigiCert® SSL-installation.
Ange endast värdnamn, t.ex.: www.digicert.com
Vanliga problem är:
Åtgärd: använd ett offentligt utfärdat SSL-certifikat för webhookens återanropsserver.
Åtgärd: installera de mellanliggande certifikaten på återanropsservern för webhook.
Se https://www.digicert.com/kb/ssl-certificate-installation.htm för detaljerad information.
För att konfigurera en tvåvägs-SSL för en webhook, kräver vi att administratören överför en .p12 (eller .pfx-fil) som innehåller den privata nyckeln. Filen lagras säkert på kundkontot och administratören har fullständig kontroll över att ta bort den när som helst.
I en tvåvägs webhook-konfiguration är, Acrobat Sign uppringaren/klienten och behöver den privata nyckeln för att bevisa att samtalet görs av Acrobat Sign för kundkontot.
Kontrollera att tvåvägs-SSL är aktiverat
Tvåvägs-SSL måste aktiveras på återanropsservern för webhook.
Anslut till återanrops-länken för webhook via valfri webbläsare. Du borde få:
400 Felaktig begäran Inget nödvändigt SSL-certifikat skickades
Det innebär att servern förväntar sig att klienten ska skicka klientcertifikat (dvs.: tvåvägs-SSL har aktiverats för servern).
Om du inte ser ovanstående meddelande är tvåvägs-SSL inte aktiverat.
Du kan använda Postman och göra en POST-begäran till återanrops-länken för webhook. Du borde få ett liknande resultat.
Klientautentiseringsuppgifterna kan antingen vara ett självsignerat certifikat eller CA- utfärdat certifikat. Det måste dock minst uppfylla följande X.509 v3-tillägg:
X.509 v3-tillägg |
Värde |
---|---|
ExtendedKeyUsage |
clientAuth (OID: 1.3.6.1.5.5.7.3.2) |
KeyUsage |
digitalSignature |
Klientcertifikatet måste vara en PKCS12-fil med filnamnstillägget .p12 eller .pfx och det måste innehålla både klientcertifikatet (så att servern kan verifiera klientens identitet) och klientens privata nyckel (så att klienten kan signera meddelanden digitalt för servern för att verifiera under SSL-handskakningen).
Använd kommandot openssl för att verifiera p12-filen (pfx):
openssl pkcs12 -info -in outfile.p12
Lösenfrasen för den privata nyckeln ska begäras. Utdata bör innehålla både certifikat och en krypterad privat nyckel som:
Bag Attributes localKeyID: 9D BD 22 80 E7 B2 B7 58 9E AE C8 42 71 F0 39 E1 E7 2B 57 DB subject=/C=US/ST=California/L=San Jose/O=Adobe Inc./CN=sp.adobesignpreview.com issuer=/C=US/O=DigiCert Inc/CN=DigiCert TLS RSA SHA256 2020 CA1 -----BEGIN CERTIFICATE----- MIIGwDCCBaigAwIBAgIQAhJSKDdyQZjlbYO5MJAYOTANBgkqhkiG9w0BAQsFADBP MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMSkwJwYDVQQDEyBE ... JAKQLQ== -----END CERTIFICATE----- Bag Attributes: <No Attributes> subject=/C=US/O=DigiCert Inc/CN=DigiCert TLS RSA SHA256 2020 CA1 issuer=/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root CA -----BEGIN CERTIFICATE----- MIIEvjCCA6agAwIBAgIQBtjZBNVYQ0b2ii+nVCJ+xDANBgkqhkiG9w0BAQsFADBh MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 ... -----END CERTIFICATE----- Bag Attributes localKeyID: 9D BD 22 80 E7 B2 B7 58 9E AE C8 42 71 F0 39 E1 E7 2B 57 DB Key Attributes: <No Attributes> -----BEGIN ENCRYPTED PRIVATE KEY----- MIIFDjBABgkqhkiG9w0BBQ0wMzAbBgkqhkiG9w0BBQwwDgQI7eNh2qlsLPkCAggA ... FHE= -----END ENCRYPTED PRIVATE KEY-----
Certifikaten bör åtminstone innehålla slutanvändarcertifikatet och de mellanliggande certifikaten. Helst ska det även innehålla rot-CA-certifikatet.
Se till att .p12- eller .pfx-filen är lösenordsskyddad.
Skapa ett självsignerat klientcertifikat (valfritt)
Klientcertifikat kan antingen utfärdas av en certifikatutfärdare eller vara självsignerade, beroende på dina behov.
För att generera ett självsignerat klientcertifikat, använd följande openssl -kommando:
openssl req -newkey rsa:4096 -keyform PEM -keyout ca.key -x509 -days 3650 -outform PEM -out ca.cer
Håll de resulterande filerna hemliga eftersom de är dina självsignerade CA-certifikat.
Generera sedan klient-.p12-filen:
openssl genrsa -out client.key 2048
openssl req -new -key client.key -out client.req
openssl x509 -req -in client.req -CA ca.cer -CAkey ca.key -set_serial 101 -extensions client -days 365 -outform PEM -out client.cer
openssl pkcs12 -export -inkey client.key -in client.cer -out client.p12
rm client.key client.cer client.req
När konfigurationen är klar skickar du en POST-begäran till återanrops-länken för webhook.
Du bör få ett 200 -svar.
Varför avvisar Acrobat Sign min PFX-fil även efter att jag har verifierat den med Postman?
Om du har följt ovanstående procedur för pfx-filverifiering och Acrobat Sign fortfarande avvisar pfx-filen är det troligt att filen genererades av ett Microsoft-verktyg som kan producera en PKCS12-fil som inte är standard.
Använd i sådana fall nedanstående openssl-kommandon för att extrahera certifikaten och den privata nyckeln från pfx-filen och generera sedan en korrekt formaterad PKCS12-fil:
// Extrahera certifikat och privat nyckel från pfx-fil openssl pkcs12 -info -in microsoftclientssl.pfx -passin pass:"" -out clientcert.crt -nokeys openssl pkcs12 -info -in microsoftclientssl.pfx -passin pass:"" -out clientcert.key -nodes -nocerts // Skapa ny PKCS12-fil openssl pkcs12 -export -inkey clientcert.key -in clientcert.crt -out clientcert.pfx