Langkah 7: Aktifkan akses Synchronizer

Mendapatkan token otorisasi

Untuk melakukan panggilan API Apigee yang akan dijelaskan nanti dalam topik ini, Anda perlu mendapatkan token otorisasi yang memiliki peran Apigee Organization Admin.

Jika Anda bukan pemilik project Google Cloud yang terkait dengan organisasi hybrid Apigee, pastikan akun pengguna Google Cloud Anda memiliki peran roles/apigee.admin (Admin Organisasi Apigee). Anda dapat memeriksa peran yang ditetapkan kepada Anda dengan perintah ini:

gcloud projects get-iam-policy ${PROJECT_ID}  \
  --flatten="bindings[].members" \
  --format='table(bindings.role)' \
  --filter="bindings.members:your_account_email"

Contoh:

gcloud projects get-iam-policy my-project  \
  --flatten="bindings[].members" \
  --format='table(bindings.role)' \
  --filter="bindings.members:myusername@example.com"

Output harus menyertakan roles/apigee.admin.

Jika Anda tidak memiliki roles/apigee.admin, tambahkan peran Apigee Organization Admin ke akun pengguna Anda. Gunakan perintah berikut untuk menambahkan peran ke akun pengguna Anda:

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

Contoh:

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

Pada command line, dapatkan kredensial autentikasi gcloud menggunakan perintah berikut:
Linux / MacOS
```
export TOKEN=$(gcloud auth print-access-token)
```
Untuk memeriksa apakah token Anda sudah diisi, gunakan echo, seperti yang ditunjukkan contoh berikut:
```
echo $TOKEN
```
Ini akan menampilkan token Anda sebagai string yang dienkode.
Windows
```
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
```
Untuk memeriksa apakah token Anda sudah diisi, gunakan echo, seperti yang ditunjukkan contoh berikut:
```
echo %TOKEN%
```
Ini akan menampilkan token Anda sebagai string yang dienkode.

Aktifkan akses sinkronisasi

Untuk mengaktifkan akses sinkronisasi:

Dapatkan alamat email untuk akun layanan yang Anda berikan akses sinkronisasi. Untuk lingkungan produksi, ID harus berupa apigee-synchronizer. Gunakan perintah berikut:
```
gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee-synchronizer"
```
Jika cocok dengan pola apigee-synchronizer@${ORG_NAME}.iam.gserviceaccount.com, Anda dapat menggunakan pola tersebut di langkah berikutnya.

Panggil setSyncAuthorization API untuk mengaktifkan izin yang diperlukan bagi Synchronizer menggunakan perintah berikut:

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"'"]}'

Dengan keterangan:

${ORG_NAME}: Nama organisasi hybrid Anda.
apigee-synchronizer${ORG_NAME}.iam.gserviceaccount.com: Alamat email akun layanan.

Tips: Beberapa shell mungkin menampilkan error seperti bad substitution. Dalam hal ini, ganti $ORG_NAME dengan nama organisasi Anda dan ganti "'" dengan " seperti berikut:

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"]}'

Untuk memverifikasi bahwa akun layanan sudah ditetapkan, gunakan perintah berikut untuk memanggil API guna mendapatkan daftar akun layanan:
```
curl -X GET -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/${ORG_NAME}:getSyncAuthorization"
    
```
Outputnya terlihat mirip dengan yang berikut ini:
```
{
   "identities":[
      "serviceAccount:apigee-synchronizer@my_project_id.iam.gserviceaccount.com"
   ],
   "etag":"BwWJgyS8I4w="
}
```
Catatan: Panggilan ke Apigee API menggunakan ${ORG_NAME}, dan hasil dari pemetaan akun layanan IAM menggunakan my_project_id. Pada umumnya, nilainya sama. Satu pengecualian yang tidak umum adalah saat menggunakan cluster multi-org, di mana akan ada lebih dari satu nama org, dan akun layanannya bisa berbeda per organisasi.

Sekarang Anda telah mengaktifkan paket pengelolaan dan runtime Apigee Hybrid untuk berkomunikasi. Selanjutnya, instal pengelola sertifikat untuk mengaktifkan Apigee Hybrid agar dapat menafsirkan dan mengelola sertifikat.

Langkah berikutnya

1 2 3 4 5 6