Setup guide
How to connect your Microsoft 365 and Entra ID tenant to Vijilan Free Monitor for Microsoft 365. You register a read-only app in your own tenant, then connect it in the Vijilan portal. It takes less than 30 minutes. Nothing here changes anything in your tenant beyond creating that app.
Before you start
- A Microsoft 365 administrator who can grant tenant-wide admin consent to Microsoft Graph application permissions: a Privileged Role Administrator or a Global Administrator.
- Audit logging turned on in Microsoft Purview (step 1 shows how to check).
- Your Vijilan portal sign-in, from the email we sent after you signed up.
- 01
Check that audit logging is on
In the Microsoft Purview portal (purview.microsoft.com), open Audit. If you see an option to start recording user and admin activity, turn it on.
New audit data can take a few hours to start flowing after it is first turned on.
- 02
Sign in to the Vijilan portal
Go to portal.vijilan.io and sign in with the account from your welcome email.
- 03
Choose Connect for Microsoft 365
Open the invitation email from Vijilan, accept it and sign in to portal.vijilan.io. On the Microsoft 365 monitoring page, choose Connect next to Microsoft 365. Microsoft's sign-in page opens in a new window.
- 04
Review and approve on Microsoft's consent screen
Sign in as the administrator described above.
Check that the screen shows Vijilan Free Monitor for Microsoft 365, and lists the seven read-only permissions in the table below and nothing else.
Choose Accept. This grants read-only access to your tenant. It does not let Vijilan change anything.
- 05
Monitoring starts
You return to the portal, which shows Microsoft 365 as connected. Monitoring starts straight away; the whole setup takes less than 30 minutes.
The seven permissions, in one place
| API | Permission | Why |
|---|---|---|
| Office 365 Management APIs | ActivityFeed.Read | Read the Microsoft 365 audit activity feed: Exchange, SharePoint, OneDrive and Entra ID events. |
| Office 365 Management APIs | ActivityFeed.ReadDlp | Read data loss prevention events in that feed. |
| Office 365 Management APIs | ServiceHealth.Read | Read Microsoft 365 service health. |
| Microsoft Graph | Directory.Read.All | Read users, groups, roles and applications in the directory. |
| Microsoft Graph | User.Read.All | Read user profiles. |
| Microsoft Graph | SecurityEvents.Read.All | Read security alerts. |
| Microsoft Graph | AuditLog.Read.All | Read Entra ID sign-in and audit logs. |
All application permissions, granted with admin consent. All read-only.
If anything looks wrong
If the consent screen shows a different application name, an unverified publisher, or any permission that can write, send or manage, stop and email info@vijilan.com. Vijilan will never ask you for a password, a client secret or a sign-in code by email, phone or chat. Approve access only on Microsoft's own consent screen, reached from portal.vijilan.io.
Removing access
In the Microsoft Entra admin center, open Enterprise applications, find the Vijilan application and delete it. Monitoring stops at once and nothing else in your tenant changes.
Government tenants
Microsoft 365 GCC tenants connect the same way. GCC High and DoD tenants are not supported, because the service keeps monitoring data on commercial cloud infrastructure in the United States.
Licensing
Some detections rely on data Microsoft provides only with Microsoft Entra ID P1 or P2, such as sign-in logs and risk detections. Everything else works without them.