Connect EqualWeb to SharePoint Online
EqualWeb scans, scores and remediates the PDFs in your document libraries - with nothing installed on your servers. The connection uses a dedicated app you create in Microsoft Entra ID (Azure AD), with permission only to the sites you choose (Sites.Selected) - never the whole tenant.
- A user with the Global Administrator or Application Administrator role in Microsoft 365
- The URL of the SharePoint site that holds your documents (for example https://yourcompany.sharepoint.com/sites/Documents)
The setup, start to finish
-
Create the app in Microsoft Entra
- Go to entra.microsoft.com → Identity → Applications → App registrations
- Click New registration
- Name it EqualWeb PDF Accessibility and click Register (no Redirect URI needed)
- On the app page, copy and save two values: the Application (client) ID and the Directory (tenant) ID
-
Create a Client Secret
- In the app menu: Certificates & secrets → New client secret
- Description: EqualWeb · recommended expiry: 24 months
- Copy the Value column immediately - it is shown only once
- Note the expiry date: before it lapses, create a new secret and update it in your EqualWeb settings
-
Add the Sites.Selected permission
- In the app menu: API permissions → Add a permission → Microsoft Graph → Application permissions
- Search for and select Sites.Selected → Add permissions
- Click Grant admin consent for your organization and confirm
Sites.Selected means the app has access to no site at all until you explicitly grant it a specific one - that is the next step.
-
Grant access to your specific site
- This is a one-time Graph call - the EqualWeb team will gladly do it with you on the onboarding call
- Open Graph Explorer (aka.ms/ge) and sign in as admin
- Run the request below (get the site-id from GET /v1.0/sites/yourcompany.sharepoint.com:/sites/Documents)
POST https://graph.microsoft.com/v1.0/sites/{site-id}/permissions { "roles": ["write"], "grantedToIdentities": [{ "application": { "id": "<Application (client) ID from Step 1>", "displayName": "EqualWeb PDF Accessibility" }}] } -
Enable single sign-on for your users (strongly recommended)
- In the app you created: Expose an API → Set the Application ID URI - accept the default api://<Application (client) ID>
- Add a scope: name access_as_user, Who can consent: Admins and users → save
- Once the EqualWeb package (the .sppkg file supplied by EqualWeb) is installed in your tenant App Catalog, approve its permission request: SharePoint admin center → Advanced → API access → Approve
From that moment, right-clicking a PDF opens EqualWeb with the user already signed in - their identity comes from their own Microsoft account. Zero passwords.
What you'll collect
| Field in EqualWeb settings | Where it comes from |
|---|---|
| Microsoft Entra tenant ID | Step 1 |
| Application (client) ID | Step 1 |
| Client secret (Value) | Step 2 |
| SharePoint site URL | Your site |
What permissions the app gets - and why
| Permission | Why it's needed |
|---|---|
| Microsoft Graph: Sites.Selected | Read and update PDFs only in the sites you explicitly granted - the rest of the tenant stays invisible to the app |
🔒 You stay in control: the grant is per-site, and your admin can revoke it at any time.
Activate in EqualWeb
Go to login.equalweb.com → PDF Integration → SharePoint → Settings, enter the values you collected, click Save and then Test connection.
From the moment you connect, EqualWeb automatically classifies every document by treatment priority - required for service, published to the public, internal, or archive - including public-exposure detection. In the Classification screen you can tag whole folders, exclude items (reversibly), and set an archive policy - and remediation is one click away.