Connect Azure Services to Atlas with Azure Service Connector
Azure Service Connector enables you to connect Azure compute services to your Atlas clusters. Once you've configured your application to use the Atlas connection string, Azure Service Connector securely stores your connection string and manages the connection between your application and Atlas.
This tutorial demonstrates how to connect an Azure compute service (such as Azure App Service) to your Atlas cluster using the Azure Service Connector within the Azure Portal.
Limitations
Azure Service Connector for Atlas has the following limitations:
Azure Service Connector for Atlas doesn't validate the connection string beyond checking for empty strings. Ensure your connection string is valid to avoid runtime connection errors.
Azure Service Connector doesn't support all Azure regions. To learn more, see Service Connector region support.
Prerequisites
An Azure account with an active subscription.
An Azure compute service to connect to Atlas. To learn what Azure services the Azure Service Connector supports, see the Azure documentation.
An existing Atlas cluster.
A database user with the necessary permissions to access your Atlas cluster.
Important
Azure Service Connector for Atlas currently only supports SCRAM authentication. To learn more, see Add Database Users.
Your Atlas cluster's connection string.
Procedure
Follow these steps to connect your Azure compute service (such as App Service) to Atlas using the Azure portal.
Configure the connection.
Configure the following fields:
Service type: Search for and select MongoDB Atlas Cluster (preview).
Connection name: Assign a descriptive name for this connection, for example, "atlas_connection", or accept the auto-generated name. This name is for Azure management purposes.
Click Next: Authentication
Configure authentication.
The Connection string option is pre-selected as it's the only supported method for Atlas.
Enter your Atlas connection string. To find your connection string, see Connect to Your Cluster.
(Optional) Edit the variable name that Azure Service Connector uses for your connection string. Click Advanced and click the pencil icon. Edit the variable name, then click Done.
Click Next: Networking.
Skip this step since you manage network access controls from your Atlas project settings, not through Service Connector's network configuration options.
To learn about managing network access controls in Atlas, see Configure Security Features for Clusters.
Click Next: Review + Create.
Review the summary of the connection details. Verify the target service (Atlas), compute service, authentication method, and the environment variables that are created.
Click Create.
It might take a minute or two for Azure to provision the connection. Service Connector configures the necessary settings on your Azure compute service (primarily environment variables).
After you create or modify an Azure Service Connector connection, the corresponding environment variables might not be immediately updated or reflected in your application's environment.
Confirm the connection was created successfully by returning to the Service Connector page for your compute service. The new Atlas connection should be listed.
Using the Connection in Your Application
After you create the connection, Service Connector uses the connection details in your Azure compute service's environment. Your application code accesses these environment variables to connect to Atlas using a standard MongoDB driver or library appropriate for your chosen language or framework.
Learn More
Connect apps to MongoDB Atlas (Preview) in the Azure documentation.