Cloudflare Bot Fight Mode로 인해 Ably 웹훅이 403 오류를 반환할 때 해결 방법

최근 Ably에서 n8n 웹훅을 호출할 때 403 Forbidden 오류가 발생하는 문제를 겪었다.
오류 메시지는 다음과 같았다

message: POST returned HTTP status 403
code: 70002
statusCode: 403
nonfatal: false
href: https://help.ably.io/error/70002
serverId: frontend.efc7.3.us-east-1-A.i-0b9114803583e8c99.e7dDg9szABmY1m

 

이 오류는 Ably의 공식 문서에서 "웹훅이 허용되지 않았다" 또는 "잘못된 인증 정보" 문제일 가능성이 있다고 안내하고 있다. 하지만 내 경우에는 웹훅이 정상적으로 등록되어 있었고, 인증 문제도 없었다.

 

원인: Cloudflare Bot Fight Mode

문제의 원인은 Cloudflare의 Bot Fight Mode였다.
Cloudflare는 악의적인 봇 트래픽을 차단하기 위해 Bot Fight Mode를 제공하는데, 이 기능이 활성화된 상태에서는 특정 자동화된 API 요청도 봇으로 오인하여 차단할 수 있다.

결국, Cloudflare의 Bot Fight Mode를 해제하자 Ably 웹훅이 정상적으로 호출되었다.

해결 방법: Cloudflare Bot Fight Mode 해제하기

1. Cloudflare 대시보드 접속
   • Cloudflare 대시보드에 로그인한다.
   • 해당 도메인의 설정 페이지로 이동한다.
2. Bot Fight Mode 설정 변경
   • "Security" → "Bots" 메뉴로 이동한다.
   • "Bot Fight Mode" 설정을 비활성화(Off) 한다.
3. 설정 저장 후 테스트
   • Bot Fight Mode를 해제한 후 Ably에서 다시 웹훅을 호출해본다.
   • 정상적으로 응답이 오는지 확인한다.

결론

Cloudflare의 Bot Fight Mode는 자동화된 웹 요청을 차단할 수 있기 때문에, Ably, n8n, Zapier 등의 서비스에서 웹훅을 사용할 때 예기치 않은 403 오류를 유발할 수 있다. 만약 유사한 오류를 경험했다면, Cloudflare의 Bot Fight Mode를 비활성화하는 것이 해결책이 될 수 있다.