Skip to main content

Workspace ONE: General

Before proceeding, please make sure that your Workspace ONE Tenant is compatible with your Exodus Instance as per our Support Matrix.

Required environment's information​

In order for Exodus to access your UEM Tenant, you'll need the following information:

  • Host: This is the hostname of the HTTPS server Exodus will use to access the Device Services and REST API services. Generally, they should be accessible through the same URL as your Workspace ONE portal. To confirm this, please go to All Settings › System › Advanced › Site URLs and copy the appropriate value.
example

If your console's URL is https://acme.awmdm.com/, you may copy that URL, or simply use acme.awmdm.com.

info

If required, you can specify a port at the end of the host url. Examples: https://acme.awmdm.com:8443/ or acme.awmdm.com:8443 If present and different from 443, the port number will be preserved.

  • API Key: This is the API Key Exodus will use to contact your API endpoint.

  • Admin’s Username and Password or Certificate and Certificate Passphrase: to create a migration, you need an admin user with full REST API rights.

  • Organization Group: This is the Group ID of your targeted Organization Group. It can be found by either hovering your mouse on the organizational group name in Workspace ONE portal's top header or by going to Groups & Settings › Groups › Organization Groups › Details.

  • Smart Group: This is the name or ID of your targeted Smart Group. It can be found by going to Groups & Settings › Groups › Assignment Groups. You must use the available Smart Groups in the targeted Organization Group to ensure all devices are listed, and ADE configuration is detected. Leveraging Smart Group is optional.

tip

We highly recommend to create a dedicated admin user, role and API Key.

  • To create an API Key, please go to Devices › Devices Settings › System › Advanced › API › REST API, then click the button Add.
  • To create an admin user, please go to Accounts › Administrators › List View, then click the button Add › Add Admin.
  • To create a role, please go to Accounts › Administrators › Roles, then click the button Add Role.

Next steps​

Next, depending on whether you are using Workspace ONE as your Source Tenant or as your Target Tenant, consult the appropriate guide: