워크스페이스 웹훅을 사용하면 직접 관리하는 서비스로 스캔 이벤트를 보낼 수 있습니다. 예를 들어 스캔이 끝나면 보안 대시보드를 업데이트하거나 스캔 결과가 바뀌면 티켓을 갱신할 수 있습니다. 각 대상은 ChatGPT 워크스페이스 전체에서 발생하는 이벤트 중 해당 대상에 대해 선택한 이벤트를 수신합니다.
워크스페이스 웹훅 추가
-
Daybreak에서 설정 > 알림으로 이동한 다음 추가를 선택하세요.
-
이름과 엔드포인트 URL을 입력하세요. 외부에서 접근할 수 있고 443번 포트에서
POST요청을 받는 HTTPS 엔드포인트를 사용하세요. -
수신할 이벤트를 선택하세요.
- 스캔 종료(
scan.finished)는 스캔이 완료되거나 실패하거나 취소되면 이를 알립니다. - 스캔 업데이트(
scan.updated)는 검증 결과나 심각도 변경 등 스캔 결과의 후속 변경 사항을 알립니다.
- 스캔 종료(
-
추가를 선택하세요. 서명 비밀 키를 복사해 안전하게 보관하세요. Daybreak는 비밀 키 전체를 한 번만 표시합니다.
-
대상 메뉴에서 테스트 알림 보내기를 선택한 다음 테스트 보내기를 선택하세요. Daybreak는
scan.finished샘플 이벤트에is_test: true를 포함해 전송합니다. 엔드포인트가2xx응답을 반환하면 Daybreak에 전송 성공이 표시됩니다.
웹훅 요청 검증 및 처리
Daybreak는 HMAC-SHA256으로 서명한 JSON POST 요청을 보냅니다. 서명에는 webhook-id, webhook-timestamp 및 원본 요청 본문이 포함됩니다. 이벤트를 처리하기 전에 webhook-signature 헤더를 사용해 요청을 검증하세요. 공백이나 JSON 형식이 바뀌어 서명 검증에 실패하는 일이 없도록 요청의 원본 바이트를 검증기에 전달하세요. 자세한 내용은 Standard Webhooks 사양을 참고하세요. 언어별 검증 라이브러리는 Standard Webhooks 참조 구현에서 확인하세요.
프로덕션 워크플로우를 실행하기 전에 is_test 값을 확인하세요. 페이로드의 id로 중복 전송을 식별하고 data.scan_id로 같은 스캔에 해당하는 이벤트를 묶을 수 있습니다. Daybreak는 테스트 전송을 포함해 전송을 시도할 때마다 응답을 10초간 기다립니다. 서비스가 이벤트를 수락하면 이 시간 안에 2xx 응답을 반환하세요. 처리에 더 오랜 시간이 필요하면 이벤트를 큐에 저장하고 응답을 보낸 다음 이벤트를 처리하세요.
대상 관리 및 비밀 키 교체
대상 메뉴에서 편집을 선택하세요. URL을 변경하거나 수신할 이벤트를 다시 선택할 수 있습니다. 전송을 일시 중지하려면 활성화를 끄세요. 서명 비밀 키를 교체하려면 비밀 키 교체를 선택하세요. 새 비밀 키를 복사하고 수신 서비스가 새 키를 사용하도록 설정을 업데이트하세요. 수신 서비스가 새 키로 전환하는 데 시간이 필요하면 키를 교체할 때 현재 비밀 키를 24시간 동안 활성 상태로 유지를 선택하세요. 이 기간에는 Daybreak가 두 비밀 키로 각각 서명하므로 어느 키로든 요청을 검증할 수 있습니다. 비밀 키를 즉시 교체하는 경우에는 새 테스트 알림을 보내기 전에 수신 서비스의 설정을 업데이트하세요.