Skip to main content

Praxis AI™Vijilan's most advanced SOC platform is open to early adopters.

Sign up here

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.
  1. 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.

  2. 02

    Sign in to the Vijilan portal

    Go to portal.vijilan.io and sign in with the account from your welcome email.

  3. 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.

  4. 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.

  5. 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

APIPermissionWhy
Office 365 Management APIsActivityFeed.ReadRead the Microsoft 365 audit activity feed: Exchange, SharePoint, OneDrive and Entra ID events.
Office 365 Management APIsActivityFeed.ReadDlpRead data loss prevention events in that feed.
Office 365 Management APIsServiceHealth.ReadRead Microsoft 365 service health.
Microsoft GraphDirectory.Read.AllRead users, groups, roles and applications in the directory.
Microsoft GraphUser.Read.AllRead user profiles.
Microsoft GraphSecurityEvents.Read.AllRead security alerts.
Microsoft GraphAuditLog.Read.AllRead 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.