> [!CAUTION]
> You are currently viewing version 1.5 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.5 (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 ordinarily communicates with the
[MART service](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/what-is-hybrid.md.txt#management-api-mart)
in the runtime plane via [Apigee Connect](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/apigee-connect.md.txt).
This is the recommended configuration. However, if you want to use the MART Istio
ingress gateway service instead of Apigee Connect, you will want to 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]
> This 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.5/lets-encrypt).


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

## Adding the MART service account


MART requires a Google Cloud service account for authentication.

1. In the Google Cloud setup step, [Add service accounts](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/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.5/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.