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.
Locate the key file for the apigee-mart service account.
The file should have a .json extension. It should reside in the apigee-org directory or a subdirectory.
PROD installations: apigee-mart.json
NON-PROD installations: apigee-non-prod.json
If you do not see the MART service account file, create and download it with the
create-service-account utility:
Make sure your PROJECT_ID environment variable is set:
echo $PROJECT_ID
Define it if needed:
export PROJECT_ID=my-project-id
Create the MART service account. You can find the create-service-account tool in:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThe MART and Apigee Connect services require a Google Cloud service account for authentication, unless using workload identity on AKS, EKS, or GKE.\u003c/p\u003e\n"],["\u003cp\u003eThe MART service account key file, either \u003ccode\u003eapigee-mart.json\u003c/code\u003e for PROD or \u003ccode\u003eapigee-non-prod.json\u003c/code\u003e for NON-PROD, should be located in the \u003ccode\u003eapigee-org\u003c/code\u003e directory or a subdirectory.\u003c/p\u003e\n"],["\u003cp\u003eIf the MART service account file is missing, it can be created and downloaded using the \u003ccode\u003ecreate-service-account\u003c/code\u003e utility, which is found in the \u003ccode\u003eAPIGEE_HELM_CHARTS_HOME/apigee-operator/etc/tools/\u003c/code\u003e directory.\u003c/p\u003e\n"],["\u003cp\u003eThe path to the MART service account key file must be specified in the \u003ccode\u003econnectAgent.serviceAccountPath\u003c/code\u003e and \u003ccode\u003emart.serviceAccountPath\u003c/code\u003e properties within the \u003ccode\u003eoverrides.yaml\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eTo apply the changes, you need to use the command \u003ccode\u003ehelm upgrade ORG_NAME apigee-org/ --namespace apigee --atomic -f OVERRIDES_FILE.yaml\u003c/code\u003e, replacing \u003ccode\u003eupgrade\u003c/code\u003e with \u003ccode\u003einstall\u003c/code\u003e if it's the initial deployment.\u003c/p\u003e\n"]]],[],null,[]]