PurviewHow-to

Insider Risk Management in Purview: policies, indicators, HR connector and first alerts

Set up Insider Risk Management end to end: role groups, audit and analytics, privacy and indicators, the HR connector, your first policy and the first alerts.

Insider Risk Management in Microsoft Purview correlates signals from Microsoft 365, devices and HR systems to spot data theft, leaks and security violations by people inside the organization. Policies stay silent when a prerequisite is missing, so the order of setup matters. In this post I'll go through the setup in the order that works: permissions, audit and analytics, settings, the HR connector, the first policy and the first alerts.

How this guide is organized: Prerequisites → Step-by-step → Verify → Tips & gotchasFlow diagram of the article's sections in reading order: 1. Prerequisites. 2. Step-by-step (6 steps: Assign the role groups; Run an analytics scan first; Configure the global settings; Feed in HR data; Create the first policy; Triage the first alerts). 3. Verify. 4. Tips & gotchas. Toolbox: Settings › Analytics, Policies › Create policy, webhook.ingestion.office.com, LastWorkingDate, RecordsSaved.1Prerequisites2Step-by-step3Verify4Tips & gotchas1Assign the rolegroups2Run ananalytics sca…3Configure theglobal settings4Feed in HRdata5Create thefirst policy6Triage the firstalertsTOOLBOXSettings › AnalyticsPolicies › Create policywebhook.ingestion.office.comLastWorkingDateRecordsSavedHow this guide is organized: Prerequisites → Step-by-step → Verify → Tips & gotchasFlow diagram of the article's sections in reading order: 1. Prerequisites. 2. Step-by-step (6 steps: Assign the role groups; Run an analytics scan first; Configure the global settings; Feed in HR data; Create the first policy; Triage the first alerts). 3. Verify. 4. Tips & gotchas. Toolbox: Settings › Analytics, Policies › Create policy, webhook.ingestion.office.com, LastWorkingDate, RecordsSaved.1Prerequisites2Step-by-step1Assign the role groups2Run an analytics scan first3Configure the global settings4Feed in HR data5Create the first policy6Triage the first alerts3Verify4Tips & gotchasTOOLBOXSettings › AnalyticsPolicies › Create policywebhook.ingestion.office.comLastWorkingDateRecordsSaved
At a glance: how this guide is organized · 6 steps · 5 key settings and tools

Prerequisites#

  • Licensing and region: confirm your subscription against Microsoft's Insider Risk Management licensing requirements (Microsoft points to a Microsoft 365 E5 trial if you want to evaluate it). Some indicators work only after you turn on pay-as-you-go billing, and the solution is available only in regions that support its Azure service dependencies.
  • Legal and HR agreement: Microsoft requires customers to run their own full investigation and use the solution lawfully. Agree scope and reviewers with HR and legal (and any works council) first.
  • Auditing on: policies and analytics read the unified audit log. It's on by default; check it as shown in searching the audit log.

Step-by-step#

Setting up Insider Risk Management in the order that worksStep 1: Assign the role groups. Admins configure; Analysts, Investigators and Auditors split triage and oversight Step 2: Run an analytics scan first. Shows where risk concentrates before any policy; results take up to 48 hours Step 3: Configure the global settings. Privacy, policy indicators and priority user groups apply to every policy Step 4: Feed in HR data. HR connector with a CSV upload, scheduled daily so departures arrive on time Step 5: Create the first policy from a template. Choose triggers and indicators; keep the default thresholds for a first policy Step 6: Triage the first alerts. Alerts start after about 24 hours; confirm one into a case or dismiss it1Assign the role groupsAdmins configure; Analysts,Investigators and Auditors splittriage and oversight2Run an analytics scan firstShows where risk concentratesbefore any policy; results take up to48 hours3Configure the global settingsPrivacy, policy indicators andpriority user groups apply to everypolicy4Feed in HR dataHR connector with a CSV upload,scheduled daily so departuresarrive on time5Create the first policy from atemplateChoose triggers and indicators;keep the default thresholds for afirst policy6Triage the first alertsAlerts start after about 24 hours;confirm one into a case or dismiss itSetting up Insider Risk Management in the order that worksStep 1: Assign the role groups. Admins configure; Analysts, Investigators and Auditors split triage and oversight Step 2: Run an analytics scan first. Shows where risk concentrates before any policy; results take up to 48 hours Step 3: Configure the global settings. Privacy, policy indicators and priority user groups apply to every policy Step 4: Feed in HR data. HR connector with a CSV upload, scheduled daily so departures arrive on time Step 5: Create the first policy from a template. Choose triggers and indicators; keep the default thresholds for a first policy Step 6: Triage the first alerts. Alerts start after about 24 hours; confirm one into a case or dismiss it1Assign the role groupsAdmins configure; Analysts, Investigators and Auditorssplit triage and oversight2Run an analytics scan firstShows where risk concentrates before any policy;results take up to 48 hours3Configure the global settingsPrivacy, policy indicators and priority user groups applyto every policy4Feed in HR dataHR connector with a CSV upload, scheduled daily sodepartures arrive on time5Create the first policy from a templateChoose triggers and indicators; keep the defaultthresholds for a first policy6Triage the first alertsAlerts start after about 24 hours; confirm one into acase or dismiss it
Figure 1 · Process Setting up Insider Risk Management in the order that works. Policies stay silent when a prerequisite is missing, so follow the steps in order: settings and HR data come before the first policy.

1. Assign the role groups#

In the Microsoft Purview portal, open Settings › Roles and scopes › Role groups. Insider Risk Management covers everything; Insider Risk Management Admins configures settings and policies; the Analysts, Investigators and Auditors groups split triage, deep investigation and oversight so no one person needs every right. Recommended actions on the Overview page need Insider Risk Management or Insider Risk Management Admins. If the solution is missing from your portal, see Purview roles and permissions.

2. Run an analytics scan first#

Analytics shows where risk concentrates before any policy exists. Go to Insider Risk Management › Overview, find the Scan for insider risks in your organization card and select Run scan (or turn on Scan your tenant's user activity to identify potential insider risks under Settings › Analytics). Results can take up to 48 hours. With analytics on, the policy wizard can also suggest indicator thresholds in real time.

3. Configure the global settings#

Settings apply to every policy, so set them before the first one:

  • Privacy: users are pseudonymized by default. Keep it that way unless HR and legal agree otherwise.
  • Policy indicators: turn on the Office, device and other indicators you plan to use. Indicators that aren't on here can't be selected in a policy. Device indicators need devices onboarded to Purview, as for endpoint DLP. Cloud indicators for Box, Dropbox, Google Drive, Amazon S3 and Azure (preview) need those apps connected in Microsoft Defender first.
  • Priority user groups: required for the "by priority users" templates. Turn on the priority user risk score booster under Policy indicators.

4. Feed in HR data#

HR data drives the departing-user templates (resignation dates) and the risky-user templates (job level changes, performance reviews and improvement plans); Patient data misuse also needs it. Departing-user templates can use the User account deleted from Microsoft Entra trigger instead, and risky-user templates can use Communication Compliance signals.

  1. Export a CSV from your HR system. You map the column names later; dates use ISO 8601. One file takes up to 500 records, so split larger exports.
  2. Register an app in Microsoft Entra ID and note the application ID, a client secret and the tenant ID.
  3. With the Data Connector Admin role, go to Settings › Data connectors › My connectors › Add connector, choose HR, pick the scenarios, map the columns and copy the job ID.
  4. Allow webhook.ingestion.office.com through your firewall, then run Microsoft's sample upload script from GitHub (upload_termination_records.ps1).
Text
UserPrincipalName,ResignationDate,LastWorkingDate
lena@contoso.com,2026-10-01T09:00:00Z,2026-10-30T17:00:00Z
PowerShell
.\upload_termination_records.ps1 -tenantId <tenant-id> -appId <app-id> `
    -appSecret <client-secret> -jobId <job-id> -filePath 'D:\HR\resignations.csv'

Good looks like Upload Successful. Schedule the export and upload daily (Task Scheduler or Microsoft's Power Automate template) so departures arrive on time. A LastWorkingDate can't be more than six months in the past or a year in the future at upload time.

5. Create the first policy#

Go to Insider Risk Management › Policies › Create policy and pick a template. A sensible first choice:

GoalTemplateWhat it needs
Leavers taking dataData theft by departing usersHR connector or the Entra account deletion trigger
Leaks by anyoneData leaksA DLP policy with High severity incident reports, or exfiltration indicators as triggers
Risky AI promptsRisky AI usageInsider risk extension in Edge or the Microsoft Purview extension in Chrome
Malware or disabled protectionSecurity policy violationsDefender for Endpoint with the Insider Risk Management integration turned on in its advanced features

In the wizard, the name can't be changed later. Scope to Include all users and groups if you want real-time threshold analytics; guest accounts aren't supported. Optionally add content to prioritize (SharePoint sites, sensitivity labels, sensitive info types, trainable classifiers, up to 50 file extensions). Finally, choose triggers and indicators, keep the default thresholds for a first policy and select Submit.

Watch out: a DLP policy used as a trigger must set incident reports to High; Low and Medium never create insider risk alerts. Alerts that come only from endpoint DLP, Teams DLP or Microsoft 365 Copilot DLP aren't evaluated by that indicator, and only users in scope of both policies count.

6. Triage the first alerts#

Alerts from activity indicators start after about 24 hours. Open the Alerts dashboard, review the activity, then confirm the alert into a case or dismiss it. A case can go to legal review in an eDiscovery case.

Verify#

  • HR data: in Settings › Data connectors › My connectors, open the connector and select Download log under Progress. RecordsSaved should equal the rows you uploaded.
  • Scope: the Users in scope column on the Policies page shows who is actively scored. Users without a triggering event aren't evaluated unless you add them manually on the Users dashboard, which is also the quickest way to test with a pilot account.
  • Alerts: after test activity by the pilot user (for example, copying labeled files to USB on an onboarded device), good looks like scored activity within about a day and an alert once thresholds are met.

Tips & gotchas#

  • Adaptive Protection turns insider risk levels into stricter DLP and Conditional Access for risky users only; see Adaptive Protection.
  • Communication Compliance can feed the "risky users" templates instead of, or alongside, HR data; see Communication Compliance setup.
  • AI risk: the Risky AI usage policy can also be created in one click from DSPM for AI.
  • Collection policies win: if a collection policy filters out a device activity, Insider Risk Management never sees it.
  • Limits: each template supports up to 100 policies, and each template has a cap on scored users; performance drops near the cap.
  • Secrets: Microsoft's Power Automate template can read the app secret from Azure Key Vault; with Task Scheduler the secret sits in the task's arguments, so lock that server down.

References#

Written and checked against current Microsoft Learn documentation. Test changes with a pilot group before rolling them out to everyone, and if an admin center path has moved since, search for the setting name instead.

Spotted a mistake, or did this fix work differently for you? Email me or message me on LinkedIn — corrections are credited in the article.

Written by

Omer Eltayeb

Intune Subject Matter Expert in Cairo, Egypt, former Microsoft Cloud Solutions Architect, Microsoft Certified Trainer and Microsoft Innovative Educator Expert (2024–26) and Microsoft Elevate Educator Expert (2026–27). I share practical, step-by-step guides, study plans, scripts and toolkits for Microsoft Intune, Configuration Manager, Microsoft Entra ID, Microsoft Defender, Exchange and Microsoft 365 with the community.

Microsoft Certified Trainer (MCT) 2026Microsoft Innovative Educator Expert 2025–2026Microsoft Elevate Educator Expert 2026–2027ISC2 Certified Information Systems Security Professional (CISSP)Microsoft 365 Certified: Enterprise Administrator Expert (MS-102)