> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> Connect Omnissa Workspace ONE UEM to Ravenna with an OAuth client ID and secret, your UEM server URL, and your data center region.

<Info>Connect to Omnissa Workspace ONE UEM using OAuth client credentials</Info>

This guide walks you through creating an OAuth client in Workspace ONE UEM and connecting it to Ravenna.

## Prerequisites

Before you begin, ensure you have:

* A Workspace ONE UEM SaaS tenant
* Admin access to the UEM console with permission to manage OAuth clients
* Organization Admin access in Ravenna
* Your UEM server URL, for example `https://as1234.awmdm.com`

<Note>
  Omnissa is organization-scoped. Each Ravenna organization can connect one Omnissa instance.
</Note>

## Setup guide

### Create an OAuth client

<Steps>
  <Step title="Open OAuth client management">
    In the Workspace ONE UEM console, go to **Groups & Settings > Configurations > OAuth Client Management**.
  </Step>

  <Step title="Add a client">
    Create a new OAuth client for Ravenna. Assign it a role that can read device inventory.
  </Step>

  <Step title="Copy the credentials">
    Copy the **Client ID** and **Client Secret**. You need both to connect Ravenna.
  </Step>
</Steps>

<Card title="Workspace ONE UEM API documentation" icon="arrow-up-right-from-square" href="https://developer.omnissa.com/workspace-one-uem-apis/">
  Learn more about OAuth clients and API access in Workspace ONE UEM.
</Card>

### Add integration

<Steps>
  <Step title="Navigate to integrations">
    1. Go to **Settings > Integrations**
    2. Find **Omnissa** in the Device Management section
  </Step>

  <Step title="Select Omnissa">
    Click **Connect** on the Omnissa integration card
  </Step>

  <Step title="Configure Omnissa credentials">
    Provide the following information:

    <ParamField path="OAuth Client ID" type="string" required>
      The client ID from **Groups & Settings > Configurations > OAuth Client Management** in the UEM console.
    </ParamField>

    <ParamField path="OAuth Client Secret" type="string" required>
      The client secret for the same OAuth client.
    </ParamField>

    <ParamField path="Server URL" type="string" required>
      The base URL of your Workspace ONE UEM server, for example `https://as1234.awmdm.com`.
    </ParamField>

    <ParamField path="Region" type="string" default="NA" required>
      The data center region of your Workspace ONE UEM SaaS tenant. The region determines which OAuth token URL Ravenna uses to authenticate.

      | Region | Covers | Token URL |
      | - | - | - |
      | `NA` | United States / Canada | `https://na.uemauth.workspaceone.com/connect/token` |
      | `EMEA` | United Kingdom / Germany | `https://emea.uemauth.workspaceone.com/connect/token` |
      | `APAC` | Asia Pacific (India, Japan, Singapore, Australia, Hong Kong) | `https://apac.uemauth.workspaceone.com/connect/token` |
      | `UAT` | UAT environments | `https://uat.uemauth.workspaceone.com/connect/token` |
    </ParamField>
  </Step>

  <Step title="Complete setup">
    Click **Connect** to complete the integration. Ravenna:

    1. Requests an OAuth access token from the token URL for your region
    2. Tests connectivity to your UEM server
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Failed to obtain OAuth access token" icon="circle-x">
    **Cause**: The client ID, client secret, or region is incorrect

    **Solution**:

    * Verify the client ID and secret were copied correctly (no extra spaces or characters)
    * Confirm the OAuth client is still active in **OAuth Client Management**
    * Check that the selected region matches your tenant's data center
  </Accordion>

  <Accordion title="Failed to validate Omnissa API connection" icon="circle-x">
    **Cause**: Ravenna cannot reach the UEM server URL

    **Solution**:

    * Verify the server URL is correct, for example `https://as1234.awmdm.com`
    * Ensure the URL includes the protocol (`https://`)
    * Confirm the OAuth client's role can access the UEM REST API
  </Accordion>

  <Accordion title="Devices missing for a user" icon="user-search">
    **Cause**: Ravenna cannot match the device to a Ravenna user

    **Solution**:

    * Verify the device is enrolled in Workspace ONE UEM
    * Check that the device's user email in UEM matches the person's email in Ravenna
  </Accordion>
</AccordionGroup>


## Related topics

- [Setup](/integrations/okta/setup/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.