1.5. 서비스 구성

API 백엔드의 끝점 호스트인 Private Base URL 필드에 API 백엔드를 선언해야 합니다. APIcast는 모든 인증, 권한 부여, 속도 제한 및 통계가 처리된 후 모든 트래픽을 API 백엔드로 리디렉션합니다.

일반적으로 API의 프라이빗 기본 URL은 관리하는 도메인의 https://api-backend.yourdomain.com:443 (yourdomain.com)과 같습니다. 예를 들어, Twitter API와 통합하려는 경우 개인 기본 URL은 https://api.twitter.com/ 입니다. 이 예제에서는 3scale에서 호스팅하는 Echo API를 사용합니다 - 모든 경로를 수락하고 요청에 대한 정보를 반환하는 간단한 API (path, 요청 매개변수, 헤더 등). 프라이빗 기본 URL은 https://echo-api.3scale.net:443입니다.

개인 기본 URL

프라이빗(관리되지 않음) API가 작동하는지 테스트합니다. 예를 들어, Echo API의 경우 curl 명령을 사용하여 다음 호출을 수행할 수 있습니다.

curl "https://echo-api.3scale.net:443"

다음과 같은 응답을 받습니다.

{
    "method": "GET",
    "path": "/",
    "args": "",
    "body": "",
    "headers": {
      "HTTP_VERSION": "HTTP/1.1",
      "HTTP_HOST": "echo-api.3scale.net",
      "HTTP_ACCEPT": "*/*",
      "HTTP_USER_AGENT": "curl/7.51.0",
      "HTTP_X_FORWARDED_FOR": "2.139.235.79, 10.0.103.58",
      "HTTP_X_FORWARDED_HOST": "echo-api.3scale.net",
      "HTTP_X_FORWARDED_PORT": "443",
      "HTTP_X_FORWARDED_PROTO": "https",
      "HTTP_FORWARDED": "for=10.0.103.58;host=echo-api.3scale.net;proto=https"
    },
    "uuid": "ee626b70-e928-4cb1-a1a4-348b8e361733"
  }

API가 작동하는지 확인한 후 호스팅 스테이징 환경에 대한 테스트 호출을 구성해야 합니다. API test GET request 필드 (예: /v1/word/good.json)에 API에 기존 경로를 입력합니다.

페이지 오른쪽 하단의 Update & Test Staging Configuration 버튼을 클릭하여 설정을 저장합니다. 이렇게 하면 APIcast 구성이 3scale 호스트 스테이징 환경에 배포됩니다. 모든 것이 올바르게 구성되면 왼쪽의 수직선이 녹색으로 전환되어야 합니다.

1.5.1. 인증 설정 구성

자체 관리 배포 옵션 중 하나를 사용하는 경우 GUI에서 구성을 저장하고 스테이징 또는 프로덕션 공용 기본 URL 필드에 올바른 호스트를 추가하여 배포된 API 게이트웨이를 가리키는지 확인합니다. 프로덕션 게이트웨이에 대한 호출을 수행하기 전에 promo v.x to Production 버튼을 클릭합니다.

스테이징 섹션의 하단에서 샘플 curl 을 찾아서 콘솔에서 실행합니다.

curl "https://XXX.staging.apicast.io:443/v1/word/good.json?user_key=YOUR_USER_KEY"
참고

위와 동일한 응답이 표시되지만 이번에는 요청이 3scale 호스팅 APIcast 인스턴스를 통과합니다. 참고: 서비스에 유효한 자격 증명이 있는 애플리케이션이 있어야 합니다. 3scale까지 등록할 때 생성된 기본 API 서비스를 사용하는 경우 이미 애플리케이션이 있어야 합니다. 그렇지 않으면 테스트 curl에 USER_KEY 또는 APP_IDAPP_KEY 값이 표시되면 먼저 이 서비스에 대한 애플리케이션을 생성해야 합니다.

이제 API가 3scale과 통합되었습니다.

3scale 호스팅 APIcast 게이트웨이는 인증 정보를 검증하며 애플리케이션의 애플리케이션 계획에 대해 정의한 속도 제한을 적용합니다. 자격 증명이 없거나 잘못된 인증 정보를 사용하여 호출하려고 하면 오류 메시지가 표시됩니다. 코드 및 메시지 텍스트를 구성할 수 있습니다. 자세한 내용은 Advanced APIcast 구성 문서를 확인하십시오.