osFoundry / Platform
아웃바운드 웹훅
플랫폼 이벤트를 자신의 엔드포인트로 팬아웃하세요. 자동 재시도, 서명 검증.
개요
아웃바운드 웹훅을 사용하면 osFoundry가 이벤트를 여러분이 관리하는 엔드포인트로 직접 밀어 보냅니다. 변경 사항을 확인하려고 반복해서 폴링하는 대신, URL을 하나 등록해 두면 워크스페이스에서 관련 이벤트가 발생할 때마다 osFoundry가 그 URL로 HTTP 요청을 보냅니다. 이렇게 하면 채팅, 에이전트, 앱, 코드, 지식, 데이터 영역에서 일어나는 활동이 여러분의 시스템이 처리할 수 있는 신호가 되며, 각각에 맞춰 별도의 연동을 구축할 필요가 없습니다.
osFoundry에서 웹훅은 설정 및 보안 아래에 있습니다. 워크스페이스 이벤트를 여러분이 소유한 수신 측으로 내보내며 신뢰 경계를 넘나들기 때문입니다. 모든 전송에는 서명이 붙으므로, 그 요청이 실제로 osFoundry에서 왔고 전송 중 변조되지 않았음을 엔드포인트에서 검증할 수 있습니다. 본문을 신뢰하기 전에 공유 시크릿을 사용해 서명을 대조하십시오. 엔드포인트가 다운되었거나, 응답이 느렸거나, 오류를 반환해 전송이 실패한 경우에도 그대로 버려지지 않고 자동으로 재시도됩니다. 그래서 여러분 쪽의 짧은 장애가 이벤트를 소리 없이 잃어버리게 만들지 않습니다. osFoundry는 로컬 우선(local-first)이며 BYOK 방식이므로, 웹훅은 데이터를 밖으로 내보내는 의도적이고 옵트인 방식의 경로입니다. 어떤 엔드포인트가 이벤트를 받을지는 여러분이 정하며, 페이로드는 여러분이 지정한 곳으로만 갑니다.
실질적인 가치는 결합을 끊어내는 데 있습니다. 알림 서비스, 티켓 시스템, 데이터 웨어하우스, 사내 자동화는 osFoundry 안에서 돌아갈 필요도, osFoundry 자격 증명을 보관할 필요도 없습니다. 서명을 검증하고 성공 상태를 반환하는 HTTPS 엔드포인트 하나만 노출하면 됩니다. 서명 검증과 자동 재시도가 있어야 그 엔드포인트를 믿고 의지할 수 있으며, 바로 이 점이 워크플로의 토대로 삼을 수 있는 웹훅과 끊임없이 지켜봐야 하는 웹훅을 가릅니다.
주요 기능
- 직접 운영하는 HTTPS 엔드포인트를 등록해 플랫폼 이벤트가 발생하는 순간 그대로 받습니다. 폴링 루프를 유지할 필요가 없습니다
- 모든 페이로드에 서명이 붙어, 수신 측이 처리에 앞서 그 요청이 osFoundry에서 비롯되었는지 검증할 수 있습니다
- 전송이 실패하면 자동으로 재시도하므로, 하위 시스템의 장애가 이벤트를 소리 없이 버리지 않습니다
- 설정 및 보안 아래에서 관리하는, 엔드포인트별로 옵트인이며 여러분이 완전히 통제하는 아웃바운드 경로입니다
- 로컬 우선, BYOK 모델에 부합합니다. 데이터는 여러분이 명시적으로 지정한 엔드포인트로만 나갑니다
활용 사례
- 플랫폼 엔지니어: osFoundry 자격 증명을 넘기거나 앱에 끼워 넣지 않고도 워크스페이스 이벤트를 사내 자동화 서비스로 전달
- 운영/온콜: 기존 알림 또는 통지 시스템으로 이벤트를 흘려보내, 적절한 담당자가 활동을 실시간으로 파악하도록 함
- 데이터 팀: 이벤트를 웨어하우스나 ETL 엔드포인트로 스트리밍해, 워크스페이스에서 일어나는 일과 외부 기록을 동기화 상태로 유지
자주 묻는 질문
웹훅 요청이 실제로 osFoundry에서 왔는지 어떻게 검증하나요?
전송마다 서명이 붙습니다. 엔드포인트에서 공유 시크릿으로 요청 본문에 대한 서명을 다시 계산해, osFoundry가 보낸 서명과 비교하십시오. 일치하지 않으면 요청을 거부하면 됩니다. 이것이 제3자가 여러분의 엔드포인트로 이벤트를 위조해 보내는 것을 막아 줍니다.
이벤트가 발생할 때 엔드포인트가 다운되어 있으면 어떻게 되나요?
osFoundry는 전송을 버리지 않고 자동으로 재시도합니다. 그래서 여러분 쪽의 짧은 장애나 배포가 이벤트를 잃게 만들지 않습니다. 엔드포인트는 페이로드를 받아들인 뒤 성공 상태를 반환해야 합니다.
웹훅을 쓰면 내 데이터가 osFoundry가 통제하는 어딘가로 전송되나요?
아닙니다. osFoundry는 로컬 우선이며 BYOK이고, 웹훅은 여러분이 등록한 엔드포인트로 나가는 아웃바운드입니다. 이벤트는 여러분이 설정한 URL로만 가며, 어떤 엔드포인트를 둘지는 여러분이 통제합니다. 특정 이벤트를 이미 여러분이 소유한 시스템으로 옮기는 옵트인 방식입니다.