신규 고객 프로모션−20 %월 결제 시 처음 3개월 20% 할인요금제 보기
SilentShield

CORS 오류

브라우저 콘솔에 SilentShield로 보낸 요청이 CORS 정책에 의해 차단되었다고 표시됩니다. 예: Access to fetch at 'https://api.silentshield.io/…' from origin 'https://your-site.example' has been blocked by CORS policy. 원인과 해결 방법은 다음과 같습니다.

SilentShield의 응답 방식

API는 어떤 웹사이트의 요청에도 브라우저에 필요한 CORS 헤더를 붙여 응답하며, 403이나 429 같은 오류 응답도 마찬가지입니다. 다른 웹사이트의 쿠키는 절대 받지 않습니다. 위젯은 API 키로 자신을 식별합니다.

원인

응답에 CORS 헤더가 없음

이 경우 응답은 SilentShield API가 아니라 중간의 무언가, 즉 방화벽, 프록시, 브라우저 확장 프로그램 또는 502나 504 같은 게이트웨이 오류에서 온 것입니다. 개발자 도구의 네트워크 탭에서 요청을 열고 상태와 응답 헤더를 확인하세요. 상태가 (failed) 또는 0이면 요청이 저희에게 도달하지 않은 것입니다.

요청이 쿠키를 보냄

코드가 credentials: 'include'(fetch) 또는 withCredentials: true(XMLHttpRequest, axios)로 요청을 보냅니다. API는 다른 웹사이트에 이를 허용하지 않으므로 브라우저가 응답을 버립니다. 이 옵션을 제거하세요. API에는 API 키만 있으면 됩니다.

요청에 넣은 자체 헤더

이런 요청 전에 브라우저는 OPTIONS 요청(프리플라이트)으로 헤더가 허용되는지 묻습니다. 아래 목록에 없는 헤더는 이 확인을 통과하지 못하고 요청은 전송되지 않습니다. 추가 데이터는 요청 본문으로 보내세요.

응답 헤더를 읽을 수 없음

응답 헤더 중 브라우저의 JavaScript가 읽을 수 있는 것은 Content-Length뿐입니다. 따라서 할당량 헤더(X-Quota-…)는 서버에서만 확인할 수 있습니다. 브라우저는 오류를 표시하지 않으며 값이 단순히 null입니다.

client.js가 차단됨(403 또는 ERR_BLOCKED_BY_ORB)

요청에 Origin도 Referer도 없어서(예: Referrer-Policy: no-referrer) 도메인 확인에서 사이트를 식별하지 못했습니다. 대시보드의 스니펫처럼 script 태그에 referrerpolicy="origin"을 추가하세요.

검증을 브라우저에서 수행함

/v1/verify는 서버에서 호출해야 합니다. 브라우저에서는 누구나 API 키를 읽을 수 있고 봇은 검증을 그냥 건너뛸 수 있습니다. 양식을 behavior_nonce 필드와 함께 서버로 보내고 그곳에서 검증하세요.

허용되는 요청 헤더

브라우저가 SilentShield API로 보낼 수 있는 헤더는 다음과 같습니다:

Origin
Content-Type
Accept
Authorization
X-API-Key
X-Page-URL
X-Page-Path
X-Requested-With
Stripe-Signature
X-SilentShield-ZeroPII

도메인 자체가 키에 등록되어 있지 않나요? 도메인 불일치