> [!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/mart-service-account.md.txt)
- [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/mart-service-account.md.txt)
- [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/mart-service-account.md.txt)
- [v1.14](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/mart-service-account.md.txt)
- [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/mart-service-account.md.txt)
- [v1.12](https://docs.cloud.google.com/apigee/docs/hybrid/v1.12/mart-service-account.md.txt)
- [v1.11](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/mart-service-account.md.txt)
- [v1.10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.10/mart-service-account.md.txt)
- [v1.9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.9/mart-service-account.md.txt)
- [v1.8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/mart-service-account.md.txt)
- [v1.7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.7/mart-service-account.html)
- [v1.6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.6/mart-service-account.html)
- [v1.5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/mart-service-account.html)
- [v1.4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/mart-service-account.html)
- [v1.3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/mart-service-account.html)
- [v1.2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/mart-service-account.html)
- [v1.1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/mart-service-account.html)


This topic explains how to configure the MART service account.

## Adding the MART service account


MART and Apigee Connect require a Google Cloud service account for authentication.

> [!NOTE]
> **Note:** Installations on GKE using workload identity do not require a Google Cloud service account key file (`.json`). See [Enabling Workload Identity with Apigee hybrid](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/enable-workload-identity.md.txt).

1. Locate the key file for the `apigee-mart` service account. The file should have a `.json` extension.

   ```
   ls $HYBRID_FILES/service-accounts
   ```
   - **PROD** installations: `apigee-mart.json`
   - **NON-PROD** installations: `apigee-non-prod.json`
2. If you do not see the MART service account file, create and download it with the `create-service-account` utility:
   1. Make sure your `PROJECT_ID` environment variable is set:

      ```
      echo $PROJECT_ID
      ```

      Define it if needed:

      ```
      export PROJECT_ID=my-project-id
      ```
   2. Create the MART service account. You can find the `create-service-account` tool in:
      - For Helm Charts installations:

        ```
        APIGEE_HELM_CHARTS_HOME/
        └── apigee-operator/
            └── etc/
                └── tools/
                    └── create-service-account
        ```
      - For `apigeectl` installations:

        ```
        APIGEECTL_HOME/
        └── tools/
            └── create-service-account
        ```

      ### PROD

      ```
      create-service-account \
        --env prod \
        --profile apigee-mart \
        --dir PATH_TO_SERVICE_ACCOUNTS_DIR
      ```

      ### NON-PROD

      ```
      $HYBRID_FILES/tools/create-service-account \
        --env non-prod \
        --profile apigee-mart \
        --dir PATH_TO_SERVICE_ACCOUNTS_DIR
      ```
3. Edit your `overrides.yaml` file and add the key file path to the `connectAgent` and `mart.serviceAccountPath` properties:

   ### PROD

   ```
   connectAgent:
     serviceAccountPath: path_to_apigee-mart.json

   mart:
     serviceAccountPath: path_to_apigee-mart.json
   ```

   ### NON-PROD

   ```
   connectAgent:
     serviceAccountPath: path_to_apigee-non-prod.json

   mart:
     serviceAccountPath: path_to_apigee-non-prod.json
   ```


   For example:

   ### Helm

   ```
   ...
         connectAgent:
           serviceAccountPath: /apigee/hybrid/helm-charts/apigee-org/apigee-mart.json

         mart:
           serviceAccountPath: /apigee/hybrid/helm-charts/apigee-org/apigee-mart.json
         ...
   ```

   ### `apigeectl`

   ```
   ...
   connectAgent:
     serviceAccountPath: /apigee/hybrid/hybrid-files/service-accounts/apigee-mart.json

   mart:
     serviceAccountPath: /apigee/hybrid/hybrid-files/service-accounts/apigee-mart.json
   ...
   ```
4. Apply your changes:

   ### Helm

   ```
   helm upgrade ORG_NAME apigee-org/ \
     --namespace apigee \
     --atomic \
     -f OVERRIDES_FILE.yaml
   ```

   > [!NOTE]
   > **Note:** If you see an error saying `Error: UPGRADE FAILED: "*ORG_NAME*" has no deployed releases`, replace `upgrade` with `install` and try the command again.

   ### `apigeectl`

   ```
   $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --org
   ```