Join our Newsletter — 33% off our NHI Course
Home› Guides› Omnissa Workspace ONE UEM Security: Console Roles, Compliance…
Guide Endpoint Security

Omnissa Workspace ONE UEM Security: Console Roles, Compliance and APIs

PDF for newsletter subscribers · free to read online

← All guides
By NHI Mgmt Group, edited by Lalit Choda Updated 8 November 2026 15 min read
On this page

Whoever controls the Workspace ONE UEM console can push software to, lock or wipe every enrolled device, so the console deserves the same protection as a domain controller. Omnissa Workspace ONE UEM (formerly VMware Workspace ONE UEM, and AirWatch before that) manages phones, tablets, Macs, Windows PCs and rugged devices from one tenant, organised into a tree of organisation groups. This guide covers the product-specific controls: how administrators authenticate, how roles and organisation groups scope their power, how REST API clients and directory bind accounts are handled, what to send to your SIEM, and a hardening baseline built from Omnissa documentation and the DISA STIG for the UEM server. It is for UEM administrators, endpoint security engineers and identity teams. The general case for treating MDM as tier zero is in the Mobile Device Management Security Guide; this page goes one level deeper into Workspace ONE itself. Menu paths below come from Omnissa documentation for console releases 2302 to 2410; option names and availability differ between SaaS, dedicated SaaS and on-premises deployments, so confirm them against the documentation for your release.

This is an independent guide from NHI Mgmt Group, based on Omnissa's public documentation as of November 2026. It is not sponsored or reviewed by Omnissa. Product features change, so confirm settings against Omnissa's current documentation.

Key takeaways

  • Federate admin sign-in. Use the SAML option for Admin under Directory Services so console access inherits your identity provider's MFA and Conditional Access, and keep local console accounts to a small, monitored break-glass set.
  • Roles and organisation groups are two separate dials. A role decides what an admin can do; the organisation group it is assigned at decides where. Both must be narrow.
  • Turn on every Restricted Actions PIN. Device wipe always needs a PIN, but enterprise wipe, device delete, admin account delete and REST API key delete are toggles that should be enabled, with notes required.
  • Treat OAuth clients as privileged non-human identities. Each client carries a role; scope it, store the secret in a vault, and review it like an administrator.
  • Stream console events in real time. Syslog over Secure TCP to the SIEM gives you admin logins, role changes and destructive actions as they happen.

How identity and access work in Workspace ONE UEM

Three populations authenticate to a Workspace ONE UEM tenant, and each has its own controls:

  • Console administrators: sign in to the web console with a local UEM account, a directory account, or through SAML from your identity provider. The SAML route is configured at Groups & Settings > All Settings > System > Enterprise Integration > Directory Services by selecting Use SAML for Authentication and then enabling SAML authentication for Admin (the same setting can also apply SAML to Enrollment and the Self Service Portal).
  • End users enrolling devices: authenticate during enrolment with directory, SAML or basic UEM credentials, and receive an end user role (Full Access, Basic Access or External Access by default).
  • Machine clients: REST API callers authenticate with OAuth 2.0 client credentials (SaaS) or legacy API keys, and the Enterprise Systems Connector binds to your directory with a service account.

Directory integration is the hinge. The LDAP connection supports Encryption Type None, SSL or Start TLS; the port defaults to 389 and changes to 636 when SSL is selected. Choose SSL or Start TLS, and use LDAP protocol version 3. The bind account needs only read access to the directory; it can be a named bind user or the App pool identity of the Enterprise Systems Connector server (Use Service Account Credentials). Group sync settings matter for privilege: Auto Merge applies directory membership changes without admin approval up to the Maximum Allowable Changes threshold, so a directory compromise can flow straight into console user groups. Keep that threshold low for groups that drive admin access or enrolment rights.

Local console accounts follow the password policy at Groups & Settings > All Settings > Admin > Console Security > Passwords, which can only be set at the Global organisation group. Documented values: minimum length 7 characters, expiry up to 120 days, up to 6 invalid attempts before lockout, default lockout 10 minutes, complexity either letters and numbers (default) or letters, numbers and special characters, plus password history and recovery questions. Those are weak by modern standards, which is the main reason to push administrators through SAML and your identity provider's phishing-resistant MFA instead. See the Federation and Trust Relationships Guide for the trust you are creating.

Admin sign-in routeMFA and policyMain riskUse for
SAML from your identity providerInherits IdP MFA, Conditional Access and session controlsIdP compromise or a misconfigured SAML signing setupAll day-to-day administrators
Directory (LDAP) accountDirectory password only at the consolePassword spray and stolen directory credentialsAvoid for admins where SAML is available
Local UEM accountConsole password policy (7 character minimum)Short minimum length, often forgotten in offboardingBreak-glass only, two accounts, monitored

Admin roles and privileged access

Roles are built from resources, each granting Read or Edit on a console function. Omnissa's default admin roles include System Administrator, AirWatch Administrator, Console Administrator, Device Manager, Report Viewer, Content Management, Application Management, Help Desk, App Catalog Only Administrator, Read Only, Horizon Administrator, NSX Administrator and Privacy Officer. Default roles update automatically when new features ship; custom roles do not, so every upgrade needs a pass over custom roles to decide whether new resources should be granted. Role changes take effect only after the admin signs out and back in.

Scope comes from the organisation group (OG). A role is associated with the OG where it was created, and an admin assignment at a parent OG reaches every child OG. A Help Desk role at the Global OG can act on every device in the tenant; the same role at a regional OG cannot. Design the OG tree with administration in mind, not only device grouping.

NeedApproachNotes
Tenant-wide configurationSystem or AirWatch Administrator at Global or Customer OGSmallest practical number of people; the DISA STIG asks for AirWatch Administrator and Device Manager to be limited this way
Regional or business unit device supportCopy of Help Desk or Device Manager, assigned at the child OGRemove wipe and delete resources unless the team truly needs them
App and content publishingApplication Management or Content ManagementApp publishing is code execution on every device in scope (ATT&CK T1072)
Audit and reportingRead Only or Report ViewerGood default for auditors and security analysts
Privacy reviewPrivacy OfficerSeparates who can change data collection settings

Use the role Compare function, which compares exactly two roles and exports differences to CSV, to evidence least privilege during reviews. Omnissa also warns that staging user credentials (used to enrol devices on behalf of users) should be treated with the same care as administrator credentials.

The DISA Omnissa WS1 UEM Server STIG (dated 15 June 2026) includes a requirement that each predefined administrator role (AirWatch Administrator, Device Manager and Read Only) has at least one member, or an approved custom equivalent, and that the two powerful roles are held by as few people as possible. The point is separation of duties: if every administrator holds the top role, nobody is limited.

Restricted Actions: the second lock on destructive commands

Groups & Settings > All Settings > System > Security > Restricted Actions controls which admin actions need a security PIN and which need a note. Some actions always need a PIN and cannot be turned off: Device Wipe, Organisation Group Delete, APNs Certificate Change, Data Encryption Toggle, Regenerate Enterprise Systems Connector Certificate, Secure Channel Certificate Clear, Force BIOS Password Reset and App Scan Vendor Reset/Toggle. Others are toggles and should all be enabled, in particular Enterprise Wipe, Device Delete (bulk delete always needs a PIN), Admin Account Delete, Admin Password Change, Profile Delete/Deactivate, Revoke Certificate, Delete REST API Key, Delete Workspace ONE Access Configuration and Change in Privacy Settings. Set Maximum invalid PIN attempts low (the range is 1 to 5); exceeding it logs the session out and forces a new PIN. Tick Require Notes so wipes, locks, reboots and enterprise resets carry a recorded reason. Set Child Permission so child OGs inherit rather than override these settings.

A PIN is not multi-person approval: an attacker holding a hijacked admin session can set or know the PIN. It does add friction and a logged step. Our recommendation at NHI Mgmt Group: give destructive actions both narrow role scope and alerting. See the Privileged Access Management Guide for just-in-time elevation patterns you can apply to the top roles.

Integrations, API tokens and service accounts

Workspace ONE UEM accumulates non-human identities quickly: REST API clients for automation and ITSM, the directory bind account, the Enterprise Systems Connector, SCEP and certificate authority connectors, and the Apple Push Notification service (APNs) certificate. Each one is a path to the console's power.

  • OAuth clients: in SaaS, create them at Groups & Settings > Configurations > OAuth Client Management with a name, description, organisation group and role. The role sets the API permissions (each maps to API calls with Read Only or Edit access), and the OG sets scope. The client secret is shown once and cannot be retrieved later. Tokens are issued by the Workspace ONE Token Service at a regional endpoint (for example na.uemauth.workspaceone.com or emea.uemauth.workspaceone.com) using the client_credentials grant.
  • Token lifetime: OAuth Token Validity under Session Management defaults to 3,600 seconds; a value of zero makes tokens always valid. Never set zero.
  • Legacy API keys: older integrations use an API key combined with an admin account's credentials. Migrate them to OAuth clients with dedicated roles, and enable the Delete REST API Key PIN so keys cannot be silently removed and replaced.
  • Directory bind account: read-only, excluded from interactive logon, password in a vault, and alerted on if used from anywhere but the connector host.
  • APNs certificate: Omnissa asks for a corporate Apple account dedicated to MDM, not a person's, and renewal must use the same account that created the certificate; losing access to it can force re-enrolment of Apple devices.
CredentialWhere it livesWhat it can do if stolenControl
OAuth client secretAutomation platform, ITSM, scriptsAnything its role allows at its OG (T1528)Dedicated custom role, child OG, vault, rotate, 1 hour tokens
Legacy API key plus admin accountOld integrationsActs as that adminReplace with OAuth client, then delete
Directory bind accountDirectory Services settings, connectorRead directory data; directory pivotRead-only, SSL or Start TLS, vault, sign-in alerts
Staging userEnrolment staff, device prepEnrol devices into the tenantTreat as admin credential, per Omnissa guidance
Local break-glass adminSealed vault entryFull consoleTwo accounts, alert on every use

Omnissa's move from legacy VMware domains to Omnissa domains required firewall changes by 15 June 2025 for API-driven and automation tasks; if old allow lists or scripts still reference VMware hostnames, review them as part of the integration inventory. For the wider discipline, see the API Keys vs OAuth Tokens Guide and the OWASP NHI5 Overprivileged NHI Guide.

Logging and detection

Workspace ONE UEM can send console events and device events to a SIEM through Monitor > Reports & Analytics > Events > Syslog. Console events are sent in real time. Protocol options are UDP, TCP and Secure TCP; message format can be the Workspace ONE UEM Legacy format, RFC 3164 or RFC 5424. Use Secure TCP and RFC 5424, set a distinctive Message Tag, and use Test Connection before relying on it. Omnissa recommends the AirWatch Cloud Connector for SaaS syslog delivery even when the SIEM endpoint is reachable publicly. Enable all console event categories; device events are noisier and can be trimmed. See the SIEM Log Source Onboarding Checklist.

DetectionSignalWhy it matters
New admin account or role assignmentConsole events for admin create and role changePersistence and escalation (T1098)
Bulk or out-of-hours wipe, enterprise wipe or device deleteConsole device action events, count per admin per hourDestructive impact (T1485)
New or changed app, product provisioning or scriptApplication and product eventsSoftware deployment as execution (T1072)
OAuth client created, enabled or role changedConfiguration eventsNew machine path to the console
Restricted Actions, password or session settings changedSettings eventsDefence weakening before an attack
Local admin loginConsole login events with account typeBreak-glass use or bypass of SAML
Failed security PIN attemptsConsole eventsSomeone probing a destructive action

Pair these with identity provider sign-in logs for the SAML application so you can tie a console session to device, location and MFA method. Useful measures: percentage of console admins signing in through SAML (target 100% except break-glass), number of admins holding tenant-wide roles, OAuth clients with a named owner and a review date, mean time to alert on a bulk wipe, and days since last custom role review.

Hardening baseline

  1. Inventory first: export admins, roles, OG assignments, OAuth clients, API keys and directory settings. Record who owns each.
  2. Federate admins: configure SAML for Admin under Directory Services, apply phishing-resistant MFA and device conditions in the identity provider, and test with a pilot group before moving everyone.
  3. Reduce local accounts: keep two local break-glass accounts with the strongest password complexity setting, lowest practical lockout threshold and expiry, and delete the rest.
  4. Session limits: under Admin > Session Management set Idle Session Timeout towards the 15 minute floor (range 15 to 480), turn off Allow Multiple Sessions, turn off Allow IP Address Change, keep Forced Session Timeout well under the 1,440 minute default, and keep OAuth Token Validity at or below 3,600 seconds.
  5. Restricted Actions: enable every toggle PIN, require notes, set PIN attempts to 3 or fewer, force inheritance to child OGs.
  6. Roles: move people off System and AirWatch Administrator into scoped custom roles; assign at the lowest OG that works; review custom roles after every upgrade.
  7. Enrolment: require directory or SAML authentication for enrolment, use Restrict Enrollment to Configured Groups where it fits, and treat staging accounts as privileged.
  8. Compliance policies: define passcode, encryption, OS version and check-in rules per platform, and use the escalation sequence (notify, restrict profiles and apps, then remove access) rather than jumping to a wipe. Feed compliance into access decisions; see the Device Trust and Posture Guide.
  9. Logging: Secure TCP syslog with all console events to the SIEM, detections from the table above.
  10. Patching: subscribe to Omnissa Security Advisories (OMSAs). On-premises servers are your responsibility, so apply Omnissa security updates promptly and track each OMSA to closure.

Rollback: SAML for Admin is the change most likely to lock people out. Keep the break-glass accounts tested before you switch, change one OG at a time where OG-level settings allow it, and use the Settings Audit and Comparison tools under Admin settings to record before and after states.

Common misconfigurations

  • Everyone is an AirWatch Administrator at Global: convenient during rollout, never cleaned up. Every help desk session can wipe the whole fleet.
  • Toggle PINs left disabled: enterprise wipe and device delete run with one click, and nobody records why.
  • OAuth Token Validity set to zero: tokens never expire, so a leaked token is a permanent key.
  • Integration accounts on a person's identity: legacy API keys tied to a named admin break when that person leaves, or worse, survive their departure.
  • Plain LDAP on port 389: bind credentials and directory queries cross the network unencrypted.
  • Custom roles never revisited: new features arrive with new resources, and custom roles silently miss controls or are bulk-granted Edit to catch up.
  • Syslog never tested: the integration is enabled but the SIEM receives nothing after a certificate or connector change.

Framework mapping

Control areaNIST SP 800-53 Rev 5NIST CSF 2.0ATT&CK v20
Federated admin sign-in with MFAIA-2(1)PR.AA-05T1078.004
Scoped roles and OGsAC-6, AC-6(5)PR.AA-05T1098
OAuth clients and bind accountsIA-5, AC-2PR.AA-05T1528, T1552
Restricted Actions and settings baselineCM-6PR.PS-01T1485, T1072
Console events to SIEMAU-6DE.CM-03T1098
Device and admin inventoryCM-8ID.AM-02T1199

Practitioner checklist

  • Enable SAML authentication for Admin and require phishing-resistant MFA in the identity provider.
  • Keep exactly two local break-glass console accounts and alert on every login.
  • Reassign tenant-wide roles to scoped custom roles at the lowest workable organisation group.
  • Enable every toggleable Restricted Actions PIN, require notes and force inheritance.
  • Set idle timeout near 15 minutes, disable multiple sessions and IP address change, keep OAuth tokens at one hour or less.
  • Give every OAuth client a dedicated role, an owner and a vaulted secret; retire legacy API keys.
  • Use SSL or Start TLS for directory binds and keep Auto Merge thresholds low.
  • Send all console events over Secure TCP syslog and build alerts for admin changes and bulk wipes.
  • Review custom roles after each upgrade and patch on-premises components against OMSAs.

Standards and references

Related NHI Mgmt Group resources: Mobile Device Management Security Guide · Device Trust and Posture Guide · Privileged Access Management Guide · Break-Glass Account Guide

PDF for subscribers

Take this guide with you

Every section, table and checklist in one PDF, with links to the sources and related guides. Subscribe to our weekly NHI & AI Identity Journal and we’ll email you a download link.

Free weekly newsletter

Subscribe to the NHI & AI Identity Journal

The latest on NHI and Agentic AI security – articles, research, breaches, news and events every week.

Bonus 33% off our NHI Course when you subscribe.

NHIMG Editorial Note
Researched and written by the NHI Mgmt Group editorial team using AI tools, under the editorial direction of Lalit Choda. Facts are drawn from the sources listed on this page and checked by our automated quality process. Last updated 8 November 2026. Spotted an error? Use our contact page.
NHI Mgmt Group, the independent authority on Non-Human Identity, IAM and Agentic AI security. nhimg.org

PDF Downloads for Newsletter Subscribers

Get the guide

Enter your details and we’ll email you a download link.

The full guide is free to read online. The PDF is a thank you for subscribing.

Fill in all fields marked * and tick the PDF box to continue.