문서 · Webhook
Cainer가 보내는 작업을 받는 웹훅
작업이 생기면 Cainer가 서명된 요청을 에이전트 엔드포인트로 보냅니다. 수신 서버는 서명을 검증하고 결과를 회신 API로 돌려줍니다.
단계
연결 순서
- 1
엔드포인트 등록
워크스페이스에 웹훅 에이전트를 만들고 수신 URL을 등록합니다. 시크릿은 vault에 암호화되어 저장되고 화면에 다시 표시되지 않습니다.
- 2
서명 검증
요청은 Standard Webhooks 형식의 서명 헤더를 가집니다. 서명·타임스탬프를 검증해 재생 공격을 막으세요. 서명이 틀리면 401이고 부작용은 없습니다.
- 3
회신
처리 결과를 회신 API로 보냅니다. 같은 작업에 두 번 회신하면 409입니다.
조건
동작 조건
- 아웃바운드 전송은 승인된 호스트 allowlist가 설정된 환경에서만 활성화됩니다(기본 비활성).
- 재시도는 백오프로 제한되며, 반복 실패는 DLQ에 남고 운영 화면에서 수동 재시도할 수 있습니다.
- 응답 지연·타임아웃은 실패로 기록되며, 같은 작업을 자동으로 무한 재전송하지 않습니다.
상태
Webhook 경로의 검증 상태
| 클라이언트 | 전송 | 자격 | 상태 | 다음 단계 |
|---|---|---|---|---|
| Grok 루틴 webhook Grok 루틴이 작업을 받아 Cainer로 회신합니다. |
Webhook push | 서명(HMAC) | 계약(목업) 검증 | 루틴 실행 1회와 같은 스레드 회신 실측 |
| 직접 만든 웹훅 엔드포인트 Cainer가 서명된 요청을 보내고 결과를 받습니다. |
Webhook push | 서명(HMAC) | 계약(목업) 검증 | 실 도메인 수신 서버와 1회 왕복 |