> [!CAUTION]
> You are currently viewing version 1.4 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.4 (unsupported)</button>

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

The Apigee Hybrid management plane must be able to reach the
[MART service](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/what-is-hybrid.md.txt#management-api-mart)
in the runtime plane. For this reason, you must expose the MART
endpoint to requests coming from outside of the cluster.
The MART endpoint is a secure TLS connection. Hybrid uses an
[Istio
ingress gateway service](https://istio.io/docs/tasks/traffic-management/ingress/) to expose traffic to this endpoint.

> [!NOTE]
> The MART setup requires you to provide a trusted TLS key/certificate pair and a qualified domain name. Self-signed certificates are not permitted. For an example showing how to obtain a certificate signed by a CA, see [Obtain
> TLS credentials](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/lets-encrypt).


This topic explains the steps to take to expose the MART endpoint.

## Adding the MART service account


MART requires a GCP service account for authentication.

1. In the GCP setup step, [Add service accounts](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/precog-serviceaccounts), you created a service account with no role for MART. Locate the key file you downloaded for that service account. The file should have a `.json` extension.
2. Add the key file path to the `mart.serviceAccountPath` property:

   ```
   ...
   mart:
     sslCertPath:
     sslKeyPath:
     hostAlias:
     serviceAccountPath: "path to a file"
   ...
   ```


   For example:

   ```
   ...
   mart:
     sslCertPath:
     sslKeyPath:
     hostAlias:
     serviceAccountPath: "your_keypath/mart-service-account.json
   ...
   ```

## Adding TLS credentials and the host alias

1. Open your overrides file.
2. Add the `mart.sslCertPath`, `mart.sslKeyPath`, and `mart.hostAlias` properties. The following table describes these properties:

   | Property | Value |
   |---|---|
   | <var translate="no">mart.sslCertPath</var> <var translate="no">mart.sslKeyPath</var> | The MART certificate/key pair must be authorized by a certificate authority (CA). If you have not previously created an authorized cert/key pair, then you must do so now and enter the certificate and key filenames for the corresponding property values. If you need help generating the authorized cert/key pair, see [Obtain TLS credentials: An example](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/lets-encrypt.md.txt). > [!NOTE] > **NOTE:** The Common Name (CN) in the cert must agree with the value specified in the `mart.hostAlias` property. If the CN is `*.hybrid-domain.net` and you've registered the host `mart.hybrid-domain.net`, then you would set `mart.hostAlias` to the value `mart.hybrid-domain.net`. |
   | `mart.hostAlias`. | (Required) A qualified DNS name for the MART server endpoint. For example, `foo-mart.mydomain.com`. |


   For example, where the host alias is a qualified domain name:

   ```
   ...

   mart:
     sslCertPath: path-to-file/mart-server.crt
     sslKeyPath: path-to-file/mart-server.key
     hostAlias: foo-mart.mydomain.com
     serviceAccountPath: "your_keypath/mart-service-account.json

   ...
   ```
3. Save your changes.