리퍼러 및 리퍼러 정책 권장사항

이 페이지에서는 Referrer-Policy를 설정하고 수신 요청에서 리퍼러를 사용하는 몇 가지 권장사항을 간략하게 설명합니다.

요약

  • 예상치 못한 교차 출처 정보 유출은 웹 사용자의 개인 정보를 손상시킵니다. 보호 리퍼러 정책이 도움이 될 수 있습니다.
  • strict-origin-when-cross-origin의 리퍼러 정책을 설정하는 것이 좋습니다. 이 설정은 리퍼러의 유용성을 대부분 유지하면서 출처 간 데이터 유출 위험을 완화합니다.
  • 크로스 사이트 요청 위조 (CSRF) 방지에 리퍼러를 사용하지 마세요. 대신 CSRF 토큰과 기타 헤더를 추가 보안 레이어로 사용하세요.

Referer 및 Referrer-Policy 101

HTTP 요청에는 요청이 이루어진 출처 또는 웹페이지 URL을 나타내는 선택적 Referer 헤더가 포함될 수 있습니다. Referrer-Policy 헤더Referer 헤더에서 사용할 수 있는 데이터를 정의합니다.

다음 예에서 Referer 헤더에는 요청이 이루어진 site-one의 페이지 전체 URL이 포함됩니다.

Referer 헤더가 포함된 HTTP 요청
리퍼러 헤더가 있는 HTTP 요청

Referer 헤더는 다음과 같은 다양한 유형의 요청에 있을 수 있습니다.

  • 사용자가 링크를 클릭할 때의 탐색 요청
  • 브라우저가 페이지에 필요한 이미지, iframe, 스크립트, 기타 리소스를 요청하는 경우의 하위 리소스 요청

탐색 및 iframe의 경우 document.referrer를 사용하여 JavaScript로 이 데이터에 액세스할 수도 있습니다.

Referer 값에서 많은 것을 알 수 있습니다. 예를 들어 분석 서비스는 이를 사용하여 site-two.example 방문자의 50% 가 social-network.example에서 왔음을 확인할 수 있습니다. 하지만 경로와 쿼리 문자열을 포함한 전체 URL이 Referer에서 출처 간에 전송되면 사용자 개인 정보 보호가 위험에 처하고 보안 위험이 발생할 수 있습니다.

경로가 있고 서로 다른 개인 정보 보호 및 보안 위험에 매핑된 URL
전체 URL을 사용하면 사용자 개인 정보 보호 및 보안에 영향을 줄 수 있습니다.

URL 1~5에는 개인 정보가 포함되어 있으며, 때로는 민감한 정보나 식별 정보가 포함되어 있습니다. 이러한 정보를 출처 간에 자동으로 유출하면 웹 사용자의 개인 정보가 침해될 수 있습니다.

URL #6은 기능 URL입니다. 의도한 사용자 외에 다른 사람이 이 코드를 수신하면 악의적인 행위자가 이 사용자의 계정을 제어할 수 있습니다.

사이트의 요청에 사용할 수 있는 리퍼러 데이터를 제한하려면 리퍼러 정책을 설정하세요.

사용 가능한 정책과 차이점은 무엇인가요?

8가지 정책 중 하나를 선택할 수 있습니다. 정책에 따라 Referer 헤더 (및 document.referrer)에서 사용할 수 있는 데이터는 다음 중 하나일 수 있습니다.

  • 데이터 없음 (Referer 헤더가 없음)
  • 출처
  • 전체 URL: 출처, 경로, 쿼리 문자열
Referer 헤더와 document.referrer에 포함될 수 있는 데이터입니다.
리퍼러 데이터의 예입니다.

일부 정책은 컨텍스트(교차 출처 또는 동일 출처 요청, 요청 대상이 출처만큼 안전한지 여부 또는 둘 다)에 따라 다르게 작동하도록 설계되었습니다. 이는 출처 간에 또는 보안이 낮은 출처 간에 공유되는 정보의 양을 제한하면서도 자체 사이트 내에서 리퍼러의 풍부함을 유지하는 데 유용합니다.

다음 표에서는 리퍼러 정책이 Referer 헤더와 document.referrer에서 사용할 수 있는 URL 데이터를 제한하는 방법을 보여줍니다.

정책 범위 정책 이름 리퍼러: 데이터 없음 Referer: Origin only(리퍼러: 출처만) 리퍼러: 전체 URL
요청 컨텍스트를 고려하지 않음 no-referrer check
origin check
unsafe-url check
보안 중심 strict-origin HTTPS에서 HTTP로 요청 HTTPS에서 HTTPS로 또는 HTTP에서 HTTP로 요청
no-referrer-when-downgrade HTTPS에서 HTTP로 요청 HTTPS에서 HTTPS로 또는 HTTP에서 HTTP로 요청
개인 정보 보호 중심 origin-when-cross-origin 교차 출처 요청 동일 출처 요청
same-origin 교차 출처 요청 동일 출처 요청
개인 정보 보호 및 보안 중심 strict-origin-when-cross-origin HTTPS에서 HTTP로 요청 HTTPS에서 HTTPS로 또는 HTTP에서 HTTP로의 교차 출처 요청

동일 출처 요청

MDN에서는 정책 및 동작 예시의 전체 목록을 제공합니다.

리퍼러 정책을 설정할 때 유의해야 할 사항은 다음과 같습니다.

  • 스키마 (HTTPS와 HTTP)를 고려하는 모든 정책(strict-origin, no-referrer-when-downgrade, strict-origin-when-cross-origin)은 HTTP가 보안이 약함에도 불구하고 한 HTTP 출처에서 다른 HTTP 출처로의 요청을 HTTPS 출처에서 다른 HTTPS 출처로의 요청과 동일하게 취급합니다. 이러한 정책에서는 보안 다운그레이드가 발생하는지, 즉 HTTPS → HTTP 요청과 같이 요청이 암호화된 출처의 데이터를 암호화되지 않은 출처에 노출할 수 있는지가 중요하기 때문입니다. HTTP → HTTP 요청은 완전히 암호화되지 않으므로 다운그레이드가 없습니다.
  • 요청이 동일 출처인 경우 스키마 (HTTPS 또는 HTTP)가 동일하므로 보안 다운그레이드가 없습니다.

브라우저의 기본 리퍼러 정책

2021년 10월 기준

리퍼러 정책이 설정되지 않으면 브라우저에서 기본 정책을 사용합니다.

브라우저 기본 Referrer-Policy / 동작
Chrome 기본값은 strict-origin-when-cross-origin입니다.
Firefox 기본값은 strict-origin-when-cross-origin입니다.
버전 93부터 엄격한 추적 보호 및 시크 모드 사용자의 경우 제한이 적은 리퍼러 정책 no-referrer-when-downgrade, origin-when-cross-origin, unsafe-url이 크로스 사이트 요청에 대해 무시됩니다. 즉, 웹사이트의 정책과 관계없이 크로스 사이트 요청에 대해 항상 리퍼러가 잘립니다.
에지 기본값은 strict-origin-when-cross-origin입니다.
Safari 기본값은 strict-origin-when-cross-origin와 비슷하지만 몇 가지 구체적인 차이점이 있습니다. 자세한 내용은 추적 방지 추적 방지를 참고하세요.

리퍼러 정책 설정 권장사항

사이트의 리퍼러 정책을 설정하는 방법에는 여러 가지가 있습니다.

페이지, 요청 또는 요소별로 다른 정책을 설정할 수 있습니다.

HTTP 헤더와 메타 요소는 모두 페이지 수준입니다. 요소의 유효 정책을 결정하는 우선순위는 다음과 같습니다.

  1. 요소 수준 정책
  2. 페이지 수준 정책
  3. 브라우저 기본값

예:

index.html:

<meta name="referrer" content="strict-origin-when-cross-origin" />
<img src="..." referrerpolicy="no-referrer-when-downgrade" />

이미지는 no-referrer-when-downgrade 정책으로 요청되고 이 페이지의 다른 모든 하위 리소스 요청은 strict-origin-when-cross-origin 정책을 따릅니다.

리퍼러 정책을 확인하는 방법

securityheaders.com은 특정 사이트 또는 페이지에서 사용 중인 정책을 확인하는 데 유용합니다.

Chrome, Edge 또는 Firefox의 개발자 도구를 사용하여 특정 요청에 사용된 리퍼러 정책을 확인할 수도 있습니다. 이 글을 작성하는 시점에 Safari는 Referrer-Policy 헤더를 표시하지 않지만 전송된 Referer는 표시합니다.

Chrome DevTools의 네트워크 패널 스크린샷으로, Referer 및 Referrer-Policy가 표시되어 있습니다.
요청이 선택된 Chrome DevTools의 네트워크 패널

웹사이트에 어떤 정책을 설정해야 할까요?

strict-origin-when-cross-origin (또는 더 엄격한 값)와 같은 개인 정보 보호 강화 정책을 명시적으로 설정하는 것이 좋습니다.

'명시적으로' 지정해야 하는 이유는 무엇인가요?

리퍼러 정책을 설정하지 않으면 브라우저의 기본 정책이 사용됩니다. 실제로 웹사이트는 브라우저의 기본값을 따르는 경우가 많습니다. 하지만 다음과 같은 이유로 이상적이지 않습니다.

  • 브라우저마다 기본 정책이 다르므로 브라우저 기본값을 사용하는 경우 브라우저마다 사이트의 동작이 예측 불가능해집니다.
  • 브라우저에서는 교차 출처 요청에 대해 strict-origin-when-cross-origin와 같은 더 엄격한 기본값과 리퍼러 자르기와 같은 메커니즘을 채택하고 있습니다. 브라우저 기본값이 변경되기 전에 개인 정보 보호 강화 정책을 명시적으로 선택하면 제어할 수 있으며 원하는 대로 테스트를 실행할 수 있습니다.

strict-origin-when-cross-origin (또는 더 엄격한 버전)을 사용하는 이유는 무엇인가요?

안전하고 개인 정보 보호를 강화하며 유용한 정책이 필요합니다. '유용'의 의미는 추천인에게 원하는 내용에 따라 다릅니다.

  • 보안: 웹사이트에서 HTTPS를 사용하는 경우 (사용하지 않는 경우 우선순위를 지정하세요) 웹사이트의 URL이 HTTPS가 아닌 요청에서 유출되지 않도록 해야 합니다. 네트워크의 모든 사용자가 이를 볼 수 있으므로 유출되면 사용자가 중간자 공격에 노출됩니다. no-referrer-when-downgrade, strict-origin-when-cross-origin, no-referrer, strict-origin 정책은 이 문제를 해결합니다.
  • 개인 정보 보호 강화: 교차 출처 요청의 경우 no-referrer-when-downgrade에서 전체 URL을 공유하므로 개인 정보 보호 문제가 발생할 수 있습니다. strict-origin-when-cross-originstrict-origin는 출처만 공유하고 no-referrer는 아무것도 공유하지 않습니다. 따라서 strict-origin-when-cross-origin, strict-origin, no-referrer가 개인 정보 보호 강화 옵션으로 남습니다.
  • 유용: no-referrerstrict-origin는 동일 출처 요청의 경우에도 전체 URL을 공유하지 않습니다. 전체 URL이 필요한 경우 strict-origin-when-cross-origin가 더 나은 선택입니다.

따라서 일반적으로 strict-origin-when-cross-origin이(가) 적절한 선택입니다.

예: strict-origin-when-cross-origin 정책 설정

index.html:

<meta name="referrer" content="strict-origin-when-cross-origin" />

또는 서버 측(예: Express)에서 다음과 같이 할 수 있습니다.

const helmet = require('helmet');
app.use(helmet.referrerPolicy({policy: 'strict-origin-when-cross-origin'}));

strict-origin-when-cross-origin (또는 더 엄격한 설정)가 모든 사용 사례를 수용하지 못하는 경우 어떻게 해야 하나요?

이 경우 점진적 접근 방식을 취하세요. 웹사이트에 strict-origin-when-cross-origin와 같은 보호 정책을 설정하고 필요한 경우 특정 요청이나 HTML 요소에 더 허용적인 정책을 설정하세요.

예: 요소 수준 정책

index.html:

<head>
  <!-- document-level policy: strict-origin-when-cross-origin -->
  <meta name="referrer" content="strict-origin-when-cross-origin" />
  <head>
    <body>
      <!-- policy on this <a> element: no-referrer-when-downgrade -->
      <a src="…" href="…" referrerpolicy="no-referrer-when-downgrade"></a>
      <body></body>
    </body>
  </head>
</head>

Safari/WebKit은 크로스 사이트 요청에 대해 document.referrer 또는 Referer 헤더를 제한할 수 있습니다. 세부정보를 참고하세요.

예: 요청 수준 정책

script.js:

fetch(url, {referrerPolicy: 'no-referrer-when-downgrade'});

그 밖에 고려해야 할 사항은 무엇인가요?

정책은 웹사이트와 사용 사례에 따라 달라야 하며, 이는 귀하, 귀하의 팀, 귀하의 회사가 결정합니다. 일부 URL에 식별 정보 또는 민감한 정보가 포함된 경우 보호 정책을 설정하세요.

수신 요청 관련 권장사항

사이트에서 수신 요청의 리퍼러 URL을 사용하는 경우 취해야 할 조치에 관한 가이드라인은 다음과 같습니다.

사용자 데이터 보호

Referer에는 비공개, 개인 또는 식별 데이터가 포함될 수 있으므로 이러한 데이터로 취급해야 합니다.

수신 리퍼러가 변경될 수 있음 {referer-can-change}

수신되는 크로스 오리진 요청의 리퍼러를 사용하는 데는 몇 가지 제한사항이 있습니다.

  • 요청 배출기의 구현을 제어할 수 없는 경우 수신하는 Referer 헤더 (및 document.referrer)에 관해 가정할 수 없습니다. 요청 배출기는 언제든지 no-referrer 정책으로 전환하거나 이전보다 더 엄격한 정책으로 전환할 수 있습니다. 즉, 이전보다 Referer에서 수신하는 데이터가 줄어듭니다.
  • 브라우저에서 기본적으로 Referrer-Policy strict-origin-when-cross-origin를 사용하는 경우가 늘고 있습니다. 즉, 발신자 사이트에 설정된 정책이 없는 경우 수신되는 교차 출처 요청에서 전체 리퍼러 URL 대신 출처만 수신될 수 있습니다.
  • 브라우저에서 Referer를 관리하는 방식을 변경할 수 있습니다. 예를 들어 일부 브라우저 개발자는 사용자 개인 정보를 보호하기 위해 교차 출처 하위 리소스 요청에서 항상 리퍼러를 출처로 자르기로 결정할 수 있습니다.
  • Referer 헤더 (및 document.referrer)에는 필요한 것보다 더 많은 데이터가 포함될 수 있습니다. 예를 들어 요청이 교차 출처인지 여부만 알고 싶은데 전체 URL이 있을 수 있습니다.

Referer의 대안

다음과 같은 경우 대안을 고려해야 할 수 있습니다.

  • 사이트의 필수 기능이 수신되는 크로스 오리진 요청의 리퍼러 URL을 사용합니다.
  • 사이트가 교차 출처 요청에서 필요한 리퍼러 URL 부분을 더 이상 수신하지 않습니다. 이는 요청 전송자가 정책을 변경하거나 설정된 정책이 없는데 브라우저 기본 정책이 변경된 경우(예: Chrome 85) 발생합니다.

대안을 정의하려면 먼저 리퍼러의 어떤 부분을 사용하고 있는지 분석하세요.

원본만 필요한 경우

  • 페이지에 대한 최상위 액세스 권한이 있는 스크립트에서 리퍼러를 사용하는 경우 window.location.origin를 대신 사용할 수 있습니다.
  • 사용 가능한 경우 OriginSec-Fetch-Site과 같은 헤더는 Origin을 제공하거나 요청이 교차 출처인지 설명하므로 필요한 것일 수 있습니다.

URL의 다른 요소 (경로, 쿼리 매개변수 등)가 필요한 경우

  • 요청 매개변수가 사용 사례를 처리할 수 있으므로 리퍼러를 파싱하는 작업을 하지 않아도 됩니다.
  • 페이지에 대한 최상위 액세스 권한이 있는 스크립트에서 리퍼러를 사용하는 경우 window.location.pathname가 대안으로 작동할 수 있습니다. URL의 경로 섹션만 추출하여 인수로 전달하므로 URL 매개변수의 민감한 정보가 전달되지 않습니다.

이러한 대안을 사용할 수 없는 경우 다음 단계를 따르세요.

  • 요청 배출기(예: site-one.example)가 일부 구성에서 필요한 정보를 명시적으로 설정하도록 시스템을 변경할 수 있는지 확인합니다.
    • 장점: 더 명시적이고, site-one.example 사용자의 개인 정보 보호를 강화하며, 미래에 더 잘 대응할 수 있습니다.
    • 단점: 내 쪽에서 또는 시스템 사용자가 해야 할 작업이 더 많아질 수 있습니다.
  • 요청을 내보내는 사이트가 no-referrer-when-downgrade의 요소별 또는 요청별 Referrer-Policy를 설정하는 데 동의하는지 확인합니다.
    • 단점: site-one.example 사용자의 개인 정보 보호 수준이 낮아질 수 있으며 일부 브라우저에서 지원되지 않을 수 있습니다.

크로스 사이트 요청 위조 (CSRF) 보호

요청 전송자는 no-referrer 정책을 설정하여 리퍼러를 전송하지 않기로 결정할 수 있으며, 악의적인 행위자는 리퍼러를 스푸핑할 수도 있습니다.

CSRF 토큰을 기본 보호로 사용하세요. 추가 보호를 위해 SameSite를 사용하고 Referer 대신 Origin(POST 및 CORS 요청에서 사용 가능) 및 Sec-Fetch-Site(사용 가능한 경우)과 같은 헤더를 사용하세요.

로깅 및 디버그

Referer에 있을 수 있는 사용자의 개인 정보 또는 민감한 정보를 보호해야 합니다.

원본만 사용하는 경우 Origin 헤더를 대안으로 사용할 수 있는지 확인하세요. 이렇게 하면 리퍼러를 파싱하지 않고도 디버깅 목적으로 필요한 정보를 더 간단하게 얻을 수 있습니다.

결제

결제 제공업체는 보안 검사를 위해 수신 요청의 Referer 헤더를 사용할 수 있습니다.

예를 들면 다음과 같습니다.

  • 사용자가 online-shop.example/cart/checkout에서 구매 버튼을 클릭합니다.
  • online-shop.example은 거래를 관리하기 위해 payment-provider.example로 리디렉션됩니다.
  • payment-provider.example는 이 요청의 Referer을 판매자가 설정한 허용된 Referer 값 목록과 비교합니다. 목록의 항목과 일치하지 않으면 payment-provider.example이 요청을 거부합니다. 일치하는 경우 사용자는 거래를 진행할 수 있습니다.

결제 흐름 보안 검사를 위한 권장사항

결제 제공업체는 Referer를 일부 공격에 대한 기본 검사로 사용할 수 있습니다. 하지만 Referer 헤더 자체는 확인을 위한 신뢰할 수 있는 기반이 아닙니다. 합법적인 판매자인지 여부와 관계없이 요청 사이트에서 결제 제공업체에 Referer 정보를 제공하지 않는 no-referrer 정책을 설정할 수 있습니다.

Referer를 살펴보면 no-referrer 정책을 설정하지 않은 순진한 공격자를 결제 제공업체가 포착하는 데 도움이 될 수 있습니다. Referer을 첫 번째 검사로 사용하는 경우:

  • Referer가 항상 존재한다고 가정하지 마세요. 있는 경우 원본인 최소 데이터에 대해서만 확인합니다.
    • 허용된 Referer 값 목록을 설정할 때는 출처만 포함하고 경로를 포함하지 마세요.
    • 예를 들어 online-shop.example에 허용되는 Referer 값은 online-shop.example/cart/checkout가 아닌 online-shop.example이어야 합니다. Referer가 전혀 없거나 요청 사이트의 출처만 있는 Referer 값을 예상하면 판매자의 Referrer-Policy에 관해 가정을 할 때 발생할 수 있는 오류를 방지할 수 있습니다.
  • Referer가 없거나 Referer가 있고 기본 Referer 출처 확인이 성공하면 다른 더 안정적인 확인 방법으로 이동할 수 있습니다.

결제를 더 안정적으로 확인하려면 요청자가 고유 키와 함께 요청 매개변수를 해싱하도록 합니다. 그러면 결제 서비스 제공업체에서 자체적으로 동일한 해시를 계산하고 계산 결과가 일치하는 경우에만 요청을 수락할 수 있습니다.

리퍼러 정책이 없는 HTTP 판매자 사이트가 HTTPS 결제 제공업체로 리디렉션되면 Referer는 어떻게 되나요?

웹사이트에 설정된 정책이 없으면 대부분의 브라우저에서 기본적으로 strict-origin-when-cross-origin 또는 no-referrer-when-downgrade를 사용하므로 HTTPS 결제 제공업체에 대한 요청에 Referer가 표시되지 않습니다. Chrome의 새로운 기본 정책으로의 변경은 이 동작을 변경하지 않습니다.

결론

보호 리퍼러 정책은 사용자에게 더 많은 개인 정보를 제공하는 좋은 방법입니다.

사용자를 보호하는 다양한 기법에 대해 자세히 알아보려면 안전한 환경 컬렉션을 참고하세요.

리소스

특히 Kaustubha Govind, David Van Cleve, Mike West, Sam Dutton, Rowan Merewood, Jxck, Kayce Basques를 비롯한 모든 검토자에게 기여와 의견에 감사드립니다.