Connect Microsoft
Patchly connects to your Microsoft environment with read-only API access. Setup takes about 2 minutes — you just need to grant admin consent and share your tenant ID.
Step 1: Grant Admin Consent
Click the link below and sign in with a Global Administrator or Privileged Role Administrator account:
Authorize Patchly for your organization
Review the permissions and click Accept. That’s it — Patchly is now authorized to read security data from your environment.
Step 2: Share Your Tenant ID
Send your Patchly contact your Directory (tenant) ID:
- Go to Azure Portal > Microsoft Entra ID > Overview
- Copy the Tenant ID
- Send it to your Patchly contact
Patchly will configure the data sync and let you know when your dashboard is ready — typically within one business day.
What Permissions Does Patchly Request?
All permissions are read-only and application-level (no user impersonation). Patchly never modifies data in your environment.
Microsoft Graph
| Permission | What it reads |
|---|---|
User.Read.All | User directory for identity context |
Device.Read.All | Registered device inventory |
Group.Read.All | Security group membership |
AuditLog.Read.All | Sign-in activity |
Directory.Read.All | Directory data |
Microsoft Defender for Endpoint
| Permission | What it reads |
|---|---|
Machine.Read.All | Device inventory |
Vulnerability.Read.All | Vulnerability data |
Software.Read.All | Software inventory |
Alert.Read.All | Security alerts |
SecurityRecommendation.Read.All | Security recommendations |
What Happens Next?
| Step | What | When |
|---|---|---|
| You grant consent | Patchly gets read-only access to your security data | Now |
| Patchly configures sync | Your tenant is added to the nightly data pipeline | Within 1 business day |
| First sync runs | Vulnerability, device, and user data are pulled | Next scheduled run (02:00 UTC) |
| Dashboard ready | Your Patchly contact sends you the link | After first sync completes |
See Data Security for how your data is stored and protected, or Data Freshness to understand sync timing.