9.4. ActiveDocs 문제

Swagger는 최신 버전의 swagger-ui를 통해 Swagger 사양 및 API를 테스트하는 데 사용할 수 있는 petstore.swagger.io에 호스팅된 swagger-ui를 제공합니다. swagger-ui와 ActiveDocs가 같은 방식으로 실패하는 경우 ActiveDocs 또는 ActiveDocs 프록시에 문제가 발생하지 않고 문제 해결에 중점을 둘 수 있습니다. 또는 swagger-ui의 현재 버전과 관련하여 알려진 문제가 있는지 swagger-ui GitHub 리포지토리를 확인할 수 있습니다.

API를 사용하는 클라이언트의 IP 주소를 허용 목록에 지정하지 않는 것이 좋습니다. ActiveDocs 프록시는 고가용성을 위해 유동 IP 주소를 사용하며 현재 이러한 IP에 대한 변경 사항을 알리는 메커니즘은 없습니다.

ActiveDocs 프록시가 올바르게 작동하는지 확인하는 한 가지 방법은 잘못된 인증 정보를 사용하여 API를 호출하는 것입니다. 이렇게 하면 ActiveDocs 프록시 및 API 게이트웨이 둘 다에 문제가 있는지 확인하거나 배제하는 데 도움이 됩니다.

API 호출에서 403 코드를 다시 가져오거나 잘못된 자격 증명을 위해 게이트웨이에 구성된 코드에서 가져온 경우 호출이 게이트웨이에 도달하므로 API에 문제가 있습니다.

ActiveDocs 외부와 ActiveDocs 외부에서 수행된 호출 간 헤더와 매개 변수의 차이점을 식별하려면 온프레미스 또는 Runscope와 같은 서비스를 통해 호출을 실행합니다. 이렇게 하면 HTTP 호출을 검사하고 비교한 후 API로 보낼 수 있습니다. 그러면 문제가 발생할 수 있는 요청에서 잠재적인 헤더 및/또는 매개 변수를 식별할 수 있습니다.