12.4. ActiveDocs 문제
경우에 따라 ActiveDocs를 이동할 때 명령줄에서 API를 호출할 때 작동하는 경우가 있습니다.
ActiveDocs 호출이 작동하도록 하려면 측에서 프록시를 통해 이러한 호출을 보냅니다. 이 프록시는 예상하지 않은 경우 API에 문제를 일으킬 수 있는 특정 헤더를 추가합니다. 이 경우 다음 단계를 수행합니다.
12.4.1. petstore.swagger.io 사용
Swagger는 Swagger-ui에서 최신 버전의 swagger-ui를 통과하는 데 사용할 수 있는 Swagger.swagger.io에서 호스트된 swagger-ui를 제공합니다. swagger-ui와 ActiveDocs 둘 다 같은 방식으로 실패하면 ActiveDocs 또는 ActiveDocs 프록시의 문제를 배제하고 자체 사양에 대한 문제 해결에 중점을 둘 수 있습니다. 또는 현재 버전의 swagger-ui에서 알려진 문제가 있는지 swagger-ui GitHub 리포지토리를 확인할 수 있습니다.
12.4.2. 방화벽에서 ActiveDocs 프록시의 연결을 허용하는지 확인합니다.
API를 사용하여 클라이언트의 IP 주소를 허용 목록에 추가하지 않는 것이 좋습니다. ActiveDocs 프록시는 고가용성을 위해 유동 IP 주소를 사용하며 현재 이러한 IP에 대한 변경 사항을 알릴 수 있는 메커니즘이 없습니다.
12.4.3. 잘못된 인증 정보를 사용하여 API 호출
ActiveDocs 프록시가 올바르게 작동하는지 확인하는 한 가지 방법은 잘못된 인증 정보를 사용하여 API를 호출하는 것입니다. 이렇게 하면 ActiveDocs 프록시와 API 게이트웨이 모두에서 문제를 확인하거나 해제하는 데 도움이 됩니다.
API 호출에서 403 코드를 다시 가져오는 경우(또는 잘못된 자격 증명을 위해 게이트웨이에 구성한 코드에서) 호출이 게이트웨이에 도달하므로 API에 문제가 발생합니다.
12.4.4. 호출 비교
ActiveDocs와 ActiveDocs 외부에서 발생한 호출 간 헤더와 매개변수의 차이점을 확인하려면 온프레미스 또는 Runscope과 같은 서비스를 통해 호출을 실행합니다. 이렇게 하면 API로 보내기 전에 HTTP 호출을 검사하고 비교할 수 있습니다. 그러면 문제가 발생할 수 있는 요청에서 잠재적인 헤더 및/또는 매개변수를 식별할 수 있습니다.
