Red Hat Summit11.4. 참조 필터링
3scale은 애플리케이션이 API에 액세스할 수 있는 IP 주소 또는 도메인 이름을 허용 목록에 추가하는 데 사용할 수 있는 참조 필터링 기능을 지원합니다. API 클라이언트는 참조 자 헤더에 참조 값을 지정합니다. 참조 헤더의 목적 및 사용은 RFC 7231, section 5.5.2: Referer 에 설명되어 있습니다. Referer 는 RFC 및 헤더에서 참조 자의 공식 잘못된 철자입니다.
참조 필터링 기능이 작동하려면 서비스 정책 체인에서 APIcast Referrer 정책을 활성화해야 합니다.
참조 필터링 기능을 활성화하려면 [your_API_name] > 애플리케이션 > 설정 > 사용 규칙으로 이동합니다. 참조 필요 필터링을 선택하고 제품 업데이트를 클릭합니다.
API에 액세스할 수 있는 개발자는 개발자 포털에서 허용된 도메인/IP 참조자를 구성해야 합니다.
이 서비스에 속하는 모든 애플리케이션에 대한 애플리케이션 세부 정보 페이지에 새 참조 필터 섹션이 표시됩니다. 여기에서 관리자는 이 애플리케이션에 허용되는 참조 헤더 값의 허용 목록을 구성할 수도 있습니다.
애플리케이션당 최대 5개의 참조 값을 설정할 수 있습니다.
값은 라틴 문자, 숫자 및 특수 문자 *, ., 및 - 로만 구성할 수 있습니다. * 와일드카드 값에 사용할 수 있습니다. 값이 * 로 설정되면 참조 값이 허용되므로 참조자 검사를 건너뜁니다.
참조 필터링 기능 및 3scale API Management Referrer 정책이 활성화되면 권한 부여는 다음과 같이 작동합니다.
- 참조 필터가 지정되지 않은 애플리케이션은 일반적으로 제공된 자격 증명을 통해서만 권한이 부여됩니다.
-
Referrer Filters 값이 설정된 애플리케이션의 경우 APIcast는 요청의 참조 헤더에서 참조 값을 추출하고 AuthRep(authorize 및 report) 요청의
참조요청에서 Service Management API로 보냅니다.다음 표는 참조 필터링 매개변수의 다양한 조합에 대한 AuthRep 응답을 보여줍니다.
참조 매개변수 가 전달됩니까? | 앱에 대해 구성된 참조 필터 | 참조 매개변수 값 | HTTP 응답 | 응답 본문 |
|---|---|---|---|---|
| 제공됨 | 제공됨 | 일치 참조 필터 | 200 OK |
|
| 제공됨 | 제공되지 않음 | 일치 참조 필터 | 200 OK |
|
| 제공됨 | 제공됨 | 참조 필터와 일치하지 않음 | 409 충돌 |
< |
| 제공됨 | 제공되지 않음 | 참조 필터와 일치하지 않음 | 200 OK |
|
| 제공됨 | 제공됨 |
| 200 OK |
|
| 제공됨 | 제공되지 않음 |
| 200 OK |
|
| 제공되지 않음 | 제공됨 | — | 409 충돌 |
|
| 제공되지 않음 | 제공되지 않음 | — | 200 OK |
|
AuthRep에서 승인하지 않은 호출은 "Authorization Failed" 오류와 함께 APIcast에서 거부됩니다. 서비스 통합 페이지에서 정확한 상태 코드와 오류 메시지를 구성할 수 있습니다.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}