54.5. 역방향 프록시를 통해 OpenAPI에 액세스

역방향 프록시를 통해 OpenAPI JSON 문서 또는 OpenAPI UI에 액세스하려면 다음 옵션을 설정합니다.

  • CXFServlet use-x-forwarded-headers init 매개변수를 true 로 설정합니다.

    • Spring Boot에서 매개 변수 이름 앞에 cxf.servlet.init 를 접두사로 지정합니다. 

      cxf.servlet.init.use-x-forwarded-headers=true

    • Karaf에서 installDir/etc/org.apache.cxf.osgi.cfg 구성 파일에 다음 행을 추가합니다. 

      cxf.servlet.init.use-x-forwarded-headers=true

      참고: etc 디렉터리에 org.apache.cxf.osgi.cfg 파일이 아직 없는 경우 하나를 생성할 수 있습니다.

  • OpenApiFeature basePath 옵션의 값을 지정하고 OpenAPI가 basePath 값을 캐싱하지 못하도록 하려면 OpenApiFeature usePathBasedConfig 옵션을 TRUE 로 설정합니다. 

    <bean class="org.apache.cxf.jaxrs.openapi.OpenApiFeature">
    <property name="usePathBasedConfig" value="TRUE" />
</bean>