> For the complete documentation index, see [llms.txt](https://docs.docontrol.io/docontrol-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docontrol.io/docontrol-user-guide/risk-management/misconfigurations-premium/integrate-apps.md).

# Integrate apps

With DoControl's Premium Misconfiguration solution, you can [monitor dozens of SaaS apps](#monitored-apps) in real-time, and fix any risky misconfigurations before they become security incidents.

To monitor your SaaS apps for misconfigurations, follow the [integration procedure](#add-new-integration).

{% hint style="success" %}

* All DoControl customers can monitor these apps for misconfigurations:
  * Google Workspace
  * GitHub
  * Zoom
* To unlock more apps in DoControl's Premium Misconfiguration solution, contact Customer Success.
* Note that the integration procedure for misconfigurations is different from DoControl's generic integration procedure.
  {% endhint %}

## Monitored apps

DoControl monitors these apps for misconfigurations:

* Google Workspace
* [Slack](#slack-basic-scopes)
* [Slack Enterprise](#slack-enterprise-scopes)
* [BambooHR](#bamboohr-scopes)
* [Box](#box-scopes)
* [Confluence](#confluence-scopes)
* [Cursor](#cursor-scopes)
* [Datadog](#deel-hr-scopes)
* [Deel](#deel-hr-scopes)
* [Dropbox](#dropbox-scopes)
* [Figma Enterprise](#figma-scopes)
* [GitHub](#github-scopes)
* HiBob
* [HubSpot](#hubspot)
* [Jira](#jira-scopes)
* [Microsoft OneDrive](#microsoft-onedrive-scopes)
* [Microsoft SharePoint](#microsoft-sharepoint-scopes)
* [Microsoft Teams](#microsoft-teams-scopes)
* [Miro](#miro-scopes)
* [monday . com](#monday.com-scopes)
* [Notion](#notion-scopes)
* [Okta](#okta-scopes)
* OpenAI Enterprise
* [Microsoft Outlook](#microsoft-outlook-scopes)
* PagerDuty
* [Salesforce](#salesforce-permission-set)
* [Zendesk](#zendesk-scopes)
* [Zoom](#zoom-scopes)
* [Anthropic ](#anthropic-scopes)

## Add new integration

For each SaaS instance that you'd like to monitor for misconfigurations, you need to add a new integration.

{% hint style="success" %}
**For example**: If your organization uses 2 instances of Slack, you need to integrate each instance separately.
{% endhint %}

1. Make sure you have signed up for DoControl's Premium Misconfiguration solution with Customer Success.
2. In DoControl, navigate to **Integrations > Misconfigurations**.
3. Click **Integrate your apps**.
4. Select the SaaS app you wish to monitor for misconfigurations, and click **Continue**.<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FV6T1n1ZAEG1fN11VluGe%2Fintegrate%20app%20SPM.png?alt=media&amp;token=514d143f-dee0-41f5-9e84-0502e22a6051" alt=""><figcaption></figcaption></figure>
5. Enter a short, unique instance name, and click **Continue**.\
   The instance name will be displayed in the DoControl platform.<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F7ry0dc0MaoZQnNlAw20q%2FInstance%20name.png?alt=media&amp;token=1af514c3-91b5-4e0c-963c-ca6cde3d064f" alt=""><figcaption></figcaption></figure></div>
6. Click **Connect** and follow the configuration wizard for each SaaS app instance you wish to monitor. The required scopes and permissions will be listed for each app.

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FbXhX0bhqDTZr3QWJfGef%2Fmisconfig%20wizard.png?alt=media&amp;token=c4c5e103-ef14-43a5-bfd5-9901fd9f7a23" alt="" width="453"><figcaption></figcaption></figure></div>

Once you've integrated all your app instances for misconfiguration monitoring, each instance is displayed with relevant integration data:

* **Integration status** - Success or error
* **integration date** - Date of integration and person who performed the integration

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F41NbxnqicMknKOlGEo7H%2Finstances.png?alt=media&amp;token=24a7da5e-b45f-4459-b6f4-9e35cdf97cf1" alt=""><figcaption></figcaption></figure>

## Manage integrations

You can search for any integration instance, change the instance name, or disconnect an integration.

### Search integrations

1. In DoControl, navigate to **Integrations > Misconfigurations**.
2. Locate any SaaS integration with these search parameters:
   * **Integration** - Select a SaaS app from the dropdown list
   * **Status** - Search integrations according to status: Success or Error
   * **Free text** - Enter any text string that appears in the integration name

### Edit instance name

You can change the name of any instance. Changing the name does not affect your existing data.

1. In DoControl, navigate to **Integrations > Misconfigurations**.
2. In the integration instance card, click the **More** icon.
3. Click **Edit name**.\
   ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FVI9BXbvOSaLJTHvwUIed%2Fedit%20name.png?alt=media\&token=2f266f1f-15e7-48f4-ab6d-c4544eb7a7fc)
4. Change the instance name and click **Save changes**.

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fc4VlG17hG7KMzy7RJVvk%2Fedit%20instance%20name.png?alt=media&amp;token=c64a6366-008b-44fe-9e17-80db58e16bd3" alt=""><figcaption></figcaption></figure></div>

### Disconnect integration

You can disconnect the integration for any instance. Once disconnected, the instance of your SaaS app will no longer be monitored for misconfigurations, and all misconfiguration data will be deleted.

1. In DoControl, navigate to **Integrations > Misconfigurations**.
2. In the integration instance card, click the **More** icon.
3. Click **Disconnect**.\
   ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FVI9BXbvOSaLJTHvwUIed%2Fedit%20name.png?alt=media\&token=2f266f1f-15e7-48f4-ab6d-c4544eb7a7fc)
4. Click **Disconnect**.

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FVtNWTappcBNd6NE9qIMj%2Fdisconnect%20app.png?alt=media&amp;token=4e7feb9f-5980-47f8-96bf-8d491569e2a5" alt=""><figcaption></figcaption></figure></div>

## Integration scopes

To monitor your SaaS app configurations in real-time, and detect any compliance drifts before they become security incidents, various permission scopes are required.&#x20;

{% hint style="info" %}
Before you integrate DoControl with any SaaS app for misconfiguration monitoring, make sure you are integrating with an **admin user** that has the **required scopes**
{% endhint %}

### Slack Basic scopes

These scopes are required to monitor Slack Basic for misconfigurations:

<table><thead><tr><th width="206.33984375">Slack Basic scope</th><th>Explanation</th></tr></thead><tbody><tr><td>im:read</td><td>View basic info (like membership and names) for direct message conversations the app is in, but not their message content</td></tr><tr><td>mpim:read </td><td>View basic info for group direct message conversations  the app is in, but not their message content</td></tr><tr><td>users:read</td><td>View the list of people in the workspace and their basic profile fields (e.g., name, ID, status)</td></tr><tr><td>users.profile:read </td><td>View detailed user profile information fields for people in the workspace</td></tr><tr><td>users:read.email</td><td>View the email addresses associated with users in the workspace</td></tr><tr><td>channels:read </td><td>View basic information about public channels in the workspace (e.g., names, IDs, topics), but not their messages</td></tr><tr><td>groups:read</td><td>View basic information about private channels the app has access to, but not their messages</td></tr><tr><td></td><td></td></tr></tbody></table>

Examples of Slack Basic security checks and their required scopes include:

<table><thead><tr><th valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Identify Channels with Unknown Too Many Owners<br></td><td valign="top"><p>im:read</p><p>npim:read</p><p>groups:read</p><p>channels:read</p></td></tr><tr><td valign="top">Restriction and Secure Management of Administrative Accounts</td><td valign="top"><p>users:read</p><p>users.profile:read</p><p>users:read.email</p></td></tr></tbody></table>

### Slack Enterprise scopes

These scopes are required to monitor Slack Enterprise for misconfigurations:

<table><thead><tr><th width="206.33984375">Slack Enterprise scope</th><th>Explanation</th></tr></thead><tbody><tr><td>team:read</td><td>View basic workspace information, including the name, email domain, and icon</td></tr><tr><td>groups:read</td><td>View basic information about private channels the app has access to, but not their messages</td></tr><tr><td>channels:read </td><td>View basic information about public channels in the organization (e.g., names, IDs, topics), but not their messages</td></tr><tr><td>mpim:read </td><td>View basic info for group direct message conversations  the app is in, but not their message content</td></tr><tr><td>im:read</td><td>View basic info (like membership and names) for direct message conversations the app is in, but not their message content</td></tr><tr><td>users:read</td><td>View the list of people in the organization and their basic profile fields (e.g., name, ID, status)</td></tr><tr><td>users:read.email</td><td>View the email addresses associated with users in the organization</td></tr><tr><td>users.profile:read </td><td>View  detailed user profile fields for members in the organization</td></tr><tr><td>admin.users:read</td><td>As an org or workspace admin, view administrative user details across the Enterprise organization (such as users and their roles) for management purposes</td></tr></tbody></table>

### Okta scopes

These scopes are required to monitor Okta for misconfigurations:

<table><thead><tr><th width="238.23046875">Okta scope</th><th>Explanation</th></tr></thead><tbody><tr><td>okta.users.read </td><td>Allows viewing Okta user resources, including users’ profiles and basic attributes, without modifying them</td></tr><tr><td>okta.roles.read</td><td>Allows viewing administrative roles and role assignments that define what privileges principals have in the Okta org</td></tr><tr><td>okta.apps.read</td><td>Allows viewing applications configured in the Okta org, including their metadata and assignments, without managing them</td></tr><tr><td>okta.groups.read</td><td>Allows viewing groups in the Okta org and their memberships, without creating or updating groups</td></tr><tr><td>okta.policies.read</td><td>Allows viewing security and access policies (such as sign-on or password policies) configured in the Okta org</td></tr><tr><td>okta.eventHooks.read</td><td>Allows viewing existing event hook definitions that send Okta events to external endpoints</td></tr><tr><td>okta.networkZones.read</td><td> Allows viewing network zone definitions (for example, IP ranges and locations) used in policies and access decisions</td></tr></tbody></table>

> Note: You will need TOKEN API and domain name that look like: [docontrolio.okta.com](http://docontrolio.okta.com)

Examples of Okta security checks and their required scopes include:

<table><thead><tr><th valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Incomplete onboarding for new identities</td><td valign="top">okta.users.read</td></tr><tr><td valign="top">Eliminate direct user app assignments</td><td valign="top">okta.apps.read</td></tr><tr><td valign="top">Admin console access requires MFA</td><td valign="top"><p>okta.groups.read</p><p>okta.policies.read</p></td></tr><tr><td valign="top">Dormant super admins deactivated</td><td valign="top">okta.roles.read</td></tr><tr><td valign="top">Event hooks registered for key events</td><td valign="top">okta.eventHooks.read</td></tr><tr><td valign="top">Network zones defined (IP/dynamic) and referenced by policies</td><td valign="top">okta.networkZones.read</td></tr></tbody></table>

### Zoom scopes

These scopes are required to monitor Zoom for misconfigurations:

<table><thead><tr><th width="223.953125" valign="top">Zoom scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">account:read:admin</td><td valign="top">View detailed information and settings for the entire Zoom account (such as account profile, features, and configuration) with admin-level read‑only access</td></tr></tbody></table>

> Note: The user needs to be the ORG ADMIN.

Examples of Zoom security checks and their required scopes include:

<table><thead><tr><th valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Ensure meeting passcode is set to have at least 1 number</td><td valign="top">account:read:admin</td></tr></tbody></table>

### Salesforce permission set

For the domain, the URL should look like: [`customization-ability-9963.my`](http://customization-ability-9963.my)

These permissions are required to monitor Salesforce for misconfigurations:

<table><thead><tr><th width="223.953125" valign="top">Salesforce scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">API Enabled</td><td valign="top">Allows access to Salesforce data and functionality using Application Programming Interfaces (APIs), including REST, SOAP, Bulk, and Metadata APIs</td></tr><tr><td valign="top">View Setup and Configuration</td><td valign="top">Allows users to view administrative settings, setup menus, and metadata without making changes. </td></tr><tr><td valign="top">View All Users</td><td valign="top">Allows a user to see all user records in the organization, regardless of the established organization-wide sharing defaults or sharing rules. </td></tr><tr><td valign="top">View Health Check</td><td valign="top">allows users to access and read the Security Health Check page, which evaluates org security settings against best practices.</td></tr></tbody></table>

### Jira scopes

These scopes are required to monitor Jira for misconfigurations:

<table><thead><tr><th width="223.953125" valign="top">Jira scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">read:jira-work</td><td valign="top">View Jira project and issue data (including issues, projects, attachments, and worklogs) that the authorized user has access to, without making any changes</td></tr></tbody></table>

Examples of Jira security checks and their required scopes include:

<table><thead><tr><th valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Stop public dashboards</td><td valign="top">read:jira-work</td></tr></tbody></table>

### Box scopes

These scopes are required to monitor Box for misconfigurations:

<table><thead><tr><th width="223.953125" valign="top">Box scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">manage_managed_users</td><td valign="top">Grants an application permission to manage enterprise managed users in Box, including changing their primary login, resetting passwords, and updating their roles</td></tr></tbody></table>

Examples of Box security checks and their required scopes include:

<table><thead><tr><th width="431.5703125" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Remove MFA exemptions for all users</td><td valign="top">manage_managed_users</td></tr></tbody></table>

### GitHub scopes

These scopes are required to monitor GitHub for misconfigurations:

<table><thead><tr><th width="223.953125" valign="top">GitHub scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">read:org</td><td valign="top">Grants read‑only access to an authenticated user’s organization data on GitHub, including org membership, org projects, and team membership details</td></tr></tbody></table>

Examples of GitHub security checks and their required scopes include:

<table><thead><tr><th width="441.796875" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Ensure strict base permissions are set for repositories</td><td valign="top">read:org</td></tr></tbody></table>

### Confluence scopes

These scopes are required to monitor Confluence for misconfigurations:

<table><thead><tr><th width="294.453125" valign="top">Confluence scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">read:space:confluence</td><td valign="top">View Confluence space details such as name, description, and metadata without modifying the space</td></tr><tr><td valign="top">read:confluence-groups</td><td valign="top">View Confluence user groups and their basic details for permission and membership lookup</td></tr><tr><td valign="top">read:space.permission:confluence</td><td valign="top">View the permission assignments and rules configured for a Confluence space without changing them</td></tr></tbody></table>

Examples of Confluence security checks and their required scopes include:

<table><thead><tr><th width="441.796875" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Keep maximum 5 space admins per space</td><td valign="top"><p>read:space:confluence</p><p>read:confluence-groups</p><p>read:space.permission:confluence</p></td></tr></tbody></table>

### Cursor scopes

These scopes are required to monitor **Cursor Teams or Enterprise** for misconfigurations:

<table><thead><tr><th width="294.453125" valign="top">Cursor scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">Admin API Key</td><td valign="top"><p></p><p>Provides programmatic access to administrative features, such as team management and monitoring, for all users within an organization. This feature is available on the <strong>Enterprise plan only.</strong></p><p><br>We use the key to access:</p><ul><li>Team Members</li><li>Audit Logs</li><li>Daily Usage Data</li><li>Spending Data (Spend)</li></ul></td></tr></tbody></table>

### Hubspot

These scopes are required to monitor HubSpot for misconfigurations:

<table><thead><tr><th width="294.453125" valign="top">HubSpot scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">files</td><td valign="top">Access the File Manager to upload, manage, and retrieve standard files stored in HubSpot</td></tr><tr><td valign="top">files.ui_hidden.read</td><td valign="top">View or download hidden/private user files, attachments, and system files from all HubSpot tools</td></tr><tr><td valign="top">cms.domains.read </td><td valign="top">View CMS domain settings and connected domains used for hosting HubSpot content</td></tr><tr><td valign="top">conversations.read</td><td valign="top">View conversation data such as inbox threads, messages, and associated metadata.</td></tr><tr><td valign="top">crm.objects.users.read </td><td valign="top">View CRM user records as objects, including their properties, for use in CRM associations and workflows.</td></tr><tr><td valign="top">settings.users.read</td><td valign="top">View HubSpot user settings and configuration details (for example, assigned permissions and preferences) without changing them</td></tr></tbody></table>

Examples of HubSpot security checks and their required scopes include:

<table><thead><tr><th width="441.796875" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Restrict public indexing of non-site files</td><td valign="top">files<br>files.ui_hidden.read</td></tr><tr><td valign="top">Require HTTPS only on all connected domains</td><td valign="top">cms.domains.read</td></tr><tr><td valign="top">Ensure every user has an assigned permission set</td><td valign="top">settings.users.read<br>crm.objects.users.read</td></tr></tbody></table>

### Google Workspace scopes

These scopes are required to monitor Google Workspace for misconfigurations:

<table><thead><tr><th width="294.453125" valign="top">Google Workspace scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">Super admin</td><td valign="top">Indicates the integration or operation must be authorized by a Google Workspace <strong>super admin</strong>, who has full access to all Admin console and Admin API capabilities</td></tr><tr><td valign="top">https://www.googleapis.com/auth/admin.directory.user.readonly </td><td valign="top">Grants read‑only access to users in your domain, including basic profile and organizational information, via the Admin Directory API</td></tr><tr><td valign="top">https://www.googleapis.com/auth/admin.directory.group.readonly </td><td valign="top">Grants read‑only access to groups in your domain, including group settings and memberships, via the Admin Directory API</td></tr><tr><td valign="top">https://www.googleapis.com/auth/cloud-identity.policies.readonly</td><td valign="top">Grants read‑only access to Cloud Identity policies (such as access levels and security settings) applied across your organization</td></tr></tbody></table>

Examples of Google Workspace security checks and their required scopes include:

<table><thead><tr><th width="404.42578125" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Ensure Super Admin account recovery is enabled </td><td valign="top"><p>https://www.googleapis.com/auth/admin.directory.user.readonly</p><p></p></td></tr><tr><td valign="top">Ensure login challenges are enforced</td><td valign="top"><p>https://www.googleapis.com/auth/cloud-identity.policies.readonly</p><p></p></td></tr><tr><td valign="top">Ensure creating groups is restricted </td><td valign="top">https://www.googleapis.com/auth/admin.directory.group.readonly</td></tr></tbody></table>

### Microsoft Teams scopes

These scopes are required to monitor Microsoft Teams for misconfigurations:

<table><thead><tr><th width="294.453125" valign="top">Teams scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">TeamworkAppSettings.Read.All</td><td valign="top">Allows an app to read organization-wide Microsoft Teams app settings (such as whether users can request app access), across the tenant with no write access</td></tr><tr><td valign="top">RoleManagement.Read.Directory</td><td valign="top">Allows an app to read directory role definitions and role assignments (who has which admin roles) in Microsoft Entra ID for the tenant</td></tr><tr><td valign="top">GroupSettings.Read.All </td><td valign="top">Allows an app to read all Microsoft 365 group settings (for example, creation rules, classification, and usage guidelines) across the organization</td></tr><tr><td valign="top">Policy.Read.All </td><td valign="top">Allows an app to read all directory and service policies (such as Teams, Exchange, and other Microsoft 365 policies) configured in the organization, without modifying them</td></tr></tbody></table>

### Microsoft Entra ID scopes

These scopes are required to monitor Microsoft Entra ID for misconfigurations:

<table><thead><tr><th width="294.453125" valign="top">Entra ID scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">Policy.Read.All </td><td valign="top"><p>Allows an app to read all directory policies in the tenant (for example, Conditional Access and other Entra ID policy objects) without modifying them</p><p></p></td></tr><tr><td valign="top">Application.Read.All</td><td valign="top">Allows an app to read all application registrations and service principals in the directory, including their properties and permissions</td></tr><tr><td valign="top">GroupSettings.Read.All </td><td valign="top">Allows an app to read all Microsoft 365 and Entra ID group settings across the directory, such as creation, classification, and usage policies</td></tr><tr><td valign="top">RoleManagement.Read.Directory </td><td valign="top">Allows an app to read directory role templates and role assignments, so it can see which admin roles exist and who is assigned to them</td></tr></tbody></table>

### Microsoft OneDrive scopes

These scopes are required to monitor Microsoft OneDrive for misconfigurations:

<table><thead><tr><th width="294.453125" valign="top">OneDrive scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">SharePointTenantSettings.Read.All </td><td valign="top">Allows an app read tenant-level configuration settings for SharePoint Online and OneDrive, such as sharing, storage, and compliance settings, without making changes</td></tr><tr><td valign="top">RoleManagement.Read.Directory</td><td valign="top">Allows an app read Entra ID directory role definitions and assignments, so it can see which admin roles exist and which users or service principals have them</td></tr></tbody></table>

Examples of OneDrive security checks and their required scopes include:

<table><thead><tr><th width="404.42578125" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Enforce domain allow-list for external sharing</td><td valign="top">SharePointTenantSettings.Read.All</td></tr><tr><td valign="top">Limit highly privileged access to least privilege</td><td valign="top">RoleManagement.Read.Directory</td></tr></tbody></table>

### Microsoft SharePoint scopes

These scopes are required to monitor Microsoft SharePoint for misconfigurations:

<table><thead><tr><th width="294.453125" valign="top">SharePoint scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">SharePointTenantSettings.Read.All </td><td valign="top">Allows an app to read tenant‑level SharePoint and OneDrive settings (such as sharing and access policies) without changing them</td></tr><tr><td valign="top">RoleManagement.Read.Directory</td><td valign="top">Allows an app to read directory role definitions and role assignments in Entra ID, so it can see which admin roles exist and who has them</td></tr></tbody></table>

Examples of SharePoint security checks and their required scopes include:

<table><thead><tr><th width="404.42578125" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Disable legacy authentication protocols</td><td valign="top">SharePointTenantSettings.Read.All</td></tr><tr><td valign="top">Ensure the number of Global Administrators is no more than five</td><td valign="top">RoleManagement.Read.Directory</td></tr></tbody></table>

### Zendesk scopes

These scopes are required to monitor Zendesk for misconfigurations:

<table><thead><tr><th width="240.5" valign="top">Zendesk scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">Read</td><td valign="top">Grants read‑only access to Zendesk resources (GET endpoints only), including permission to sideload related data but not create, update, or delete anything</td></tr></tbody></table>

### BambooHR scopes

These scopes are required to monitor BambooHR for misconfigurations:

<table><thead><tr><th width="240.5" valign="top">BambooHR scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">Token with admin privileges</td><td valign="top">Tthe API token was created by a user with full admin (or equivalent) access, so the token can view and edit all data and settings that this admin user can in the UI</td></tr></tbody></table>

### Dropbox scopes

These scopes are required to monitor Dropbox for misconfigurations:

<table><thead><tr><th width="294.453125" valign="top">Dropbox scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">members.read </td><td valign="top">Allows an app to list and read basic information about Dropbox Business team members, such as names, emails, and member IDs, without changing anything</td></tr><tr><td valign="top">team_info.read</td><td valign="top">Allows an app to read high‑level metadata about the Dropbox Business team, including team name, ID, and overall settings, in a read‑only way</td></tr><tr><td valign="top">sessions.list </td><td valign="top">Allows an app to list active sessions and devices for users on the team so you can review who is logged in and from where, without terminating sessions</td></tr><tr><td valign="top">team_data.content.read</td><td valign="top">Allows an app to read team‑owned content (files and folders) across members’ accounts on a Dropbox Business team, but not modify or delete it</td></tr></tbody></table>

Examples of Dropbox security checks and their required scopes include:

<table><thead><tr><th width="490.08984375" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Enforce Enterprise Mobility Management for device access</td><td valign="top">team_info.read</td></tr><tr><td valign="top">Limit highly privileged access to Access Control </td><td valign="top">members.read</td></tr><tr><td valign="top">Keep total active devices per user ≤ 5</td><td valign="top">sessions.list</td></tr><tr><td valign="top">Team folders not set to “not synced” by default </td><td valign="top">team_data.content.read</td></tr></tbody></table>

### Datadog scopes

These scopes are required to monitor Datadog for misconfigurations:

<table><thead><tr><th width="240.2265625" valign="top">Datadog scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top"><p>user_access_read</p><p></p><p></p></td><td valign="top">Allows viewing Datadog users, their roles, and access settings in the organization, without creating, changing, or deleting them</td></tr><tr><td valign="top">org_management</td><td valign="top">Allows viewing basic Datadog organization‑level details and which linked organizations can exchange or query data, without modifying org configuration</td></tr><tr><td valign="top">api_keys_read</td><td valign="top">Allows listing and reading Datadog API keys and application keys configured for the organization, without creating or revoking them</td></tr><tr><td valign="top">integrations_read</td><td valign="top">Allows viewing configured Datadog integrations and their settings so you can audit which external services are connected, without changing integration configs</td></tr></tbody></table>

Examples of Datadog security checks and their required scopes include:

<table><thead><tr><th width="490.08984375" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Limit highly privileged service accounts to no more than 3</td><td valign="top">user_access_read</td></tr><tr><td valign="top">Require all webhooks to use HTTPS and include a custom secret header</td><td valign="top">integrations_read</td></tr><tr><td valign="top">Enforce SAML strict mode and disable IdP-initiated login</td><td valign="top">org_management</td></tr><tr><td valign="top">Disable remote config read on API keys unless required</td><td valign="top">api_keys_read</td></tr></tbody></table>

### Deel HR scopes

These scopes are required to monitor Deel HR for misconfigurations:

<table><thead><tr><th width="240.2265625" valign="top">Deel HR scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">users:read </td><td valign="top">View people data in Deel HR (users’ core profiles and employment information) without creating or editing it</td></tr><tr><td valign="top">people:read </td><td valign="top">View detailed worker records via the People APIs (including filters over employees/contractors) in a read‑only way</td></tr></tbody></table>

Examples of Deel HR security checks and their required scopes include:

<table><thead><tr><th width="490.08984375" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Ensure personal email is not used as primary for active profiles</td><td valign="top">people:read</td></tr><tr><td valign="top">Ensure active users have a work email set for login</td><td valign="top">users:read</td></tr></tbody></table>

### Miro scopes

These scopes are required to monitor Miro for misconfigurations:

<table><thead><tr><th width="240.2265625" valign="top">Miro scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">organizations:teams:read </td><td valign="top">Read information about teams in a Miro organization, such as team lists, members, and team settings, without changing anything</td></tr><tr><td valign="top">organizations:read </td><td valign="top">Read high‑level organization information, including organization metadata and members, typically available only on Miro Enterprise plans</td></tr><tr><td valign="top">boards:read</td><td valign="top">Read board information and content metadata (e.g., basic board details and objects) without creating or editing boards</td></tr></tbody></table>

Examples of Miro security checks and their required scopes include:

<table><thead><tr><th width="490.08984375" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">No board should grant org/commenter default access</td><td valign="top">boards:read</td></tr><tr><td valign="top">Disable public link sharing for all teams</td><td valign="top">organizations:teams:read</td></tr><tr><td valign="top">Configure at least three org classification labels</td><td valign="top">organizations:read</td></tr></tbody></table>

### Bitbucket scopes

These scopes are required to monitor Bitbucket for misconfigurations:

<table><thead><tr><th width="240.2265625" valign="top">Bitbucket scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">account</td><td valign="top">Read access to the connected Bitbucket account, including account details, team memberships, and user settings. This scope allows DoControl to identify account-level misconfigurations across your Bitbucket environment.</td></tr><tr><td valign="top">repository</td><td valign="top">Read access to repositories within the connected Bitbucket workspace, including repository metadata, visibility settings, and membership. This scope allows DoControl to detect misconfigurations related to repository access and exposure.</td></tr><tr><td valign="top">repository:admin</td><td valign="top">Read access to repository administrative settings, including branch permissions, access keys, webhooks, and privileges. This scope allows DoControl to identify elevated permission misconfigurations and policy violations at the repository level.</td></tr></tbody></table>

Examples of Bitbucket security checks and their required scopes include:

<table><thead><tr><th width="490.08984375" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Detect Bitbucket workspace members who have not enabled two-step verification on their account</td><td valign="top">account</td></tr><tr><td valign="top">Detect Bitbucket repositories that are publicly accessible and exposed outside the organization</td><td valign="top">repository</td></tr><tr><td valign="top">Detect Bitbucket repositories with no branch permissions configured on the main or master branch</td><td valign="top">repository:admin</td></tr></tbody></table>

### Monday.com scopes

These scopes are required to monitor Monday.com for misconfigurations:

<table><thead><tr><th width="240.2265625" valign="top">Monday.com scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">me:read</td><td valign="top">Read access to the profile information of the authenticated user, including name, email, and account details. This scope allows DoControl to identify the connected user context within the Monday.com environment.</td></tr><tr><td valign="top">docs:read</td><td valign="top">Read access to Monday.com docs, including their content and sharing settings. This scope allows DoControl to detect misconfigurations related to document exposure and access permissions.</td></tr><tr><td valign="top">tags:read</td><td valign="top">Read access to tags applied across boards and items within the account. This scope allows DoControl to support classification and misconfiguration detection based on how content is labeled and organized.</td></tr><tr><td valign="top">teams:read</td><td valign="top">Read access to teams within the Monday.com account, including team membership and structure. This scope allows DoControl to identify misconfigurations related to team-level access and permission assignments.</td></tr><tr><td valign="top">users:read</td><td valign="top">Read access to user profiles and account membership across the organization. This scope allows DoControl to detect misconfigurations related to user provisioning, roles, and access levels.</td></tr><tr><td valign="top">assets:read</td><td valign="top">Read access to files and assets attached to Monday.com items and boards. This scope allows DoControl to identify exposed or improperly shared files within the environment.</td></tr><tr><td valign="top">boards:read</td><td valign="top">Read access to boards, their structure, columns, and items. This scope allows DoControl to detect misconfigurations related to board visibility and access controls.</td></tr><tr><td valign="top">accounts:read</td><td valign="top">Read access to account-level settings and configuration within Monday.com. This scope allows DoControl to monitor for organization-wide misconfigurations and policy gaps.</td></tr><tr><td valign="top">updates:read</td><td valign="top">Read access to updates and comments posted on Monday.com items. This scope allows DoControl to detect sensitive data exposure within item activity and communication threads.</td></tr><tr><td valign="top">webhooks:read</td><td valign="top">Read access to webhooks configured within the Monday.com account. This scope allows DoControl to identify unauthorized or misconfigured webhook connections that could expose data externally.</td></tr><tr><td valign="top">workspaces:read</td><td valign="top">Read access to workspaces and their settings, including membership and visibility. This scope allows DoControl to detect misconfigurations related to workspace access and organizational structure.</td></tr></tbody></table>

Examples of Monday.com security checks and their required scopes include:

<table><thead><tr><th width="490.08984375" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Detect Monday.com users who have not completed their profile setup, including missing email verification</td><td valign="top">me:read</td></tr><tr><td valign="top">Detect Monday.com docs that have been shared externally outside of the organization</td><td valign="top">docs:read</td></tr><tr><td valign="top">Detect Monday.com boards and items that have no classification tags applied</td><td valign="top">tags:read</td></tr><tr><td valign="top">Detect Monday.com teams that have no designated owner assigned</td><td valign="top">teams:read</td></tr><tr><td valign="top">Detect active Monday.com users who have not enabled two-factor authentication on their account</td><td valign="top">users:read</td></tr><tr><td valign="top">Detect assets attached to Monday.com items that are accessible via public or guest-shared links</td><td valign="top">assets:read</td></tr><tr><td valign="top">Detect Monday.com boards that are set to public visibility and accessible outside the organization</td><td valign="top">boards:read</td></tr><tr><td valign="top">Detect Monday.com accounts where guest access is enabled without restrictions at the account level</td><td valign="top">accounts:read</td></tr><tr><td valign="top">Detect Monday.com items containing updates or comments that include sensitive information shared with external guests</td><td valign="top">updates:read</td></tr><tr><td valign="top">Detect Monday.com webhooks configured to send data to external or unrecognized URLs</td><td valign="top">webhooks:read</td></tr><tr><td valign="top">Detect Monday.com workspaces that are open to all account members without restricted access controls</td><td valign="top">workspaces:read</td></tr><tr><td valign="top"></td><td valign="top"></td></tr></tbody></table>

### Anthropic scopes

These scopes are required to monitor Anthropic for misconfigurations:

<table><thead><tr><th width="240.2265625" valign="top">Anthropic scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">read:spend_limits</td><td valign="top">Read access to spend limit and budget configurations across the connected Anthropic organization and its workspaces. This scope allows DoControl to identify misconfigurations related to missing, excessive, or improperly scoped spend limits that could expose the organization to unexpected usage costs.</td></tr><tr><td valign="top">read:analytics</td><td valign="top">Read access to usage and analytics data for the connected Anthropic organization, including API consumption, token usage, and activity trends by user, workspace, and API key. This scope allows DoControl to detect anomalous usage patterns that may indicate compromised credentials or policy violations.</td></tr><tr><td valign="top">read:compliance_activities</td><td valign="top">Read access to audit and activity logs recording administrative and user actions within the connected Anthropic organization, such as API key creation, role changes, and workspace modifications. This scope allows DoControl to identify unauthorized or high-risk activities and gaps in security oversight.</td></tr><tr><td valign="top">read:compliance_user_data</td><td valign="top">Read access to user account details within the connected Anthropic organization, including roles, permissions, and account status. This scope allows DoControl to detect misconfigurations related to excessive user privileges, inactive accounts, and improper access assignments.</td></tr><tr><td valign="top">read:compliance_org_data</td><td valign="top">Read access to organization and workspace-level data for the connected Anthropic account, including workspace structure, membership, and organizational hierarchy. This scope allows DoControl to identify misconfigurations related to unauthorized workspace membership and improper organizational access.</td></tr><tr><td valign="top">read:compliance_org_settings</td><td valign="top">Read access to organization-wide security and compliance settings for the connected Anthropic account, such as authentication policies, API key management settings, and data retention configurations. This scope allows DoControl to detect misconfigurations related to weak security policies and non-compliant organizational settings.</td></tr></tbody></table>

Examples of Anthropic security checks and their required scopes include:

<table><thead><tr><th width="490.08984375" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Detect Anthropic workspaces or API keys with no spend limit configured</td><td valign="top">read:spend_limits</td></tr><tr><td valign="top">Detect anomalous spikes in API token usage that may indicate a compromised API key</td><td valign="top">read:analytics</td></tr><tr><td valign="top">Detect high-risk administrative actions (e.g., API key creation, permission escalation) that go unreviewed</td><td valign="top">read:compliance_activities</td></tr><tr><td valign="top">Detect Anthropic organization users with admin-level privileges who have been inactive for an extended period</td><td valign="top">read:compliance_user_data</td></tr><tr><td valign="top">Detect Anthropic workspaces with external or unauthorized members added</td><td valign="top">read:compliance_org_data</td></tr><tr><td valign="top">Detect Anthropic organizations without SSO or multi-factor authentication enforced</td><td valign="top">read:compliance_org_settings</td></tr></tbody></table>

### **Notion scopes**

Notion uses capabilities, not OAuth scopes, to control access:

| Notion capability                                    | Explanation                                                                                                                                                                                                                                                                                                                         |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Read content                                         | Read access to pages, databases, and blocks within the connected Notion workspace that have been shared with the integration. This capability allows DoControl to detect misconfigurations related to content sharing, page visibility, and workspace exposure (via `/v1/search`).                                                  |
| User information without email addresses             | Read access to user account information within the connected Notion workspace, such as name, user ID, and user type (person or bot), excluding email addresses. This capability allows DoControl to identify misconfigurations related to workspace membership and access without exposing personal contact data (via `/v1/users`). |
| User information with email addresses *(if enabled)* | Read access to the same user account information as above, including email addresses. This capability allows DoControl to additionally detect misconfigurations such as workspace members using unauthorized or personal email domains.                                                                                             |

Examples of Notion security checks and their required capabilities include:

| Security check example                                                                   | Required capability                      |
| ---------------------------------------------------------------------------------------- | ---------------------------------------- |
| Detect Notion pages or databases shared publicly or with guests outside the organization | Read content                             |
| Detect inactive or orphaned Notion users who still have workspace access                 | User information without email addresses |
| Detect Notion workspace members using personal or unauthorized email domains             | User information with email addresses    |

### **Figma scopes**

Figma is currently in Beta and uses API key authentication rather than OAuth scopes, so there isn't a granular scope table. DoControl validates the connection with a single call to confirm the key is valid and has read access:

| Check                       | Explanation                                                                                                                                                                                                                                                                                         |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API key validity (`/v1/me`) | Confirms the connected Figma API key is valid and active, and returns basic account information for the authenticated user. This check allows DoControl to verify the integration can authenticate before running misconfiguration checks; it does not grant scoped read access the way OAuth does. |

| Security check example                                                                            | Required access             |
| ------------------------------------------------------------------------------------------------- | --------------------------- |
| Detect a broken or revoked Figma API key that would stop misconfiguration monitoring from running | API key validity (`/v1/me`) |

### Microsoft Outlook scopes

<table><thead><tr><th width="240.2265625" valign="top">Outlook scope</th><th valign="top">Explanation</th></tr></thead><tbody><tr><td valign="top">MailboxSettings.Read</td><td valign="top">Read access to mailbox configuration settings across the connected Microsoft 365 organization, including inbox rules, automatic forwarding, and automatic-reply configurations. This scope allows DoControl to identify misconfigurations related to unauthorized or risky forwarding rules that could expose the organization to data exfiltration.</td></tr><tr><td valign="top">User.Read.All</td><td valign="top">Read access to user account details within the connected Microsoft 365 organization, including mailbox status, license assignment, and account state. This scope allows DoControl to detect misconfigurations related to inactive or disabled accounts that still retain active mailbox access.</td></tr><tr><td valign="top">Directory.Read.All</td><td valign="top">Read access to directory data for the connected organization, including distribution lists, mail-enabled groups, and directory role assignments. This scope allows DoControl to identify misconfigurations related to unauthorized external membership and improperly scoped group access.</td></tr><tr><td valign="top">Application.Read.All</td><td valign="top">Read access to registered applications and service principals within the connected organization, including the Microsoft Graph permissions granted to each. This scope allows DoControl to detect risky or unreviewed third-party applications that have been granted mail read or send access.</td></tr><tr><td valign="top">Auditlog.Read.All</td><td valign="top">Read access to directory and administrative audit logs recording actions within the connected organization, such as mailbox permission changes and admin role assignments. This scope allows DoControl to identify unauthorized or high-risk administrative activity and gaps in security oversight.</td></tr><tr><td valign="top">Policy.Read.All</td><td valign="top">Read access to directory and administrative audit logs recording actions within the connected organization, such as mailbox permission changes and admin role assignments. This scope allows DoControl to identify unauthorized or high-risk administrative activity and gaps in security oversight.</td></tr></tbody></table>

Examples of Outlook security checks and their required scopes include:

<table><thead><tr><th width="490.08984375" valign="top">Security check example</th><th valign="top">Required scopes</th></tr></thead><tbody><tr><td valign="top">Detect mailboxes with external auto-forwarding rules configured</td><td valign="top">MailboxSettings.Read</td></tr><tr><td valign="top">Detect inactive or disabled user accounts that still retain active mailbox access</td><td valign="top">User.Read.All</td></tr><tr><td valign="top">Detect distribution lists or mail-enabled groups with external or unauthorized members</td><td valign="top">Directory.Read.All</td></tr><tr><td valign="top">Detect third-party OAuth applications granted mail read or send permissions without admin review</td><td valign="top">Application.Read.All</td></tr><tr><td valign="top">Detect high-risk administrative actions (e.g., mailbox permission changes, admin role assignment) that go unreviewed</td><td valign="top">AuditLog.Read.All</td></tr><tr><td valign="top">Detect Microsoft 365 organizations without MFA or Conditional Access enforced for mail access</td><td valign="top">Policy.Read.All</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docontrol.io/docontrol-user-guide/risk-management/misconfigurations-premium/integrate-apps.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
