Dialogflow가 웹훅 요청을 위해 시작한 네트워크 트래픽은 공개 네트워크를 통해 전송됩니다. 트래픽이 양방향에서 안전하고 신뢰할 수 있도록 하기 위해 Dialogflow는 상호 TLS 인증(mTLS)을 선택적으로 지원합니다. Dialogflow의 표준 TLS 핸드셰이크 중에 웹훅 서버는 인증 기관 체인에 따라 또는 인증서를 커스텀 CA 인증서와 비교하여 Dialogflow에서 유효성을 검사할 수 있는 인증서를 제공합니다. 웹훅 서버에서 mTLS를 사용 설정하면 검증을 위해 Dialogflow가 웹훅 서버에 제공한 클라이언트 인증서를 인증하여 상호 트러스트 설정을 완료할 수 있습니다.
기본적으로 Dialogflow는 SSL.com(CN=Google LLC)에서 발급한 클라이언트 인증서를 제공합니다.
mTLS 요청
mTLS를 요청하려면 다음 안내를 따르세요.
- TLS 핸드셰이크 중에 클라이언트 인증서를 요청하도록 웹훅 HTTPS 서버를 준비합니다.
- SSL.com에서 직접 다운로드할 수 있는 SSL.com 루트 인증 기관 RSA 루트 인증서를 신뢰하도록 웹훅 서버의 mTLS 트러스트 저장소를 구성합니다.
- 루트 CA:
SSL.com Root Certification Authority RSA - SHA-256 지문:
85:66:6A:56:2E:E0:BE:5C:E9:25:C1:D8:89:0A:6F:76:A8:7E:C1:6D:4D:7D:5F:29:EA:74:19:CF:20:12:3B:69 - 확인 깊이: TLS 클라이언트 인증서 확인 깊이를 최소
2로 설정합니다. Dialogflow는 TLS 핸드셰이크 중에 중간 인증서(SSL.com Client Certificate Intermediate CA RSA R2)를 자동으로 전송하므로 루트 CA를 트러스트 저장소에 추가하기만 하면 됩니다.
- 루트 CA:
클라이언트 인증서를 수신하면 이를 확인하도록 웹훅 서버를 구성합니다. 서버 또는 API Gateway가 소유자 또는 일반 이름(CN)으로 클라이언트 인증서를 허용 목록에 추가하는 경우 다음 인증서 속성을 허용합니다(인증서에 소유자 대체 이름(SAN) 확장 프로그램이 포함되지 않음).
- 제목:
C=US, ST=California, L=Mountain View, O=Google, OU=Applied Ai, CN=Google LLC - 발급기관:
C=US, ST=Texas, L=Houston, O=SSL Corp, CN=SSL.com Client Certificate Intermediate CA RSA R2
더 강력한 검증을 위해서는
CN만 일치시키는 대신 전체 제목과 발급기관을 모두 일치시킵니다.- 제목:
mTLS를 사용한 웹훅 서버에 대한 샘플 호출
이 예시에서는 openssl을 실행하는 웹훅 서버와 함께 빠른 시작에 표시된 에이전트를 사용합니다.
- 샘플 설정
- 셔츠 주문을 가져와 독립형 웹 서버를 가리키는 웹훅에 전송하는 Dialogflow CX 에이전트
key.pem이라는 파일에 있는 TLS 통신의 비공개 키입니다.fullchain.pem파일에 공개적으로 신뢰할 수 있는 CA(인증 기관)가 서명한 인증서 체인- SSL.com에서 다운로드한
SSLcomRootCertificationAuthorityRSA.pem파일의 SSL.com 루트 인증서입니다.
-
서버 머신에서
openssl s_server프로그램을 실행합니다.sudo openssl s_server -key key.pem -cert fullchain.pem -CAfile SSLcomRootCertificationAuthorityRSA.pem -accept 443 -verify 2 - 요청은 클라이언트 머신에서 에이전트로 전송됩니다. 이 예시에서 요청은 'I want to buy a large red shirt'입니다. 이 요청은 Dialogflow 콘솔이나 API 호출을 통해 전송될 수 있습니다.
-
서버 머신의
openssl s_server출력verify depth is 2 Using default temp DH parameters ACCEPT depth=2 C = US, ST = Texas, L = Houston, O = SSL Corporation, CN = SSL.com Root Certification Authority RSA verify return:1 depth=1 C = US, ST = Texas, L = Houston, O = SSL Corp, CN = SSL.com Client Certificate Intermediate CA RSA R2 verify return:1 depth=0 C = US, ST = California, L = Mountain View, O = Google, OU = Applied Ai, CN = Google LLC verify return:1 -----BEGIN SSL SESSION PARAMETERS----- MII... -----END SSL SESSION PARAMETERS----- Client certificate -----BEGIN CERTIFICATE----- MII... -----END CERTIFICATE----- subject=C = US, ST = California, L = Mountain View, O = Google, OU = Applied Ai, CN = Google LLC issuer=C = US, ST = Texas, L = Houston, O = SSL Corp, CN = SSL.com Client Certificate Intermediate CA RSA R2 Shared ciphers:TLS_AES_128_GCM_SHA256:... Signature Algorithms: ECDSA+SHA256:... Shared Signature Algorithms: ECDSA+SHA256:... Peer signing digest: SHA256 Peer signature type: RSA-PSS Supported Elliptic Groups: 0xEAEA:... Shared Elliptic groups: X25519:... CIPHER is TLS_AES_128_GCM_SHA256 Secure Renegotiation IS NOT supported POST /shirts-agent-webhook HTTP/1.1 authorization: Bearer ey... content-type: application/json Host: www.example.com Content-Length: 1595 Connection: keep-alive Accept: */* User-Agent: Google-Dialogflow Accept-Encoding: gzip, deflate, br { "detectIntentResponseId": "a7951ce2-2f00-4af5-a508-4c2cb45698b0", "intentInfo": { "lastMatchedIntent": "projects/PROJECT_ID/locations/REGION/agents/AGENT_ID/intents/0adebb70-a727-4687-b8bc-fbbc2ac0b665", "parameters": { "color": { "originalValue": "red", "resolvedValue": "red" }, "size": { "originalValue": "large", "resolvedValue": "large" } }, "displayName": "order.new", "confidence": 0.9978873 }, "pageInfo": { "currentPage": "projects/PROJECT_ID/locations/REGION/agents/AGENT_ID/flows/00000000-0000-0000-0000-000000000000/pages/06e6fc4d-c2f2-4830-ab57-7a318f20fd90", "displayName": "Order Confirmation" }, "sessionInfo": { "session": "projects/PROJECT_ID/locations/REGION/agents/AGENT_ID/sessions/session-test-001", "parameters": { "color": "red", "size": "large" } }, "fulfillmentInfo": { "tag": "confirm" }, "messages": [{ "text": { "text": ["Ok, let\u0027s start a new order."], "redactedText": ["Ok, let\u0027s start a new order."] }, "responseType": "ENTRY_PROMPT", "source": "VIRTUAL_AGENT" }, { "text": { "text": ["You have selected a large, red shirt."], "redactedText": ["You have selected a large, red shirt."] }, "responseType": "HANDLER_PROMPT", "source": "VIRTUAL_AGENT" }], "text": "I want to buy a large red shirt", "languageCode": "en" }ERROR shutting down SSL CONNECTION CLOSED
커스텀 클라이언트 인증서
모든 웹훅에서 사용할 수 있도록 에이전트 수준에서 커스텀 클라이언트 인증서를 구성할 수 있습니다. 웹훅 호출 시 구성된 인증서가 핸드셰이크 중에 표시됩니다.
비공개 키와 암호는 Secret Manager 리소스로 구성됩니다. Dialogflow 서비스 에이전트에 보안 비밀에 대한 Secret Manager 보안 비밀 접근자 권한을 부여해야 합니다.
핸드셰이크가 성공하려면 클라이언트 인증서가 인증 기관에 의해 서명되어야 합니다.
권장사항
웹훅 요청이 자체 Dialogflow 에이전트에서 시작되도록 하려면 요청의 승인 헤더에서 Bearer 서비스 ID 토큰을 확인해야 합니다. 또는 자신 측의 인증 서버에서 이전에 제공한 세션 파라미터를 확인할 수 있습니다.
오류
클라이언트 인증서 검증에 실패하면(예: 웹훅 서버가 클라이언트 인증서를 신뢰하지 않음) TLS 핸드셰이크가 실패하고 세션이 종료됩니다.
일반적인 오류 메시지:
| 오류 메시지 | 설명 |
|---|---|
| 클라이언트 인증서를 확인할 수 없음: x509: 알 수 없는 기관에서 서명한 인증서 | Dialogflow가 클라이언트 인증서를 외부 웹훅으로 전송하지만 외부 웹훅에서 확인할 수 없습니다. 웹훅 트러스트 저장소에 SSL.com 루트 인증 기관 RSA 루트 인증서가 포함되어 있고 서버의 확인 깊이가 2 이상인지 확인합니다. |