Use the Service Graph connector for VMware Workspace One UEM to pull mobile and computing devices data from Workspace One into your ServiceNow instance.

1. Navigate to Service Graph Connector VMware Workspace > Setup.
2. On the Getting started page, select Get Started.
3. On the Service Graph Connector for VMware Workspace ONE UEM, in the Configure the connection section, select the task Configure authentication credentials.
4. To configure your authentication credentials, complete the following steps:
   1. On the next page, in the Configure authentication credentials section, select Configure.
   2. On the form, fill in the following fields.

      Table 1. Application Registries form

      Field	Description
      Client ID	Client ID of the VMware Workspace ONE UEM console.
      Client Secret	Client secret of the VMware Workspace ONE UEM console. Note: You can click the lock icon () to view the client secret.
      Token URL	The Token URL of VMware Workspace ONE UEM console so that you can fetch the access token. Note: For more information about the Token URL, see the VMware knowledge base article on the VMware documentation site.

      To get more information about how to get OAuth credentials, see the VMware documentation on the VMware documentation site.
   3. Review the other fields on the Applications Registries form as needed.

      Table 2. Application Registries form

      Field	Description
      Name	Name of the OAuth app.
      OAuth API Script	Script that is used to customize requests and responses to the external OAuth provider.
      Logo URL	Logo URL for the OAuth app.
      Default Grant type	The Default Grant Type that is used to establish the OAuth token.
      Refresh Token Lifespan	Number of seconds that a refresh token issued will be good for.
      PKCE required	Option to enable public clients to require PKCE during the authorization flow.
      Application	Application that contains this record.
      Accessible from	Location where the OAuth is accessible from.
      Active	Option to activate the OAuth app.
      Authorization URL	OAuth authorization code end-point.
      Token Revocation URL	OAuth access token revocation end-point.
      Redirect URL	The OAuth app end-point to receive authorization code.
      Use mutual authentication	Option to use mutual authentication for token requests and revocations. This option requires that a Mutual Auth Profile is specified.
      Send Credentials	Option to enable OAuth Client populate client credentials in the request per the choice selected.
      Comments	Comments about the OAuth app.

   4. Click Update if necessary.
   5. In the Configure authentication credentials task section, click Mark as Complete.
5. In the Configure HTTP connection task section, click Configure and complete the following steps:
   1. On the form, fill in the fields.

      Table 3. HTTP(s) Connection form

      Field	Description
      Name	Name of the connection.
      Use MID server	MID Server that sends this HTTP connection. Using a MID Server is not compatible with mutual authentication.
      Host	Target host value that is used by the connection. The Connection URL will automatically fill in the hostname. Note: Update the Host field with a VMware Workspace ONE UEM base URL. For example, as4855.awmdm.com.
      Credential	Credential value used by this connection.
      Connection alias	Connection value that is used to refer to the connection.
      URL builder	URL builder that is used to build the connection URL.
      Connection URL	Connection URL of the connection. You can either manually enter your connection URL or use the URL builder to build the connection string.
      Mutual authentication	Optional to enable mutual authentication.
      Protocol	Underlying protocol used by the connection. Note: Update the Protocol field if you are using anything other than https.
      Active	Option to activate the HTTP connection.
      Domain	Domain that contains the connection.
      Override default port	Target value port that is used by the connection.
      Base path	Base path for HTTP(s) connection. Note: You do not need to update this field.

      Note: The HTTP connection will be pre-configured to use the authentication credentials that were configured during the previous setup task.
   2. Click Update if necessary.
   3. In the Configure HTTP Connection task section, click Mark as Complete.
6. In the Validate data sources task section, click Configure and complete the following steps:
   1. Review the fields on the Data Source form, which is automatically set.

      Table 4. Data Source form

      Field	Description
      Name	Unique name of this data source.
      Import set table label	Specify the import set table that is produced by this data source.
      Import set table name	Name of the table that will be created for this data source.
      Type	Data storage type of the data to be imported.
      Data in single column	Data in single column.
      Use Batch Import	Option to use batch insert to import set table.
      Application	Application that contains this record.
      Data Stream action	Data Stream action that provides complex object streams to load data.
      Data Loader	Script that loads data in import set table.

   2. To test the connection, click the Test Load 20 Records related link
      Testing the connection takes a few moments, after which the page refreshes to show the test results. The connection is successful if the HTTP Status is 200. If there is an Error Code and Error Message, the connection failed and further troubleshooting is required.
      Note: Do not click Load All Records during this setup.
   3. In the Help sidebar, click Back to Guided Setup.
   4. In the Validate data sources task section, click Mark as Complete.
7. On the left side bar, click the duplicate detection rules icon.
8. On the Service Graph Connector for VMware Workspace ONE UEM page, in the Duplicate detection rules section, select the task Configure duplicate detection rules.
9. In the Configure duplicate detection rules section, click Configure.
10. On the CMDB Duplicate Row Rules form, update the Active column value to true to activate the duplicate detection rule.
    Note: To remove fields from being evaluated, add the field names with a comma in a separated list in the Ignore Fields column.
11. In the Help side bar, select Mark as Complete.
12. On the left side bar, click the Set up scheduled import jobs button.
13. On the Service Graph Connector for VMware Workspace ONE UEM page, in the Set up scheduled import jobs section, select the task Configure the scheduled job.
    1. In the Configure the scheduled job task section, click Configure.
    2. Select the name of the scheduled import that you want to run.
    3. Review the pre-populated fields on the Scheduled Data Import form.

       Table 5. Scheduled Data Import form

       Field	Description
       Name	Name of the scheduled job.
       Data source	Data source record that defines the data to import.
       Run as	Option to run the scheduled job with the credentials of the specified user.
       Active	Option to activate the scheduled job. Select this option.
       Concurrent Import	Function that loads the data from multiple import sets. The function then processes and transforms the data concurrently.
       Partition Method	Partition method for the concurrent import set.
       Partition Size	Import set size for early scheduling.
       Execute pre-import script	Option to specify a script to run before the import is performed.
       Execute post-import script	Option to specify a script to run after the import is performed.
       Application	Application that contains this scheduled job.
       Run	Frequency of running the import.
       Conditional	Conditions under which this job is executed.

    4. Click Execute Now and repeat the previous steps for the other imports if needed.
    5. In the Help task bar, click Mark as Complete.

If you need to connect to multiple instances of Workspace ONE UEM, you can create multiple connections and scheduled imports to import data from multiple data servers.

1. Navigate to Service Graph Connector VMWare Workspace > Setup.
2. On the left side bar, click the Create another connection button.
3. On the Service Graph Connector for VMware Workspace ONE UEM page, in the Create another connection section, select the task Update Scheduled Data Import access.
   1. In the Update Scheduled Data Import access task section, select Configure.
   2. Select the Scheduled Data Import [scheduled_import_set] table.
   3. To edit the record, select Global from the Scope menu.
   4. Under the Application Access tab, select the Can create, Can update, and Can delete check boxes.
   5. Save the record.
   6. From the Scope menu, select Service Graph Connector for VMWare Workspace ONE UEM.
   7. In the Help task bar, click Mark as Complete.
4. On the Service Graph Connector for VMware Workspace ONE UEM page, in the Create another connection section, select the task Create or Edit connection.
   Note: You need to the following information from your VMWare Workspace ONE UEM administrator:

   • Client ID
   • Client Secret
   • Token URL
   • Connection URL

   To get more information about how to get OAuth credentials, see the VMware documentation on the VMware documentation site. To get more information about the Token URL, see the Workspace ONE Access Token URL documentation on the VMware documentation site.

   1. In the Create or Edit connection, select Configure.
   2. Do one of the following:
      • To create a new connection, select Add Connection.
      • To edit an existing connection, select the Edit button.
   3. On the form, fill in the fields or edit as needed.

      Table 6. Connection form

      Field	Description
      Connection Name	Display name for the connection.
      Connection URL	Connection URL for the new connection.
      Use MID Server	Option to select a MID Server that sends this connection. Using a MID Server is not compatible with mutual authentication.
      MID Server	MID Server for the connection.
      OAuth Entity Name	Display name for OAuth Entity.
      OAuth Client ID	Client ID for the provider.
      OAuth Client Secret	Client Secret for the provider.
      OAuth Token URL	Callback URL for the provider.

   4. Do one of the following:
      • To create the new connection, select Create and Get OAuth Tokens.
      • To save the edits for the existing connection, select Edit and Get OAuth Token.
5. On the Service Graph Connector for VMware Workspace ONE UEM page, in the Create another connection section, select the task Create scheduled import jobs.
   1. In the Create scheduled import jobs, select Configure.
   2. On the form, fill in the fields.

      Table 7. Create Scheduled Import form

      Field	Description
      Scheduled Data Import name prefix	Contents of this field that will be prepended to the Scheduled Data Import name.
      Connection and Credential Alias	Connection and Credential Alias of the import. Select the connection alias that was created in the previous step.
      Run Scheduled Imports as User	User who will run the scheduled data import.

   3. In the Help task bar, click Mark as Complete.