Kaksisuuntainen SSL, jota kutsutaan usein asiakaspuolen SSL:ksi tai yhteiseksi TLS:ksi, on SSL-tila jossa sekä palvelin että asiakas (verkkoselain) esittävät varmenteita tunnistautuakseen.

Tilin ylläpitäjät voivat määrittää asiakaspuolen varmenteen Suojausasetukset-sivulla.

Acrobat Sign vahvistaa SSL-varmenteet toimittaessaan kuormia webhookin URL-osoitteeseen. SSL-varmenteen tarkastuksessa epäonnistuneet webhookit eivät toimita JSON-hyötykuormaa.

Todenna kaksisuuntaisella SSL:llä asiakas (Acrobat Sign) ja kuuntelupalvelu varmistaaksesi, että vain Acrobat Sign pääsee webhookisi URL-osoitteeseen.

Jos webhook on luotu kumppanisovelluksella, se käyttää kumppanisovelluksen tilin asiakasvarmennetta (jos se on saatavilla) tunnistautumiseen webhook-kutsuja lähettäessään.

Siirry käyttöliittymän ohjausobjekteihin asiakasvarmenteen lataamista varten

Alla on esitetty yleisimmät kysymykset sekä verkkopalvelimen varmennusprosessista että asiakkaan sertifioinnin varmennuksesta.

Verkkopalvelimen vahvistus

Webhookin rekisteröinnin aikana Acrobat Sign vahvistaa webhook-palvelimen URL-osoitteen.

Asiakkaat eivät pysty rekisteröimään webhookia, jos Acrobat Signistä ei voida toteuttaa yhteyttä webhookin vastakutsun URL-osoitteeseen.

Ei.

Webhook-kutsun URL-osoite voi olla ainoastaan HTTPS portissa 443 tai 8443.

Acrobat Sign estää lähtevän HTTPS-liikenteen kaikkiin muihin portteihin.

Hyvä tapa varmistaa palvelimen varmenne on käyttää DigiCert ® SSL -asennuksen vianmääritystyökalua.

Riittää että syötät isäntänimen, kuten: www.digicert.com

Yleisiä kysymyksiä ovat:

Ongelma: epäluotettavan CA-varmenteen tai itse allekirjoitetun varmenteen käyttäminen

Korjaus: Käytä julkista CA:n myöntämää SSL-sertifikaattia webhookin vastakutsun palvelimelle.

Ongelma: Palvelin ei lähetä välivarmennetta

Korjaus: Asenna välivarmenteet webhookin vastakutsupalvelimeen.

Lisätietoja löytyy osoitteesta https://www.digicert.com/kb/ssl-certificate-installation.htm.

Asiakasvarmenteen varmennus

Jos haluat määrittää kaksisuuntaisen SSL:n webhookille, vaadimme hallinnoijaa lataamaan palvelimelle yksityisen avaimen sisältävän .p12- (tai .pfx-) tiedoston. Tiedosto tallennetaan turvallisesti asiakastilille, ja hallinnoija voi poistaa sen milloin tahansa.

Kaksisuuntaisessa webhook-asetuksessa Acrobat Sign on kutsuja/asiakas ja tarvitsee yksityisen avaimen todistaakseen, että Acrobat Sign tekee kutsun asiakastilin puolesta.

Varmista, että kaksisuuntainen SSL on käytössä

Kaksisuuntaisen SSL:n on oltava käytössä webhookin vastakutsupalvelimella.

Voit yhdistää webhookin vastakutsun URL-osoitteeseen millä tahansa selaimella. Sinun pitäisi saada:
```
400 virheellinen pyyntö
Vaadittua SSL-sertifikaattia ei lähetetty
```
Tämä tarkoittaa, että palvelin odottaa asiakkaan lähettävän asiakkaan varmenteet (eli palvelimelle on otettu käyttöön kaksisuuntainen SSL).

Jos et näe yllä olevaa viestiä, kaksisuuntainen SSL ei ole käytössä.

Huomautus:

Voit käyttää Postmania, ja tehdä POST-pyynnön webhookin vastakutsun URL-osoitteeseen. Sinun pitäisi saada samankaltainen tulos.

Vahvista asiakkaan varmenne paikallisesti

Asiakkaan tunnistetiedot voivat olla joko itse allekirjoitettu sertifikaatti tai CA:n myöntämä sertifikaatti. Sen on kuitenkin oltava vähintään seuraavien X.509 v3 -laajennusten vaatimusten mukainen:

X.509 v3 -laajennus	Arvo
ExtendedKeyUsage	clientAuth (OID: 1.3.6.1.5.5.7.3.2)
KeyUsage	digitalSignature

Asiakkaan varmenteen on oltava PKCS12-tiedosto, jonka tunniste on .p12 tai .pfx, ja sen on sisällettävä sekä asiakkaan varmenne (jotta palvelin voi tarkistaa asiakkaan henkilöllisyyden) että asiakkaan yksityinen avain (jotta asiakas voi digitaalisesti allekirjoittaa viestejä palvelimelle SSL-kättelyn aikana varmistettavaksi).

Käytä komentoa openssl p12 (pfx) -tiedoston varmistamiseksi:

openssl pkcs12 -info -in outfile.p12

Yksityisen avaimen tunnuslausetta pitäisi vaatia. Tulosteessa tulisi olla sekä varmenteita että salattu yksityinen avain, kuten:

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-----

Varmenteen tulisi sisältää vähintään valtuutusvarmenne ja välivaiheen varmenteet. Ihannetapauksessa se sisältää myös root CA -varmenteen.

Hälytys:

Varmista, että .p12- tai .pfx-tiedosto on suojattu salasanalla.

Luo itse allekirjoitettu asiakassertifikaatti (valinnainen)

Asiakkaan varmenteet voivat olla joko CA:n myöntämiä tai itse allekirjoitettuja tarpeestasi riippuen.

Luo itse allekirjoitettu asiakassertifikaatti käyttämällä seuraavaa openssl-komentoa:

openssl req -newkey rsa:4096 -keyform PEM -keyout ca.key -x509 -days 3650 -outform PEM -out ca.cer

Varoitus:

Pidä tuloksena luodut tiedostot salassa, koska ne ovat itse allekirjoitetut CA-varmenteesi.
Luo seuraavaksi client .p12 -tiedosto:
1. Luo yksityinen avain SSL-asiakkaalle:
  openssl genrsa -out client.key 2048
2. Luo varmennepyyntö asiakkaan yksityisellä avaimella:
  openssl req -new -key client.key -out client.req
3. Myönnä asiakkaan varmenne käyttäen varmennepyyntöä ja CA-varmennetta/avainta:
  openssl x509 -req -in client.req -CA ca.cer -CAkey ca.key -set_serial 101 -extensions client -days 365 -outform PEM -out client.cer
4. Muunna asiakkaan varmenne ja yksityinen avain selaimia varten pkcs#12-formaattiin:
  openssl pkcs12 -export -inkey client.key -in client.cer -out client.p12
5. Poista asiakkaan yksityinen avain, asiakkaan varmenne ja asiakkaan pyyntötiedostot, koska pkcs12:ssa on kaikki tarvitsemasi.
  rm client.key client.cer client.req
Vahvista asiakkaan varmenne käyttämällä etäpalvelinta
- Käytä Postmania asiakkaan PFX-tiedoston lataamiseen siirtymällä kohtaan Asetukset > Varmenteet.
- Lisää asiakkaan varmenne valitsemalla Lisää varmenne.
- Määritä HTTP-otsikko x-adobesign-clientid:lle:
Kun määritys on tehty, lähetä POST-pyyntö webhookin vastakutsun URL-osoitteeseen.

Sinun pitäisi saada 200-vastaus.
Miksi Acrobat Sign hylkää PFX-tiedostoni, vaikka olen vahvistanut sen Postmanissa?

Jos olet noudattanut edellä mainittua prosessia pfx-tiedoston todentamisessa, ja Acrobat Sign hylkää pfx-tiedoston edelleen, on todennäköistä, että tiedosto on luotu Microsoft-työkalulla, joka pystyy luomaan epätyypillisen PKCS12-tiedoston.

Tässä tapauksessa käytä alla olevia openssl-komentoja purkaaksesi varmenteet ja yksityisen avaimen pfx-tiedostosta, ja luo sitten oikein muotoiltu PKCS12-tiedosto:
```
// Pura varmenteet ja yksityinen avain pfx-tiedostosta
openssl pkcs12 -info -in microsoftclientssl.pfx -passin pass:&quot;&quot; -out clientcert.crt -nokeys
openssl pkcs12 -info -in microsoftclientssl.pfx -passin pass:&quot;&quot; -out clientcert.key -nodes -nocerts

// Luo uusi PKCS12-tiedosto
openssl pkcs12 -export -inkey clientcert.key -in clientcert.crt -out clientcert.pfx
```

Pyydä apua nopeammin ja helpommin

Oletko uusi käyttäjä?

Kaksisuuntainen (molemminpuolinen) SSL-todennus

Kaksisuuntainen SSL-todennus

Verkkopalvelimen vahvistus

Asiakasvarmenteen varmennus

Pyydä apua nopeammin ja helpommin

Kysy yhteisöltä

Ota yhteyttä