Onboard a Microsoft OneDrive App for Scans That Use Data Extraction
Table of Contents
Onboard a Microsoft OneDrive App for Scans That Use Data Extraction
Connect a Microsoft OneDrive instance to SSPM to detect posture risks.
High-level configuration scanning across Office 365 products is available by onboarding the Office 365 app. Adding the Microsoft OneDrive app
individually gives you greater visibility into Microsoft OneDrive settings.
For SSPM to detect posture risks in your Microsoft OneDrive instance with more detail
than the Office 365 app scan, you must onboard your Microsoft OneDrive instance to
SSPM. Through the onboarding process, SSPM logs in to a Microsoft administrator
account. SSPM uses this account to scan your Microsoft OneDrive instance for
misconfigured settings. If there are misconfigured settings, SSPM suggests a
remediation action based on best practices.
There are two ways in which SSPM can scan your Microsoft OneDrive instance. The
following instructions describe how to enable SSPM to use data extraction techniques
(also known as web scraping) to perform its configuration scans. You can follow
alternative instructions that enable SSPM to use the Microsoft Graph
API to perform its configuration scans.
During the onboarding process, you will supply Microsoft OneDrive account credentials
to SSPM. SSPM can access the account directly or through the Okta or Microsoft Azure
identity providers. Having SSPM access the account through one of these identity
providers requires MFA, which adds an extra layer of security.
To onboard your Microsoft OneDrive instance, you complete the following actions:
Collect Information for Connecting to Your Microsoft OneDrive Instance
To access your Microsoft OneDrive instance, SSPM requires the following
information, which you will specify during the onboarding process.
| Item | Description |
|---|---|
| User | The username or email address of the
administrator account. The format that you use can depend on
whether SSPM will be logging in directly to your account or
through an identity provider. Required Permissions:
The user must be assigned to the Microsoft Global Admin
role. |
| Password | The password for the administrator account. |
If you are using Okta as your identity provider, you must provide SSPM with the
following additional information:
| Item | Description |
|---|---|
| Okta subdomain | The Okta subdomain for your organization. The subdomain was included in the login URL that Okta assigned to your organization. |
| Okta 2FA secret | A key that is used to generate one-time passcodes for MFA. |
If you are using Azure Active Directory (AD) as your identity provider, you must
provide SSPM with the following additional information:
| Item | Description |
|---|---|
| Azure 2FA secret | A key that is used to generate one-time passcodes for MFA. |
As you complete the following steps, make note of the values of the items
described in the preceding tables. You will need to enter these values during
onboarding to access your Microsoft OneDrive instance from SSPM.
- Identify the Microsoft administrator account that SSPM will use to access your Microsoft OneDrive instance. The administrator must be assigned to the Microsoft Global Admin role.Determine whether you want SSPM to log in to the administrator account directly, or through an identity provider.Using an identity provider adds an extra layer of security by requiring MFA using one-time passcodes. You can use Okta or Microsoft Azure as the identity provider for accessing the administrator account. However, if you use an identity provider, SSPM requires more information for MFA.
- (For Okta log in) To access the administrator account through Okta:
- (For Microsoft Azure log in) To access the administrator account through Microsoft Azure:
Connect SSPM to Your Microsoft OneDrive Instance
By adding a Microsoft OneDrive app in SSPM, you enable SSPM to connect to your Microsoft OneDrive instance.- From the Add Application page ( ), click the Microsoft OneDrive tile.Under posture security instances, Add Instance or, if there is already an instance configured, Add New instance.Specify how you want SSPM to connect to your Microsoft OneDrive instance. SSPM can Log in with Credentials, Log in with Okta, or Log in with Azure.When prompted, provide SSPM with the administrator credentials. If SSPM is connecting to the account through an identity provider, specify the information that SSPM needs for MFA.Connect.
