Konfigurowanie mTLS elementu webhook w Adobe Acrobat Sign

Zabezpiecz dostarczanie elementów webhook za pomocą wzajemnego protokołu TLS z elastycznym zarządzaniem kluczami prywatnymi.

Webhook mTLS (wzajemny TLS) zapewnia, że zarówno Adobe Acrobat Sign, jak i punkt końcowy uwierzytelniają się nawzajem podczas uzgadniania TLS. Administratorzy mogą wybrać przesłanie własnego klucza prywatnego i certyfikatu lub zlecić programowi Acrobat Sign wygenerowanie i przechowywanie klucza prywatnego. Ta elastyczność zmniejsza wymagania dotyczące obsługi kluczy prywatnych przy jednoczesnym zachowaniu zgodności z dotychczasowym działaniem webhooków.

Ta funkcja jest dostępna dla kont Acrobat Sign Solutions i Acrobat Sign for Government.

Certyfikaty można skonfigurować na poziomie konta i grupy.

• Ustawienia na poziomie grupy zastępują ustawienia na poziomie konta.

Jak działa webhook mTLS

Webhook mTLS używa certyfikatu klienta i klucza prywatnego do uwierzytelnienia Acrobat Sign w punkcie końcowym webhook podczas połączenia.

• Acrobat Sign przedstawia certyfikat podczas uzgadniania TLS.
• Punkt końcowy sprawdza poprawność certyfikatu przed zaakceptowaniem połączenia.
• Ładunki webhook, zdarzenia i zachowanie dostarczania pozostają niezmienione.

Wybierz metodę zarządzania kluczami

Musisz wybrać sposób tworzenia i zarządzania kluczem prywatnym.

Prześlij własny klucz prywatny i certyfikat

• Wygeneruj klucz prywatny i certyfikat zewnętrznie.
• Prześlij jako plik PKCS#12 (.p12 lub .pfx).
• Zachowujesz pełną kontrolę nad generowaniem kluczy i cyklem życia.

Użyj tej metody, jeśli organizacja wymaga zewnętrznego zarządzania kluczami.

Pozwól programowi Adobe Acrobat Sign wygenerować klucz prywatny

• Acrobat Sign generuje klucz prywatny i żądanie podpisania certyfikatu (CSR).
• Klucz prywatny nigdy nie opuszcza infrastruktury Adobe.
• Prześlij CSR do urzędu certyfikacji.
• Prześlij podpisany certyfikat (format PEM).

Użyj tej metody, aby zmniejszyć narażenie klucza prywatnego i uprościć obsługę kluczy.

Kluczowe różnice

Kiedy używać każdej metody:

• Użyj metody przesyłania, jeśli organizacja wymaga zewnętrznej kontroli klucza.
• Użyj metody generowanej przez Adobe Acrobat Sign, gdy chcesz zminimalizować obsługę klucza prywatnego i poprawić bezpieczeństwo.

Skonfiguruj webhook mTLS

Wybierz metodę zarządzania kluczami

Jeśli zdecydujesz się przesłać własny certyfikat:

Po zapisaniu certyfikat staje się główny natychmiast dla dostaw elementów webhook.

Jeśli zdecydujesz się pozwolić Acrobat Sign wygenerować klucz prywatny:

Wymagania dotyczące certyfikatu

PKCS#12 (metoda przesyłania)

• Format: .p12 lub .pfx
• Musi zawierać zarówno klucz prywatny, jak i certyfikat
• Wymaga hasła

CSR (metoda generowana przez Acrobat Sign)

• Format: PEM (.pem, .crt, .cer)
• Musi zawierać użycie clientAuth
• Musi być zgodny z wygenerowanym CSR
• Musi mieścić się w okresie ważności
• W razie potrzeby dołącz certyfikaty pośrednie

Ważne kwestie

• Jeśli certyfikat wygaśnie, dostarczanie webhook nie powiedzie się, dopóki nie zostanie przesłany ważny certyfikat.
• Acrobat Sign ponawia próby na podstawie zasad ponawiania prób webhook.
• Przełączanie między metodami zarządzania kluczami nie usuwa istniejących certyfikatów.
• CSR i klucz prywatny są zapisywane dopiero po wybraniu Zapisz. Opuszczenie strony powoduje ich odrzucenie.
• Obsługiwana jest konfiguracja na poziomie grupy.
• Nowy CSR jest wymagany, gdy zmieniają się szczegóły podmiotu certyfikatu lub chcesz wymienić klucz prywatny.