기존 OpenAPI 서비스에서 REST 프록시 API 작성

파일을 업로드한 후 OpenAPI 스펙이 평가되고 올바른지 여부를 나타내는 메시지가 표시됩니다.

• 제목은 특수 문자를 포함할 수 있지만 사용자 인터페이스에서 쉽게 표시할 수 있도록 짧게 유지해야 합니다.
• 이름 이 자동으로 입력됩니다. 이름 필드의 값은 개발자 툴킷 CLI 명령에서 API를 식별하는 데 사용되는 단일 문자열입니다. 초안 API를 관리하는 CLI 명령어를 확인하려면 툴킷 CLI 참조 문서를 참조하십시오.
• 버전 은 API OpenAPI 정의의 info.version 특성 값에 해당합니다. version.release.modification 버전 번호 지정 체계를 사용하는 것이 좋습니다(예: 1.0.0).
• 기본 경로는 API의 URL 세그먼트이며 경로 또는 오퍼레이션에 대한 추가 세그먼트 또는 호스트 이름을 포함하지 않습니다. 기본 경로는 특수 문자를 포함할 수 없으며 / 문자로 시작해야 합니다. 경로가 비어 있는 경우에도 마찬가지입니다.
• 선택적 설명은 API를 식별하는 데 도움이 됩니다.

• 클라이언트 ID를 사용한 보안 설정 - 애플리케이션이 클라이언트 ID(API 키)를 제공하도록 요구하려면 이 옵션을 선택하십시오. 그러면 X-IBM-Client-Id 매개변수가 API의 요청 헤더에 포함됩니다. 선택된 경우, 각각의 키(각각의 클라이언트 ID) 기준으로 API 호출 수를 제한할지 여부를 선택할 수 있습니다.
  • 키 기준으로 API 호출 제한 - 선택된 경우 사용자에게 필요한 비율 한계를 구성해야 합니다. 비율 한계는 기간(시, 분, 월, 일) 내에 허용된 최대 호출 수를 제어합니다. 예를 들어 시간당 100개 호출입니다.
• CORS - API에 대한 CORS(Cross-Origin Resource Sharing) 지원을 사용으로 설정하려면 이 옵션을 선택하십시오. 이 옵션을 사용하면 다른 도메인에서 API에 액세스할 수 있습니다.
  참고:

  • CORS 지원은 오직 에서만 가능합니다 DataPower® API Gateway.
  • CORS가 활성화되면 API Gateway는 cors 프리플로우 정책을 실행하여 API에 대한 모든 CORS 요청을 처리합니다.
  • CORS가 활성화되고 프리플라이트 요청이 수신되면 다음 API 조치만 수행됩니다.
    • cors 프리플로우 정책이 적절한 응답 헤더를 구성합니다.
    • 응답 헤더가 설정됩니다.
  • 프리플라이트 요청이 수신되면 request.attributes.isCORSPreflight 플래그가 true로 설정됩니다.
  • 모든 사전 실행 요청에 대해, ` CORS ` security 이 활성화되었는지 여부와 관계없이 ` client-identification preflow` 정책은 항상 건너뜁니다.

요약 패널이 정의가 작성되었다는 메시지를 표시하고 선택된 보안 옵션 및 비율 한계가 적용됩니다.

API 활성화 옵션을 선택한 경우, 테스트에 사용할 수 있는 API 엔드포인트 URL 가 마법사에 표시됩니다. 클라이언트 ID를 사용하여 보안 설정을 선택한 경우에도 마법사는 사용자가 사용할 수 있는 클라이언트 ID 및 클라이언트 시크릿을 표시합니다.