웹훅은 외부 애플리케이션이 플랫폼에서 특정 이벤트가 발생할 때 실시간 알림을 수신할 수 있는 방법을 제공합니다.
웹훅을 사용하려면 웹훅을 사용 설정하고 토큰을 생성해야 합니다. 단일 웹훅 URL에 두 개의 별도 보안 비밀을 사용하면 보안 레이어가 추가됩니다. 어떤 이유로든 하나의 보안 비밀이 손상되거나 순환해야 하는 경우 웹훅 서비스를 중단하거나 데이터 보안을 위태롭게 하지 않고 보안 비밀을 업데이트하고 순환할 수 있습니다.
웹훅 사용 설정
웹훅을 사용 설정하려면 다음 단계를 따르세요.
CCAI Platform 포털에서 설정 > 개발자 설정을 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.
웹훅 창으로 이동한 다음 웹훅 전환 버튼을 사용 설정으로 클릭합니다.
URL에 웹훅 URL을 입력합니다. 이 URL은 실시간 알림을 수신하는 엔드포인트입니다. 이 웹훅이 HTTP 요청을 수신할 수 있는지 확인하세요.
생성을 클릭합니다. 이렇게 하면 수신 웹훅 페이로드를 인증하고 검증하는 데 사용되는 기본 보안 토큰인 기본 보안 비밀이 생성됩니다. 웹훅 통신을 보호하는 기본 수단 역할을 합니다.
토큰을 복사하여 안전한 곳에 저장합니다.
보조 보안 비밀을 생성합니다. 보조 비밀번호는 백업 또는 장애 조치 보안 토큰 역할을 합니다. 웹훅 알림의 안정성과 가용성을 향상하기 위한 추가 보안 조치로 제공됩니다. 어떤 이유로든 기본 비밀번호가 유출되거나 사용에 문제가 있는 경우 보조 비밀번호가 인계받아 통신을 계속 보장할 수 있습니다.
토큰을 복사하여 안전한 곳에 저장합니다.
저장을 클릭합니다.
보안 비밀 순환
보안 권장사항에 따라 웹훅 비밀번호를 주기적으로 순환하세요. 이 프로세스에는 기본 및 보조 웹훅 모두에 대한 새 보안 비밀 키를 생성하고 애플리케이션에서 이를 업데이트하여 알림을 원활하게 계속 수신하는 작업이 포함됩니다.
웹훅을 초기 설정한 후에는 새 기본 비밀번호를 직접 생성할 수 없지만 새 보조 비밀번호를 생성하고 비밀번호를 교체하여 변경할 수 있습니다.
보안 비밀을 순환하려면 다음 단계를 따르세요.
CCAI Platform 포털에서 설정 > 개발자 설정을 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.
보안 비밀 순환을 클릭합니다.
저장을 클릭합니다.
새 보안 비밀 생성
새 보안 비밀 키가 두 개가 되도록 보안 비밀을 순환하려면 다음 단계를 따르세요.
CCAI Platform 포털에서 설정 > 개발자 설정을 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.
생성을 클릭하여 새 보조 보안 비밀을 생성합니다.
보안 비밀 순환을 클릭하여 새 보조 보안 비밀을 기본 보안 비밀로 만듭니다.
생성을 클릭하여 이전 기본 보안 비밀을 대체할 두 번째 새 보조 보안 비밀을 생성합니다.
저장을 클릭합니다.