Deploy extension to your organization

You can deploy the Atlan browser extension across your entire organization using your existing mobile device management (MDM) software. This installs and configures the extension automatically for all users—no manual setup required on each device.

This guide covers macOS and Windows devices, and supports both Google Chrome and Microsoft Edge.

Prerequisites

Before you begin, make sure you have:

• The Admin role in Atlan to configure the extension and download the deployment script.
• Administrator access to your organization's MDM software (for example, Microsoft Intune) to deploy policies to all users.

Configure extension in Atlan

In your Atlan workspace, generate the configuration script to deploy to your users' devices.

1. From the left menu, click Admin.

2. Under Workspace, click Integrations.

3. Under Apps, expand the Browser extension tile and click Set up now.

4. In the Set up browser extension form, select your browser and operating system. The values are prefilled based on your current setup, update them if needed.

5. For Your Atlan domain, enter the URL of your Atlan instance, for example:

   https://mycompany.atlan.com

6. (Optional) Under Advanced settings, configure the following as needed:

   • Multiple Atlan domains: if your organization has more than one Atlan instance, toggle this on and add the additional URLs. Users see a dropdown to select the relevant instance.
   • Custom data source domains: if your data tools are hosted on custom domains rather than their standard SaaS URLs, toggle this on and add each tool and its domain. Users can't update or remove these, but can add additional custom domains.

7. Click Download Script to download the configuration file. Based on your operating system, this is either a .mobileconfig file (macOS) or a .ps1 PowerShell script (Windows).

Force-install extension

Configure the ExtensionInstallForcelist browser policy in your MDM software to silently install the extension for all users when they log in.

Google Chrome

Follow the steps in the Google documentation: Force install apps and extensions.

Microsoft Edge

Follow the steps in the Microsoft documentation: Force-install an extension.

For the Extension/App IDs and update URLs to be silently installed field, use the following value:

fipjfjlalpnbejlmmpfnmlkadjgaaheg;https://clients2.google.com/service/update2/crx

• fipjfjlalpnbejlmmpfnmlkadjgaaheg is the extension ID for the Atlan browser extension.
• https://clients2.google.com/service/update2/crx specifies that it's installed from the Chrome Web Store.

Deploy configuration script

Deploy the script downloaded in the previous step using your MDM software to configure the extension domains for all users.

macOS

In your MDM console, create a new custom configuration profile and upload the .mobileconfig file downloaded from Atlan.

For example, in Microsoft Intune:

1. In the Intune admin center, go to Devices → macOS → Configuration profiles.

2. Click Create → New policy and select Templates → Custom as the profile type.

3. Upload the .mobileconfig file and give the profile a name.

4. Under Assignments, select the device groups to deploy to and click Save.

For other MDM platforms, see Custom configuration profile settings.

Windows

In your MDM console, create a new PowerShell script policy and upload the .ps1 file downloaded from Atlan.

For example, in Microsoft Intune:

1. In the Intune admin center, go to Devices → Windows → Scripts and remediations.

2. Click Add and upload the .ps1 configuration script downloaded from Atlan.

3. Under Script settings, configure the following:

   • Run this script using the logged on credentials: set to No.
   • Enforce script signature check: set to No.
   • Run script in 64-bit PowerShell Host: set to Yes.

4. Under Assignments, select the device groups to deploy to and click Save.

For other MDM platforms, see Create a script policy and assign it.

Verify installation

After deploying the policies, confirm the extension is working correctly before rolling out broadly.

1. On a target device, check that the Atlan browser extension is installed and the configured domains are applied.

2. In your MDM platform, monitor the compliance status of the policy and resolve any issues flagged.

Once the managed browser syncs with the latest configuration, the extension is automatically installed and a new tab opens to confirm it's active.

Configure custom domains for your organization

Who can do this?

You need the Admin role in Atlan to configure custom domains for your organization.

If your data tools are hosted on custom domains rather than their standard SaaS URLs, you can set these org-wide so all users see them preloaded in their extension.

1. From the left menu in Atlan, click Admin.

2. Under Workspace, click Integrations.

3. Under Apps, expand the Browser extension tile.

4. Under Set up your custom data source, click Configure.

5. For Connector, select a supported tool, then enter the custom domain URL for that tool.

6. Click + Add to add more tools as needed, then click Save.

Users in your workspace see these domains preloaded in their extension. They can add custom domains for additional tools, but can't update or remove the ones you've configured.

Need help?

If you have any issues while deploying the extension, contact Atlan Support for assistance.

See also

• Install and set up browser extension
• Use Atlan browser extension
• Atlan browser extension security