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