AWS WAF 토큰 도메인 및 도메인 목록

클라이언트용 토큰을 AWS WAF 생성할 때 토큰 도메인으로 구성합니다. AWS WAF 는 웹 요청에서 토큰을 검사할 때 해당 도메인이 웹 ACL에 유효한 것으로 간주되는 도메인과 일치하지 않는 경우 토큰을 유효하지 않은 것으로 간주하여 거부합니다.

기본적으로 도메인 설정이 웹 ACL과 연결된 리소스의 호스트 도메인과 정확히 일치하는 AWS WAF 토큰만 허용합니다. 웹 요청의 Host 헤더 값입니다. 브라우저의 JavaScript window.location.hostname 속성 및 주소 표시줄에 표시되는 주소에서 이 도메인을 찾을 수 있습니다.

다음 섹션에 설명된 바와 같이 웹 ACL 구성에서 허용 가능한 토큰 도메인을 지정할 수도 있습니다. 이 경우 호스트 헤더와 정확히 일치하는 항목과 토큰 도메인 목록에 있는 도메인과 일치하는 항목을 모두 AWS WAF 수락합니다.

도메인을 설정하고 웹 ACL에서 AWS WAF 토큰을 평가할 때 사용할 토큰 도메인을 지정할 수 있습니다. gov.au와 같은 공개 접미사는 도메인으로 지정할 수 없습니다. 사용할 수 없는 도메인의 경우 공개 접미사 목록의 https://publicsuffix.org/list/public_suffix_list.dat 목록을 참조하세요.

AWS WAF 웹 ACL 토큰 도메인 목록 구성

허용하려는 AWS WAF 추가 도메인이 포함된 토큰 도메인 목록을 제공하여 여러 보호된 리소스 간에 토큰을 공유하도록 웹 ACL을 구성할 수 있습니다. 토큰 도메인 목록을 AWS WAF 사용해도 여전히 리소스의 호스트 도메인을 수락합니다. 또한 접두사가 붙은 하위 도메인을 포함하여 토큰 도메인 목록의 모든 도메인을 허용합니다.

예를 들어 토큰 도메인 목록의 도메인 사양 example.com은 example.com(http://example.com/), api.example.com(http://api.example.com/) 및 www.example.com(http://www.example.com/)와 일치합니다. example.api.com(http://example.api.com/) 또는 apiexample.com(http://apiexample.com/)과는 일치하지 않습니다.

웹 ACL을 만들거나 편집할 때 웹 ACL에서 토큰 도메인 목록을 구성할 수 있습니다. 웹 ACL의 관리에 대한 일반적인 정보는 웹 ACL 작업 섹션을 참조하세요.

AWS WAF 토큰 도메인 설정

AWS WAF 챌린지 스크립트의 요청에 따라 토큰을 생성하며, 이 토큰은 애플리케이션 통합 SDK와 Challenge 및 CAPTCHA 규칙 작업에 의해 실행됩니다.

토큰에 AWS WAF 설정하는 도메인은 토큰을 요청하는 챌린지 스크립트의 유형과 제공하는 추가 토큰 도메인 구성에 따라 결정됩니다. AWS WAF 토큰의 도메인을 구성에서 찾을 수 있는 가장 짧고 가장 일반적인 설정으로 설정합니다.

• JavaScript SDK — 하나 이상의 도메인을 포함할 수 있는 토큰 도메인 사양으로 JavaScript SDK를 구성할 수 있습니다. 구성하는 도메인은 보호된 호스트 도메인과 웹 ACL의 토큰 도메인 목록을 기반으로 AWS WAF 수락할 도메인이어야 합니다.

  클라이언트용 토큰을 AWS WAF 발급할 때 토큰 도메인은 호스트 도메인과 일치하고 구성된 목록에 있는 도메인 중에서 호스트 도메인과 일치하고 가장 짧은 도메인으로 설정합니다. 예를 들어, 호스트 도메인이 api.example.com 이고 토큰 도메인 목록에 있는 경우 토큰은 example.com 호스트 도메인과 일치하고 길이가 더 짧기 때문에 토큰을 AWS WAF 사용합니다example.com. JavaScript API 구성에서 토큰 도메인 목록을 제공하지 않는 경우 도메인을 보호된 리소스의 호스트 도메인으로 AWS WAF 설정합니다.

  자세한 정보는 토큰에 사용할 도메인 제공을 참조하세요.

• 모바일 SDK - 애플리케이션 코드에서 토큰 도메인 속성을 사용하여 모바일 SDK를 구성해야 합니다. 이 속성은 AWS WAF 에서 보호된 호스트 도메인과 웹 ACL의 토큰 도메인 목록에 기반하여 허용할 도메인이어야 합니다.

  클라이언트용 토큰을 AWS WAF 발행할 때는 이 속성을 토큰 도메인으로 사용합니다. AWS WAF 모바일 SDK 클라이언트용으로 발행하는 토큰에는 호스트 도메인을 사용하지 않습니다.

  자세한 내용은 AWS WAF 모바일 SDK 사양의 WAFConfiguration domainName 설정을 참조하세요.

• Challenge조치 — 웹 ACL에서 토큰 도메인 목록을 지정하는 경우, 호스트 도메인과 목록에 있는 도메인 중에서 호스트 도메인과 일치하고 가장 짧은 도메인으로 토큰 도메인을 AWS WAF 설정합니다. 예를 들어, 호스트 도메인이 api.example.com 이고 토큰 도메인 목록에 있는 경우example.com, 호스트 도메인과 일치하고 더 짧기 때문에 토큰을 AWS WAF 사용합니다example.com. 웹 ACL에서 토큰 도메인 목록을 제공하지 않는 경우 도메인을 보호된 리소스의 호스트 도메인으로 AWS WAF 설정합니다.