> [!CAUTION]
> You are currently viewing version 1.8 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.8 (unsupported)</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 requires a Google Cloud service account for authentication.

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

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:

      ### PROD

      ```
      $HYBRID_FILES/tools/create-service-account \
        --env prod \
        --profile apigee-mart \
        --dir $HYBRID_FILES/service-accounts
      ```

      ### NON-PROD

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

   ### PROD

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

   ### NON-PROD

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


   For example:

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

   ```
   $APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
   ```