> [!CAUTION]
> You are currently viewing version 1.11 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions).

<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">Version 1.11 </button>

- Supported versions:
- [v1.17 (latest)](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/install-enable-synchronizer-access.html)
- [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/install-enable-synchronizer-access.html)
- [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/install-enable-synchronizer-access.html)
- [v1.14](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/install-enable-synchronizer-access.html)
- [List of supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions)
- Unsupported versions:
- [v1.13](https://docs.cloud.google.com/apigee/docs/hybrid/v1.13/install-enable-synchronizer-access.md.txt)
- [v1.12](https://docs.cloud.google.com/apigee/docs/hybrid/v1.12/install-enable-synchronizer-access.md.txt)
- [v1.11](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-enable-synchronizer-access.md.txt)
- [v1.10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.10/install-enable-synchronizer-access.md.txt)
- [v1.9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.9/install-enable-synchronizer-access.md.txt)
- [v1.8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-enable-synchronizer-access.md.txt)
- [v1.7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.7/install-enable-synchronizer-access.md.txt)
- [v1.6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.6/install-enable-synchronizer-access.md.txt)
- [v1.5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/install-enable-synchronizer-access.md.txt)
- [v1.4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/install-enable-synchronizer-access.html)
- [v1.3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-enable-synchronizer-access.html)
- [v1.2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/install-enable-synchronizer-access.html)
- [v1.1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-enable-synchronizer-access.html)

## Get an authorization token


To make the Apigee API calls described later in this topic, you need to get an authorization
token that has the Apigee Organization Admin role.

1. If you are not the owner of the Google Cloud project that is associated with your Apigee hybrid organization, be sure that your Google Cloud user account has the **roles/apigee.admin** (Apigee Organization Admin) role. You can check the roles assigned to you with this command:

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


   For example:

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


   The output should look something like:

   ```
   ROLE
   roles/apigee.admin
   roles/compute.admin
   roles/container.admin
   roles/gkehub.admin
   roles/iam.serviceAccountAdmin
   roles/iam.serviceAccountKeyAdmin
   roles/meshconfig.admin
   roles/owner
   roles/resourcemanager.projectIamAdmin
   roles/servicemanagement.admin
   roles/serviceusage.serviceUsageAdmin
   ```
2. If you do not have `roles/apigee.admin` in your roles, add the **Apigee
   Organization Admin** role to your user account. Use the following command to add the role to your user account:

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


   For example:

   ```
   gcloud projects add-iam-policy-binding my-project \
     --member user:myusername@example.com \
     --role roles/apigee.admin
   ```
3. On the command line, get your `gcloud` authentication
   credentials using the following command:

   ### Linux / MacOS

   ```
   export TOKEN=$(gcloud auth print-access-token)
   ```

   To check that your token was populated, use `echo`, as the
   following example shows:

   ```
   echo $TOKEN
   ```

   This should display your token as an encoded string.

   ### Windows

   ```
   for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
   ```

   To check that your token was populated, use `echo`, as the
   following example shows:

   ```
   echo %TOKEN%
   ```

   This should display your token as an encoded string.

## Enable synchronizer access


To enable synchronizer access:

1. Get the email address for the service account to which you are granting synchronizer access. For non-production environments (as suggested in this tutorial) it should be `apigee-non-prod`. For production environments, it should be `apigee-synchronizer`. Use the following command:

   ### Non-prod

   ```
   gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee-non-prod"
   ```


   If it matches the pattern `apigee-non-prod@${ORG_NAME}.iam.gserviceaccount.com`, you
   can use that pattern in the next step.

   ### Prod

   ```
   gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee-synchronizer"
   ```


   If it matches the pattern `apigee-synchronizer@${ORG_NAME}.iam.gserviceaccount.com`, you
   can use that pattern in the next step.
2. Call the [setSyncAuthorization](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations/setSyncAuthorization.md.txt) API to enable the required permissions for Synchronizer using the following command:

   ### Non-prod

   ```
   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-non-prod@${ORG_NAME}.iam.gserviceaccount.com\"]}"
   ```

   ### Prod

   ```
   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\"]}"
   ```


   Where:
   - **`${ORG_NAME}`**: The name of your hybrid organization.
   - **`apigee-non-prod${ORG_NAME}.iam.gserviceaccount.com`** or   
     **`apigee-synchronizer${ORG_NAME}.iam.gserviceaccount.com`**: The email address of the service account.
3. To verify that the service account was set, use the following command to call the API to get a list of service accounts:

   ```
   curl -X GET -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type:application/json" \
     "https://apigee.googleapis.com/v1/organizations/${ORG_NAME}:getSyncAuthorization"
       
   ```


   The output looks similar to the following:

   ### Non-prod

   ```
   {
      "identities":[
         "serviceAccount:apigee-non-prod@my_project_id.iam.gserviceaccount.com"
      ],
      "etag":"BwWJgyS8I4w="
   }
   ```

   ### Prod

   ```
   {
      "identities":[
         "serviceAccount:apigee-synchronizer@my_project_id.iam.gserviceaccount.com"
      ],
      "etag":"BwWJgyS8I4w="
   }
   ```

   > [!NOTE]
   > **Note:** The call to the Apigee API uses <var translate="no">${ORG_NAME}</var>, and the results from the IAM service account mappings use <var translate="no">my_project_id</var>. In most cases, the values are the same. One uncommon exception is when using a [multi-org cluster](https://docs.cloud.google.com/apigee/docs/hybrid/latest/multi-org), where there would be more than one org name, and the service accounts could be different per org.

You have now made it possible for your Apigee hybrid runtime and management planes to
communicate. Next, let's apply your configuration to the hybrid runtime and complete your
installation of Apigee hybrid.
[1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-create-cluster.md.txt) [2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-cert-manager.md.txt) [3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-apigeectl.md.txt) [4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-service-accounts.md.txt) [5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-create-tls-certificates.md.txt) [6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-configure-cluster.md.txt) [7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-enable-synchronizer-access.md.txt) [(NEXT) Step 8: Check cluster readiness](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-check-cluster.md.txt) [9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-hybrid-runtime.md.txt) [10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-workload-identity.md.txt)

<br />