Connect to an Edge Server

Configure the Server Connection

In the Swift template app's atlasConfig, set the values to:

Adjust the App Transport Security Settings (Optional)

If your app uses TLS, you can disregard this step. If you are developing an Edge Server app with TLS not enabled during development, you must complete this step.

For iOS, Apple disables insecure connections by default. You must add an exception for your public-accessible DNS to allow the client app to connect to it.

Select your App target, and go to the Signing & Capabilities tab. Press the + Capability button, and search for App Transport Security Settings. Add this to your app.

Add an exception domain for your public-accessible DNS. This should be just the string domain, similar to: ec2-13-58-70-88.us-east-2.compute.amazonaws.com.

This creates an Info.plist file in your project. Go to this file to make the following adjustments.

Change this String key to a Dictionary. Add two more keys for:

This enables your iOS client to connect to the insecure HTTP DNS.

Your Info.plist file should look similar to:

Adjust the Log Level (Optional)

You can adjust the log level if you'd like to get additional details about the status of communication with the Edge Server.

In the App file, you can add an .onAppear block to set the log level. Add a log level line in this block to get additional information:

var body: some Scene {
   WindowGroup {
      ContentView(app: app)
         .environmentObject(errorHandler)
         .alert(Text("Error"), isPresented: .constant(errorHandler.error != nil)) {
            Button("OK", role: .cancel) { errorHandler.error = nil }
         } message: {
            Text(errorHandler.error?.localizedDescription ?? "")
         }
         .onAppear {
            Logger.shared.level = .trace
         }
   }
}

For more information about setting the log level, refer to Logging - Swift SDK.

Run the App

Now you can build and run the app. When you log in, the app connects to the Edge Server instance. When you create new Items, those sync with the instance. The instance then syncs with the Atlas App Services App.

You can check the status of the Edge Server instance from your host. With the client running, you can see "num_local_clients": 1 in the instance status. You can also see error messages reflected in the sync status.

After the next time the Edge Server instance syncs with your App Services App, you can see synced changes reflected in the linked Atlas collection.

Configure Edge Server with the Relevant Flag

To enable anonymous connections, start the Edge Server with the --insecure-disable-auth flag set to true. This allows you to connect without specifying a username and password.

This setting is false by default. Setting this to true enables connections to bypass authentication.

For more information about using edgectl to configure and start the Edge Server instance, refer to Install and Configure the Edge Server Instance.

Omit Authentication Details from MongoDB URI

When connecting without authentication, the MongoDB URI omits the authentication-related parameters. This simplfied URI is:

mongodb://<hostname>:<port>

mongodb://ec2-13-58-70-88.us-east-2.compute.amazonaws.com:27021

mongodb://localhost:27021