Skip to content
Documentation

Getting Started

This page walks a first-time operator from sign-in to a safe audit-mode rollout.

This page walks a first-time operator from sign-in to a safe audit-mode rollout. It does not ask you to enforce policy on the first day.

Sign-in screen in light mode Sign-in screen in dark mode


Collect these details from your administrator:

Item Example Notes
Console URL https://platform.example.com/xdr/uec/<tenant> The tenant slug is part of the URL.
Identity admin@example.local Local, Entra ID or OIDC depending on tenant configuration.
Password or SSO provider — MFA may be required.
Base device group Windows-Ring-0 Know where test devices live before authoring.
Target test devices 1–5 endpoints Never first-enforce on the entire fleet.

If your session has been signed out elsewhere, UEC redirects to sign-in with that reason. After a required password change, the session is restricted until the password is changed and all existing sessions are revoked.


  1. Open the tenant URL.
  2. Enter your email and password, or choose SSO.
  3. Complete MFA if prompted.
  4. If UEC requires a password change, set a new password and sign in again.
  5. Select the base policy group scope if your account can see more than one.

Dashboard after sign-in Dashboard after sign-in in dark mode


Select Guided tour in the header. The tour walks the shell, dashboard, policy and endpoint areas, events, alerts, audit, protection, compliance, operations, tooling and management. You can stop with Escape, resume from the chapter picker, or replay it at any time.


  1. Open Devices.
  2. Confirm your test endpoints are online and reporting the expected version.
  3. Select a device to review OS, group, tags, control mode, signed/unsigned counts and last seen.
  4. Open About and confirm product version and service health.
  5. Open Audit Log and confirm your sign-in and configuration reads are recorded.

Devices in light mode Devices in dark mode

Use status:, os:, hostname:, tag: or version >= in the search box instead of paging. A plain word still performs a normal text search.


  1. Open Software Catalog.
  2. Review publisher counts, applications, logical installs and signed percentage.
  3. Switch between Publisher, Driver and Category views.
  4. Search publisher : Microsoft or publisher == Microsoft to see contains versus exact match.
  5. Open an application and export its device install base if you need owner or ring information.

Software Catalog in light mode Software Catalog in dark mode

Do not treat a low signed percentage as automatically malicious. Linux package metadata, scripts, internal tools and unsigned installers all affect the number. Read it beside publisher, source and device.


  1. Open Policies.
  2. Create a base policy for one test platform.
  3. Start from an empty, default Windows or hardened template as appropriate.
  4. Keep the first variant in Draft while you review rules and policy options.
  5. Submit it for review, then approve it.
  6. Assign only the Ring 0 base group.
  7. Keep the effective mode Audit.
  8. Watch Events for blocked, audited and allowed executions.

Policies in light mode Policies in dark mode

A safe promotion sequence is:

Ring 0 audit → Ring 0 enforce → Ring 1 audit → Ring 1 enforce → broader rings

Never skip the audit soak for a new base trust envelope.


  1. Open Events or Alerts and select the blocked execution.
  2. Copy or inspect the file identity: hash, signer, publisher and path.
  3. Open Discovery Scans or File Identities.
  4. Prefer a signer or publisher rule when the publisher is trustworthy and stable.
  5. Use a hash rule for a one-off binary.
  6. Put the rule in a supplemental policy assigned to the smallest useful group.
  7. Audit, verify on one device, then broaden the assignment.

File identities in light mode File identities in dark mode


Before broad rollout, an administrator should review:

Area Why it matters
Settings → Identity & Access Users, roles, SSO and conditional access.
Settings → Security Password policy, session and platform security choices.
Settings → Retention How long events and alerts remain queryable.
Settings → Alert Generation Agent-offline and noise thresholds.
Settings → Modules Enable only capability the tenant uses.
Agent Configuration Event channels, heartbeat and telemetry streams.
Audit Log Verify changes and approvals are captured.

Settings in light mode Settings in dark mode


Why is a device offline? A device is offline when it misses the configured reporting threshold. Open the device to see last seen, version and health reasons such as dropped kernel events, a clock jump or reduced collector mode.

Can I enforce immediately after approving policy? Technically the artifact and assignment model supports it; operationally you should audit a ring first. Enforcement without an execution sample risks blocking boot-critical or business software.

What is the difference between a supplemental policy and a device override? Supplemental policy is durable group intent that adds trust. A device override is exceptional, temporary device-level divergence and must expire.

Does a tag deploy policy? No. Tags describe and filter devices. Policy resolution uses base and supplemental groups.

Why do two themes exist? Operators work in different lighting and accessibility contexts. Both themes use the same design tokens; filters, charts, badges and tables should carry the same meaning in either theme.