Application Integration 및 Apigee 프록시 통합 대상 시작하기

이 튜토리얼에서는 Apigee 프록시 마법사를 사용하여 통합 대상으로 프록시를 만드는 방법을 보여줍니다. 프록시는 기존 통합의 API 트리거 참조를 사용하여 통합에서 일련의 단계를 시작합니다.

아래 단계에서는 프록시가 호출될 때 통합을 성공적으로 실행하기 위해 통합 대상 프록시를 구성하는 방법을 설명합니다.

시작하기 전에

Apigee 로그인 사용자 인증 정보 및 조직 세부정보를 확인합니다. Apigee UI 내에서 Application Integration 기능과 프록시 마법사에 액세스하려면 이 정보가 필요합니다.
API 트리거 및 최소 1개 이상의 태스크로 통합을 만들고 게시합니다.
- API 트리거를 사용하는 통합을 아직 만들지 않았으면 API 페이로드 검색 및 이메일 전송의 단계를 수행합니다.
- 이후 단계에 사용되므로 만들려는 통합의 이름 또는 사용하려는 기존 통합의 이름을 기록해 둡니다.
Apigee 조직이 생성된 동일한 Google Cloud 프로젝트에서 Google 서비스 계정을 만들고 다음을 수행합니다.
- 서비스 계정에 Application Integration 호출자 역할(roles/integrations.applicationIntegrationInvokerRole)을 할당합니다. 사전 정의된 Application Integration 역할에 대한 자세한 내용은 사전 정의된 IAM 역할을 참조하세요.
- 사용자 계정(주 구성원)이 iam.serviceAccounts.actAs 권한이 있는 리소스에 서비스 계정을 연결할 수 있도록 허용합니다. 서비스 계정 권한에 대한 정보는 서비스 계정 인증 역할을 참조하세요.
API 프록시를 배포할 때 이 서비스 계정을 제공해야 합니다.
제한 없이 Application Integration을 사용하려면 통합 비용을 지불해야 합니다. Application Integration은 구독의 부가기능 서비스로 제공됩니다. 이미 Application Integration 사용 권한을 구매했으며 Google Cloud 프로젝트나 Apigee 조직에 대한 사용 권한을 설정하려면 Apigee 지원팀에 문의하세요. 하지만 Application Integration 사용 권한을 구매하려면 Apigee 영업팀에 문의하세요. Application Integration이 자동으로 사용 설정되면 다음 태스크를 수행합니다.
1. 다음 API를 사용 설정합니다.
  - Apigee API(apigee.googleapis.com)
  - Application Integration API(integrations.googleapis.com)
  - Secret Manager API(secretmanager.googleapis.com)
  - Connectors API(connectors.googleapis.com)
  API를 사용 설정하는 방법은 서비스 사용 설정을 참조하세요.
2. Apigee 조직에 통합 및 커넥터 부가기능을 사용 설정합니다.
  - 통합에 사용할 새 조직을 만드는 경우 다음 명령어를 실행합니다.
```
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{"name":"${ORG_ID}", "analyticsRegion":"us-west1", "authorized_network":"${NETWORK_ID}", "runtimeType":"CLOUD", "runtimeDatabaseEncryptionKeyName":"${ENCRYPTION_KEY_NAME}", "addonsConfig": {"integrationConfig": {"enabled": true}, "connectorsPlatformConfig":{"enabled":true}}}' "https://apigee.googleapis.com/v1/organizations?parent=projects/${PROJECT_ID}"
```
  - 기존 조직을 사용하는 경우에는 다음 명령어를 실행합니다.
```
curl -H "Authorization: Bearer $TOKEN" -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}:setAddons" -XPOST -d '{"addonsConfig":{"integrationConfig":{"enabled":true},"connectorsPlatformConfig":{"enabled":true}}}'
```
3. 다음 명령어를 사용하여 부가기능이 성공적으로 사용 설정되었는지 확인합니다.
```
curl -H "Authorization: Bearer $TOKEN"  -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}"
```
  명령어를 실행하면 다음과 비슷한 메시지가 표시됩니다.
```
{
  "name": "Test....",
  "createdAt": "1615483867669",
  "lastModifiedAt": "1615483873468",
  …...
  "addonsConfig": {
    "integrationConfig": {
      "enabled": true,
    "connectorsPlatformConfig": {
      "enabled": true
    }
  }
  }
```
  참고:
  - 부가기능 명령어를 실행하면 기존 부가기능을 덮어씁니다. 따라서 기존 부가기능이 있으면 이를 부가기능 명령어에 포함합니다.
  - 부가기능을 사용 중지하면 부가기능의 모든 구성이 삭제됩니다(기능). 예를 들어 통합 부가기능을 사용 중지하면 모든 통합이 삭제됩니다.
4. 다음 IAM 역할을 기본 Apigee 서비스 계정(service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com)에 할당합니다.
  - Application Integration 호출자(roles/integrations.applicationIntegrationInvokerRole)
  서비스 계정에 추가 역할 또는 권한을 부여하려면 액세스 권한 부여, 변경, 취소를 참조하세요.

Application Integration 대상 프록시 만들기

Apigee UI에서 통합 대상 프록시를 만들려면 다음을 수행합니다.

Apigee UI로 이동하고 로그인합니다.
UI 왼쪽 상단의 드롭다운 메뉴를 사용해 조직을 선택합니다.
기본 뷰에서 API 프록시를 클릭합니다.
또는 왼쪽 탐색 메뉴에서 개발 > API 프록시를 선택할 수 있습니다.
환경 드롭다운 목록에서 새 API 프록시를 만들 환경을 선택합니다.
새로 만들기를 클릭합니다.
프록시 유형 표시에서 통합 대상을 선택합니다.
프록시 만들기 마법사가 시작됩니다.
프록시 세부정보 구성 페이지에서 다음 세부정보를 제공하세요.
- 이름: 인스턴스의 이름을 입력합니다.
  프록시 이름에는 영숫자 문자, 대시, 밑줄만 사용할 수 있습니다.
- 기본 경로: 프록시 이름에 따라 자동으로 채워집니다.
  기본 경로는 API에 요청을 수행하는 데 사용되는 URL의 일부입니다. Apigee는 URL을 사용하여 수신 요청을 적절한 API 프록시로 일치시키며 라우팅합니다.
- 설명: (선택사항) 프록시에 대해 간략한 설명을 입력합니다.
  예를 들면 Proxy test for Application Integration입니다.
- 통합 리전: 드롭다운 목록에서 통합 리전을 선택합니다.
- 통합 대상: 드롭다운 목록에서 통합 대상을 선택합니다. 통합 대상 목록은 선택한 통합 리전을 기반으로 채워집니다.
- 트리거: 드롭다운 목록에서 통합과 연결된 API 트리거를 선택합니다.
- 엔드포인트 유형: 동기화를 선택합니다.
다음을 클릭합니다.
일반 정책 구성 페이지에서 기본 선택 항목을 그대로 두고 다음을 클릭합니다.
요약 페이지에서 만들기를 클릭합니다.
통합 대상 프록시가 성공적으로 생성되었습니다.

프록시 배포

새로 만든 프록시를 배포하려면 다음 단계를 수행합니다.

Apigee UI에서 개발 > API 프록시를 선택합니다.
UI에 API 프록시와 배포 상태의 목록이 표시됩니다.
환경 드롭다운 목록에서 API 프록시를 배포하려는 환경을 선택합니다.
배포하려는 최근에 만든 프록시를 클릭합니다. UI에 기본적으로 개요 페이지가 표시됩니다.
변경사항을 배포하려면 먼저 배포를 클릭하여 배포 대화상자를 표시합니다.
다음을 입력합니다.
- 버전: 배포하려는 프록시의 버전 번호입니다.
- 환경: 프록시를 배포하려는 환경입니다.
- 서비스 계정: 프록시에 대해 생성된 서비스 계정입니다.
배포를 클릭합니다.

UI에서 선택한 수정 버전의 배포 프로세스가 시작됩니다. 프록시 배포가 완료되는 데 최대 1분이 걸릴 수 있습니다.

프록시가 배포되면 배포 섹션의 상태 열에 프록시의 버전 1이 배포됨을 보여주는 녹색 아이콘이 표시됩니다.

참고: 프록시의 통합 요청 설정 정책 정의에는 명시적 Authentication 요소가 없습니다. Apigee는 요청에 인증 토큰을 자동으로 추가합니다.

통합 요청 설정 정책을 성공적으로 인증하려면 통합을 실행하는 데 필요한 IAM 역할이 있는 서비스 계정으로 통합 대상을 배포해야 합니다. API 프록시 배포에 대한 자세한 내용은 Apigee에 배포를 참조하세요.

통합 대상 프록시 테스트

터미널 창에서 다음 명령어를 실행하여 프록시를 호출하고 통합을 트리거합니다.

curl -v https://YOUR_ENV_GROUP_HOSTNAME/PROXY_NAME

여기서 YOUR_ENV_GROUP_HOSTNAME은 프록시가 배포된 환경이 포함된 환경 그룹의 호스트 이름입니다.

예를 들면 다음과 같습니다.

curl -v https://my-org-prod.hybrid.e2e.apigeeks.net/my-proxy

통합이 프록시 호출로 트리거되었는지 확인하려면 다음 안내를 따르세요.

Apigee UI를 엽니다.
개발 > 통합을 클릭합니다.
위 단계에서 만든 통합 이름을 검색하거나 선택하고 통합 이름을 클릭합니다.
로그를 클릭합니다.
트리거된 통합에 대해 실행 로그가 존재하는지 확인합니다. 로그 세부정보를 보려면 행을 클릭하여 실행 세부정보를 확장합니다.

프록시 요청 페이로드 업데이트(선택사항)

프록시 요청 페이로드를 업데이트하려면 다음 단계를 수행합니다.

Apigee UI의 왼쪽 탐색 메뉴에서 개발 > API 프록시를 선택합니다.
최근에 만든 프록시를 클릭합니다.
기본적으로 UI에는 프록시 편집기에 해당 프록시의 개요 탭이 표시됩니다.
개발 탭을 클릭합니다.
탐색기 창의 정책 제목 아래에서 통합 요청 설정을 선택합니다.
<Parameters> 블록의 주석 처리를 삭제하고 매개변수 세부정보를 입력합니다.
개별 매개변수를 지정하려면 <Parameter> 요소를 사용합니다. 매개변수 배열을 지정하려면 <ParameterArray> 요소를 사용합니다.

참고: 이 튜토리얼에서는 편의상 Parameters 블록만 주석 처리합니다. Application Integration은 통합 요청 설정 정책의 일부로 전달될 수 있는 여러 매개변수를 지원합니다. 자세한 내용과 예시는 SetIntegrationRequest 정책을 참조하세요.
저장을 클릭합니다.

다음 단계

통합 디자이너 레이아웃을 살펴보고 모든 개념에 설명된 다양한 통합 개념 이해하기