Jump To Close Expand all Collapse all Table of contents API 게이트웨이 관리 preface I 부. API 게이트웨이 Expand section "I 부. API 게이트웨이" Collapse section "I 부. API 게이트웨이" 1. 운영 APIcast Expand section "1. 운영 APIcast" Collapse section "1. 운영 APIcast" 1.1. 공개 기반 URL 1.2. 매핑 규칙 Expand section "1.2. 매핑 규칙" Collapse section "1.2. 매핑 규칙" 1.2.1. 제품 및 백엔드에서 규칙 매핑 1.2.2. 매핑 규칙 일치 1.2.3. 룰 워크플로 매핑 1.3. 호스트 헤더 1.4. API 백엔드 보호 1.5. 개인 API와 함께 APIcast 사용 1.6. OpenTracing을 사용하여 APIcast 구성 Expand section "1.6. OpenTracing을 사용하여 APIcast 구성" Collapse section "1.6. OpenTracing을 사용하여 APIcast 구성" 1.6.1. 사전 요구 사항 1.6.2. 절차 1.6.3. 추가 정보 1.6.4. OpenShift 인스턴스에 Jaeger 설치 2. Docker 컨테이너화된 환경 운영 Expand section "2. Docker 컨테이너화된 환경 운영" Collapse section "2. Docker 컨테이너화된 환경 운영" 2.1. Docker 컨테이너화된 환경에서 APIcast 문제 해결 Expand section "2.1. Docker 컨테이너화된 환경에서 APIcast 문제 해결" Collapse section "2.1. Docker 컨테이너화된 환경에서 APIcast 문제 해결" 2.1.1. Docker 데몬 오류에 연결할 수 없습니다. 2.1.2. 기본 Docker 명령줄 인터페이스 명령 3. 고급 APIcast 구성 Expand section "3. 고급 APIcast 구성" Collapse section "3. 고급 APIcast 구성" 3.1. 시크릿 토큰 정의 3.2. 인증 정보 3.3. 오류 메시지 구성 3.4. 설정 내역 3.5. 디버깅 3.6. 경로 라우팅 4. APIcast 정책 Expand section "4. APIcast 정책" Collapse section "4. APIcast 정책" 4.1. APIcast 표준 정책 Expand section "4.1. APIcast 표준 정책" Collapse section "4.1. APIcast 표준 정책" 4.1.1. 3scale 인증 캐싱 4.1.2. 3scale Batcher 4.1.3. 3scale Referrer 4.1.4. 익명 액세스 4.1.5. Camel 서비스 Expand section "4.1.5. Camel 서비스" Collapse section "4.1.5. Camel 서비스" 4.1.5.1. 설정 Expand section "4.1.5.1. 설정" Collapse section "4.1.5.1. 설정" 4.1.5.1.1. 사용 사례 예 4.1.6. 조건부 정책 Expand section "4.1.6. 조건부 정책" Collapse section "4.1.6. 조건부 정책" 4.1.6.1. 조건 Expand section "4.1.6.1. 조건" Collapse section "4.1.6.1. 조건" 4.1.6.1.1. 유동 변수에서 지원되는 변수 4.1.7. 컨텐츠 캐싱 Expand section "4.1.7. 컨텐츠 캐싱" Collapse section "4.1.7. 컨텐츠 캐싱" 4.1.7.1. 지원되는 구성 4.1.7.2. 업스트림 응답 헤더 4.1.8. CORS 요청 처리 4.1.9. 사용자 정의 지표 Expand section "4.1.9. 사용자 정의 지표" Collapse section "4.1.9. 사용자 정의 지표" 4.1.9.1. 사용자 정의 메트릭의 제한 사항 4.1.9.2. 요청 흐름 예 4.1.9.3. 구성 예 4.1.10. 에코 4.1.11. 에지 제한 Expand section "4.1.11. 에지 제한" Collapse section "4.1.11. 에지 제한" 4.1.11.1. 제한 유형 4.1.11.2. 제한 정의 4.1.11.3. 유동 템플릿 4.1.11.4. 조건 적용 4.1.11.5. 속도 제한 카운터의 스토리지 구성 4.1.11.6. 오류 처리 4.1.12. 헤더 수정 4.1.13. IP 확인 4.1.14. JWT 청구 확인 Expand section "4.1.14. JWT 청구 확인" Collapse section "4.1.14. JWT 청구 확인" 4.1.14.1. JWT 청구 확인 정책 정보 4.1.14.2. 정책 체인에서 JWT 클레임 검사 정책 구성 Expand section "4.1.14.2. 정책 체인에서 JWT 클레임 검사 정책 구성" Collapse section "4.1.14.2. 정책 체인에서 JWT 클레임 검사 정책 구성" 4.1.14.2.1. 정책 구성 4.1.15. 유동 컨텍스트 디버그 4.1.16. 로깅 Expand section "4.1.16. 로깅" Collapse section "4.1.16. 로깅" 4.1.16.1. 모든 API에 대한 글로벌 구성 4.1.16.2. 예 4.1.16.3. 사용자 정의 로깅에 대한 추가 정보 4.1.17. 유지 관리 모드 4.1.18. OAuth 2.0 상호 TLS 클라이언트 인증 4.1.19. OAuth 2.0 토큰 세부 검사 4.1.20. 프록시 서비스 Expand section "4.1.20. 프록시 서비스" Collapse section "4.1.20. 프록시 서비스" 4.1.20.1. 설정 Expand section "4.1.20.1. 설정" Collapse section "4.1.20.1. 설정" 4.1.20.1.1. 사용 사례 예 4.1.21. 제한 헤더 속도 Expand section "4.1.21. 제한 헤더 속도" Collapse section "4.1.21. 제한 헤더 속도" 4.1.21.1. RateLimit 헤더 4.1.22. Retry 4.1.23. RH-SSO/Keycloak 역할 검사 4.1.24. 라우팅 Expand section "4.1.24. 라우팅" Collapse section "4.1.24. 라우팅" 4.1.24.1. 라우팅 규칙 4.1.24.2. 요청 경로 규칙 4.1.24.3. 헤더 규칙 4.1.24.4. 쿼리 인수 규칙 4.1.24.5. JWT 클레임 규칙 4.1.24.6. 다중 작업 규칙 4.1.24.7. 규칙 결합 4.1.24.8. catch-all 규칙 4.1.24.9. 지원되는 작업 4.1.24.10. 유동 템플릿 4.1.24.11. host _header에서 사용되는 호스트설정 4.1.25. SOAP 4.1.26. TLS 클라이언트 인증서 유효성 검사 Expand section "4.1.26. TLS 클라이언트 인증서 유효성 검사" Collapse section "4.1.26. TLS 클라이언트 인증서 유효성 검사" 4.1.26.1. TLS 클라이언트 인증서 유효성 검사를 사용하도록 APIcast 설정 Expand section "4.1.26.1. TLS 클라이언트 인증서 유효성 검사를 사용하도록 APIcast 설정" Collapse section "4.1.26.1. TLS 클라이언트 인증서 유효성 검사를 사용하도록 APIcast 설정" 4.1.26.1.1. 정책에서 작동하도록 APIcast 설정 4.1.26.2. 정책 체인에서 TLS 클라이언트 인증서 유효성 검사 구성 Expand section "4.1.26.2. 정책 체인에서 TLS 클라이언트 인증서 유효성 검사 구성" Collapse section "4.1.26.2. 정책 체인에서 TLS 클라이언트 인증서 유효성 검사 구성" 4.1.26.2.1. 정책 구성 4.1.26.3. TLS 클라이언트 인증서 유효성 검사 정책의 기능 확인 Expand section "4.1.26.3. TLS 클라이언트 인증서 유효성 검사 정책의 기능 확인" Collapse section "4.1.26.3. TLS 클라이언트 인증서 유효성 검사 정책의 기능 확인" 4.1.26.3.1. 정책 기능 확인 4.1.26.4. 화이트리스트에서 인증서 제거 Expand section "4.1.26.4. 화이트리스트에서 인증서 제거" Collapse section "4.1.26.4. 화이트리스트에서 인증서 제거" 4.1.26.4.1. 인증서 제거 4.1.26.5. 참고 자료 4.1.27. TLS 종료 Expand section "4.1.27. TLS 종료" Collapse section "4.1.27. TLS 종료" 4.1.27.1. 정책 체인에서 TLS 종료 구성 Expand section "4.1.27.1. 정책 체인에서 TLS 종료 구성" Collapse section "4.1.27.1. 정책 체인에서 TLS 종료 구성" 4.1.27.1.1. 정책 구성 4.1.27.2. TLS 종료 정책의 기능 확인 Expand section "4.1.27.2. TLS 종료 정책의 기능 확인" Collapse section "4.1.27.2. TLS 종료 정책의 기능 확인" 4.1.27.2.1. 정책 기능 확인 4.1.27.3. TLS 종료에서 파일 제거 Expand section "4.1.27.3. TLS 종료에서 파일 제거" Collapse section "4.1.27.3. TLS 종료에서 파일 제거" 4.1.27.3.1. 인증서 제거 4.1.28. 업스트림 4.1.29. 업스트림 연결 Expand section "4.1.29. 업스트림 연결" Collapse section "4.1.29. 업스트림 연결" 4.1.29.1. 정책 체인에서 업스트림 연결 구성 Expand section "4.1.29.1. 정책 체인에서 업스트림 연결 구성" Collapse section "4.1.29.1. 정책 체인에서 업스트림 연결 구성" 4.1.29.1.1. 정책 구성 4.1.30. 업스트림 상호 TLS Expand section "4.1.30. 업스트림 상호 TLS" Collapse section "4.1.30. 업스트림 상호 TLS" 4.1.30.1. 정책 체인에서 업스트림 상호 TLS 구성 4.1.31. URL 다시 작성 Expand section "4.1.31. URL 다시 작성" Collapse section "4.1.31. URL 다시 작성" 4.1.31.1. 경로를 다시 작성하기 위한 명령 4.1.31.2. 쿼리 문자열을 다시 작성하기 위한 명령 4.1.32. 캡처를 사용하여 URL 재작성 4.2. 관리 포털에서 정책 활성화 4.3. 사용자 정의 APIcast 정책 생성 4.4. APIcast에 사용자 정의 정책 추가 Expand section "4.4. APIcast에 사용자 정의 정책 추가" Collapse section "4.4. APIcast에 사용자 정의 정책 추가" 4.4.1. APIcast 배포에 사용자 지정 정책 추가 4.4.2. 포함된 APIcast에 사용자 정의 정책 추가 4.4.3. 다른 OpenShift Container Platform에서 APIcast에 사용자 정의 정책 추가 4.5. 3scale에서 정책 체인 생성 4.6. 정책 체인 JSON 구성 파일 생성 5. APIcast 네이티브 배포와 정책 체인 통합 Expand section "5. APIcast 네이티브 배포와 정책 체인 통합" Collapse section "5. APIcast 네이티브 배포와 정책 체인 통합" 5.1. 정책에서 변수 및 필터 사용 6. Fuse의 정책 확장을 사용하여 3scale 메시지 컨텐츠 변환 Expand section "6. Fuse의 정책 확장을 사용하여 3scale 메시지 컨텐츠 변환" Collapse section "6. Fuse의 정책 확장을 사용하여 3scale 메시지 컨텐츠 변환" 6.1. Fuse에서 Apache Camel 변환과 APIcast 통합 6.2. OpenShift의 Fuse에서 Apache Camel을 사용하여 생성된 APIcast 정책 확장 구성 7. APIcast 환경 변수 8. 성능 향상을 위해 APIcast 구성 Expand section "8. 성능 향상을 위해 APIcast 구성" Collapse section "8. 성능 향상을 위해 APIcast 구성" 8.1. 일반 지침 8.2. 기본 캐싱 8.3. 비동기 보고 스레드 8.4. 3scale Batcher 정책 9. Prometheus에 3scale APIcast 지표 노출 Expand section "9. Prometheus에 3scale APIcast 지표 노출" Collapse section "9. Prometheus에 3scale APIcast 지표 노출" 9.1. Prometheus 정보 Expand section "9.1. Prometheus 정보" Collapse section "9.1. Prometheus 정보" 9.1.1. Prometheus 쿼리 9.2. Prometheus와 APIcast 통합 Expand section "9.2. Prometheus와 APIcast 통합" Collapse section "9.2. Prometheus와 APIcast 통합" 9.2.1. 추가 옵션 9.3. 3scale APIcast의 OpenShift 환경 변수 9.4. Prometheus에 노출된 3scale APIcast 지표 II 부. API 버전 관리 Expand section "II 부. API 버전 관리" Collapse section "II 부. API 버전 관리" 10. API 버전 관리 Expand section "10. API 버전 관리" Collapse section "10. API 버전 관리" 10.1. 목적 10.2. 사전 요구 사항 10.3. URL 버전 관리 10.4. 끝점 버전 지정 10.5. 사용자 정의 헤더 버전 지정 III 부. API 인증 Expand section "III 부. API 인증" Collapse section "III 부. API 인증" 11. 인증 패턴 Expand section "11. 인증 패턴" Collapse section "11. 인증 패턴" 11.1. 지원되는 인증 패턴 11.2. 인증 패턴 설정 Expand section "11.2. 인증 패턴 설정" Collapse section "11.2. 인증 패턴 설정" 11.2.1. 서비스에 대한 인증 모드를 선택합니다 11.2.2. 사용할 인증 모드를 선택합니다 11.2.3. API에서 올바른 유형의 인증 정보를 수락하는지 확인하십시오. 11.2.4. 자격 증명을 테스트할 애플리케이션 생성 11.3. 표준 인증 패턴 Expand section "11.3. 표준 인증 패턴" Collapse section "11.3. 표준 인증 패턴" 11.3.1. API 키 11.3.2. app_id 및 App_Key 쌍 11.3.3. OpenID Connect 11.4. 참조 필터링 12. OpenID Connect 통합 Expand section "12. OpenID Connect 통합" Collapse section "12. OpenID Connect 통합" 12.1. JWT 확인 및 APIcast의 구문 분석 12.2. zync-que를 통한 클라이언트 인증 정보 동기화 12.3. Red Hat Single Sign-On 통합 설정 Expand section "12.3. Red Hat Single Sign-On 통합 설정" Collapse section "12.3. Red Hat Single Sign-On 통합 설정" 12.3.1. 사용자 정의 CA 인증서를 사용하도록 zync-que 구성 12.3.2. Red Hat Single Sign-On 설정 12.3.3. 3scale 설정 12.4. 타사 ID 공급자와 HTTP 통합 구성 Expand section "12.4. 타사 ID 공급자와 HTTP 통합 구성" Collapse section "12.4. 타사 ID 공급자와 HTTP 통합 구성" 12.4.1. 사전 요구 사항 12.4.2. 절차 12.4.3. zync REST API 예 Expand section "12.4.3. zync REST API 예" Collapse section "12.4.3. zync REST API 예" 12.4.3.1. 사전 요구 사항 12.4.3.2. 클라이언트 생성, 업데이트 및 삭제 12.4.3.3. 페이로드 12.4.3.4. OAuth2 인증 사용 12.5. OAuth 2.0 지원 흐름 Expand section "12.5. OAuth 2.0 지원 흐름" Collapse section "12.5. OAuth 2.0 지원 흐름" 12.5.1. OAuth 2.0 지원 흐름 작동 방식 12.5.2. OAuth 2.0 지원 흐름 구성 12.6. 통합을 테스트합니다 Expand section "12.6. 통합을 테스트합니다" Collapse section "12.6. 통합을 테스트합니다" 12.6.1. 클라이언트 동기화 테스트 12.6.2. API 인증 흐름 테스트 12.7. 통합의 예 Settings Close Language: 한국어 简体中文 日本語 English Language: 한국어 简体中文 日本語 English Format: Multi-page Single-page Format: Multi-page Single-page Language and Page Formatting Options Language: 한국어 简体中文 日本語 English Language: 한국어 简体中文 日本語 English Format: Multi-page Single-page Format: Multi-page Single-page 10.2. 사전 요구 사항 이 퀵 스타트 가이드를 사용하기 전에 API를 3scale에 연결하는 기본 사항을 완료합니다. Previous Next
