O plano de gerenciamento da Apigee híbrida normalmente se comunica com o
serviço MART
no plano do ambiente de execução pelo Apigee Connect.
Essa é a configuração recomendada. No entanto, se você quiser usar o serviço de gateway de entrada
do Istio do MART em vez do Apigee Connect, convém expor o endpoint
do MART às solicitações provenientes do cluster de fora.
O endpoint MART é uma conexão TLS segura. O híbrido usa um
serviço
de gateway de entrada do Istio para expor o tráfego a esse endpoint.
Este tópico explica as etapas a serem seguidas para expor o endpoint MART.
Como adicionar a conta de serviço MART
O MART requer uma conta de serviço do Google Cloud para autenticação.
Na etapa de configuração do Google Cloud Adicionar contas de serviço, você
criou uma conta de serviço sem papel para o MART.
Localize o arquivo de chave que você salvou para essa conta de serviço.
O arquivo precisa ter uma extensão .json.
Adicione o caminho do arquivo de chave à propriedade mart.serviceAccountPath:
...
mart:
sslCertPath:
sslKeyPath:
hostAlias:
serviceAccountPath: "path to a file"
...
Adicione as
propriedades
mart.sslCertPath, mart.sslKeyPath, e mart.hostAlias. A tabela a seguir descreve essas propriedades:
Propriedade
Valor
mart.sslCertPath mart.sslKeyPath
O par de certificados/chaves MART precisa ser autorizado por uma autoridade de certificação (CA).
Se você ainda não criou um par de certificado/chave autorizado, faça isso
agora e insira os nomes de arquivo de chave e certificado dos valores de propriedade
correspondentes. Se você precisar de ajuda para gerar o par de certificado/chave autorizado, consulte
Receber credenciais TLS: um exemplo.
mart.hostAlias.
(Obrigatório) Um nome DNS qualificado para o endpoint do servidor MART. Por exemplo,
foo-mart.mydomain.com.
Por exemplo, em que o alias de host é um nome de domínio qualificado:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-03 UTC."],[[["\u003cp\u003eThis documentation pertains to Apigee hybrid version 1.5, which is now end-of-life and requires an upgrade to a newer version.\u003c/p\u003e\n"],["\u003cp\u003eExposing the MART endpoint via the Istio ingress gateway, instead of Apigee Connect, requires the setup of a secure TLS connection.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring MART involves adding a Google Cloud service account key file path to the \u003ccode\u003emart.serviceAccountPath\u003c/code\u003e property in your overrides file.\u003c/p\u003e\n"],["\u003cp\u003eTo expose the MART endpoint, you must provide a CA-authorized TLS certificate/key pair via the \u003ccode\u003emart.sslCertPath\u003c/code\u003e and \u003ccode\u003emart.sslKeyPath\u003c/code\u003e properties, respectively, along with a qualified DNS name for \u003ccode\u003emart.hostAlias\u003c/code\u003e in the overrides file.\u003c/p\u003e\n"],["\u003cp\u003eThe Common Name (CN) in the provided TLS certificate must match the value specified in the \u003ccode\u003emart.hostAlias\u003c/code\u003e property for successful configuration.\u003c/p\u003e\n"]]],[],null,["# MART configuration\n\n| 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](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nThe Apigee Hybrid management plane ordinarily communicates with the\n[MART service](/apigee/docs/hybrid/v1.5/what-is-hybrid#management-api-mart)\nin the runtime plane via [Apigee Connect](/apigee/docs/hybrid/v1.5/apigee-connect).\nThis is the recommended configuration. However, if you want to use the MART Istio\ningress gateway service instead of Apigee Connect, you will want to expose the MART\nendpoint to requests coming from outside of the cluster.\nThe MART endpoint is a secure TLS connection. Hybrid uses an\n[Istio\ningress gateway service](https://istio.io/docs/tasks/traffic-management/ingress/) to expose traffic to this endpoint.\n| 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\n| TLS credentials](/apigee/docs/hybrid/v1.5/lets-encrypt).\n\n\nThis topic explains the steps to take to expose the MART endpoint.\n\nAdding the MART service account\n-------------------------------\n\n\nMART requires a Google Cloud service account for authentication.\n\n1. In the Google Cloud setup step, [Add service accounts](/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.\n2. Add the key file path to the `mart.serviceAccountPath` property: \n\n ```\n ...\n mart:\n sslCertPath:\n sslKeyPath:\n hostAlias:\n serviceAccountPath: \"path to a file\"\n ...\n ```\n\n\n For example: \n\n ```\n ...\n mart:\n sslCertPath:\n sslKeyPath:\n hostAlias:\n serviceAccountPath: \"your_keypath/mart-service-account.json\n ...\n ```\n\nAdding TLS credentials and the host alias\n-----------------------------------------\n\n1. Open your overrides file.\n2. Add the `mart.sslCertPath`, `mart.sslKeyPath`, and `mart.hostAlias` properties. The following table describes these properties:\n\n\n For example, where the host alias is a qualified domain name: \n\n ```\n ...\n\n mart:\n sslCertPath: \u003cvar translate=\"no\"\u003epath-to-file\u003c/var\u003e/mart-server.crt\n sslKeyPath: \u003cvar translate=\"no\"\u003epath-to-file\u003c/var\u003e/mart-server.key\n hostAlias: foo-mart.mydomain.com\n serviceAccountPath: \"your_keypath/mart-service-account.json\n\n ...\n ```\n3. Save your changes."]]
