7단계: 동기화 담당자 액세스 사용 설정

승인 토큰 가져오기

이 주제의 뒷 부분에 설명된 Apigee API 호출을 수행하려면 Apigee 조직 관리자 역할이 있는 승인 토큰을 가져와야 합니다.

Apigee Hybrid 조직과 연관된 Google Cloud 프로젝트의 소유자가 아닌 경우 Google Cloud 사용자 계정에 roles/apigee.admin(Apigee 조직 관리자) 역할이 있는지 확인합니다. 다음 명령어로 할당된 역할을 확인할 수 있습니다.
```
gcloud projects get-iam-policy ${PROJECT_ID}  \
  --flatten="bindings[].members" \
  --format='table(bindings.role)' \
  --filter="bindings.members:your_account_email"
```
예를 들면 다음과 같습니다.
```
gcloud projects get-iam-policy my-project  \
  --flatten="bindings[].members" \
  --format='table(bindings.role)' \
  --filter="bindings.members:myusername@example.com"
```
출력에는 roles/apigee.admin이 포함되어야 합니다.

roles/apigee.admin이 없으면 사용자 계정에 Apigee 조직 관리자 역할을 추가합니다. 다음 명령어를 사용하여 역할을 사용자 계정에 추가합니다.

gcloud projects add-iam-policy-binding ${PROJECT_ID} \
  --member user:your_account_email \
  --role roles/apigee.admin

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

gcloud projects add-iam-policy-binding my-project \
  --member user:myusername@example.com \
  --role roles/apigee.admin

명령줄에서 다음 명령어를 사용하여 gcloud 인증 사용자 인증 정보를 가져옵니다.
Linux/MacOS
```
export TOKEN=$(gcloud auth print-access-token)
```
토큰이 입력되었는지 확인하려면 다음 예시와 같이 echo를 사용합니다.
```
echo $TOKEN
```
그러면 토큰이 인코딩된 문자열로 표시됩니다.
Windows
```
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
```
토큰이 입력되었는지 확인하려면 다음 예시와 같이 echo를 사용합니다.
```
echo %TOKEN%
```
그러면 토큰이 인코딩된 문자열로 표시됩니다.

동기화 담당자 액세스 사용 설정

동기화 담당자 액세스를 사용 설정하려면 다음 안내를 따르세요.

동기화 담당자 액세스 권한을 부여할 서비스 계정에 대해 이메일 주소를 가져옵니다. 비프로덕션 환경(이 튜토리얼의 설명 참조)의 경우 apigee-non-prod여야 합니다. 프로덕션 환경에서는 apigee-synchronizer여야 합니다. 다음 명령어를 사용하세요.
```
gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee-synchronizer"
```

다음 명령어를 사용하여 setSyncAuthorization API를 호출하여 동기화 담당자에 필요한 권한을 사용 설정합니다.

curl -X POST -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/${ORG_NAME}:setSyncAuthorization" \
   -d '{"identities":["'"serviceAccount:apigee-synchronizer@${ORG_NAME}.iam.gserviceaccount.com"'"]}'

각 항목의 의미는 다음과 같습니다.

${ORG_NAME}: 하이브리드 조직의 이름입니다.
apigee-synchronizer${ORG_NAME}.iam.gserviceaccount.com: 서비스 계정의 이메일 주소입니다.

팁: 일부 셸은 bad substitution과 같은 오류를 반환할 수 있습니다. 이 경우 ${ORG_NAME}을 조직 이름으로 바꾸고 "'"를 다음과 같이 "로 바꿉니다.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/YOUR_ORG_NAME:setSyncAuthorization" \
   -d '{"identities":["serviceAccount:apigee-synchronizer@YOUR_ORG_NAME.iam.gserviceaccount.com"]}'

서비스 계정이 설정되었는지 확인하려면 다음 명령어로 API를 호출하여 서비스 계정 목록을 가져옵니다.
```
curl -X GET -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/${ORG_NAME}:getSyncAuthorization"
    
```
결과는 다음과 유사합니다.
```
{
   "identities":[
      "serviceAccount:apigee-synchronizer@my_project_id.iam.gserviceaccount.com"
   ],
   "etag":"BwWJgyS8I4w="
}
```
참고: Apigee API에 대한 호출은 ${ORG_NAME}을 사용하고 IAM 서비스 계정 매핑의 결과는 my_project_id를 사용합니다. 대부분의 경우 값은 동일합니다. 드문 경우의 예외로는 다중 조직 클러스터를 사용하는 데 하나 이상의 조직 이름이 있으며 서비스 계정이 조직 마다 다른 경우입니다.

이제 Apigee Hybrid 런타임 및 관리 영역을 사용해서 통신할 수 있습니다. 그런 다음 Apigee Hybrid가 인증서를 해석하고 관리할 수 있도록 cert-manager를 설치합니다.

1 2 3 4 5 6 7 (다음) 8단계: cert-manager 설치 9 10 11 12

7단계: 동기화 담당자 액세스 사용 설정

승인 토큰 가져오기

Linux/MacOS

Windows

동기화 담당자 액세스 사용 설정