A Managed Service Account (MSA) is a managed domain account commonly used to increase the security of Windows service accounts.Windows services can be configured to run as these accounts without needing to enter or change the password. Active Directory manages and changes the password on a regular basis (every 30 days by default), eliminating the need for an administrator to manage it. The MSA is is treated as a domain account and can be granted rights to files, folders, and domain resources, but it cannot be used for an interactive login by a human user.There are two types of MSAs: standalone MSAs and group MSAs. A standalone MSA is restricted to use on only one machine, while a group MSA can be used on a group of machines. This document outlines how to configure ArcGIS Enterprise to use a group MSA to run the ArcGIS Server, Portal for ArcGIS, and ArcGIS Data Store services on WindowsGroup MSAs are only available in Windows Server 2012 and higher. This assumes the MSA is already created and the server machines hosting ArcGIS Enterprise have been granted rights to use the MSA.
Instructions for creating the MSA can be found in the Microsoft documentation: Getting Started with Group Managed Service Accounts.
Note: The workflow outlined below is only for ArcGIS Enterprise 10.7.1 and prior. For changing the account running ArcGIS Enterprise in versions 10.8 and later, refer to the following documentation for each of the respective products:
Note: The sample group MSA used in these steps is domain\ArcGIS_MSA.
Test-ADServiceAccount -Identity ArcGIS_MSA
If this returns True, the group MSA is ready. If this returns False, the server hostname may still need to be added to the MSA group or the server must be restarted for changes in Active Directory to take effect. If unable to run this command from PowerShell, the Active Directory admin tools for PowerShell can be installed with the following command:
Add-WindowsFeature -Name RSAT-AD-PowerShell
Update folder permissions in ArcGIS Server for "domain\ArcGIS_MSA$":
Grant read only on folder C:\Program Files\arcgis\server\
Grant full control on folder C:\Program Files\arcgis\server\framework\
Grant full control on folder C:\Program Files\arcgis\server\usr\
Grant full control on folder C:\Program Files\arcgis\server\bin\
Grant full control on folder C:\Program Files\arcgis\server\XMLSchema\
Grant full control on folder C:\Program Files\arcgis\server\DatabaseSupport\
Grant full control on folder C:\arcgisserver\ (or where the config-store and directories are located)
Update folder permissions in Portal for ArcGIS for “domain\ArcGIS_MSA$”:
Grant read only on folder C:\Program Files\arcgis\portal\
Grant full control on folder C:\Program Files\arcgis\portal\apps\
Grant full control on folder C:\Program Files\arcgis\portal\customizations\
Grant full control on folder C:\Program Files\arcgis\portal\etc\
Grant full control on folder C:\Program Files\arcgis\portal\framework\
Grant full control on folder C:\Program Files\arcgis\portal\tools\
Grant full control on folder C:\Program Files\arcgis\portal\usr\
Grant full control on folder C:\arcgisportal\ (or where the content, index, db, and temp directories are located)
Update folder permissions in ArcGIS Data Store for “domain\ArcGIS_MSA$”:
Grant full control on folder C:\Program Files\arcgis\datastore\
Grant full control on folder C:\arcgisdatastore\ (or location of ArcGIS Data Store content directory)
Double-click the service to open the service properties, click the Log On tab, and enter the group MSA account without specifying any password. The account must have a “$” at the end to indicate it is a service account. Click OK, and restart each service for the changes to take effect.
Notes on upgrading ArcGIS Enterprise when using Managed Service Accounts: The setup or upgrade utility for ArcGIS Enterprise 10.7.1 and earlier does not support specifying an MSA as a “Log On As” account for the ArcGIS Enterprise Windows services. Before upgrading in the future, the “Log On As” account must be manually changed back to a local or domain account for each Windows service in ArcGIS Enterprise. Once the upgrade has completed, steps 3 and 4 should be repeated to confirm the permissions are still accurate, then switch back to using the MSA.
Get help from ArcGIS experts
Download the Esri Support App