: Onboard a Microsoft SharePoint App to SSPM
Focus
Focus

Onboard a Microsoft SharePoint App to SSPM

Table of Contents

Onboard a Microsoft SharePoint App to SSPM

Connect a Microsoft SharePoint 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 SharePoint app individually gives you greater visibility into Microsoft SharePoint settings.
For SSPM to detect posture risks in your Microsoft SharePoint instance with more detail than the Office 365 app scan, you must onboard your Microsoft SharePoint instance to SSPM. Through the onboarding process, SSPM connects to a Microsoft API and, through the API, scans your Microsoft SharePoint instance for misconfigured settings. If there are misconfigured settings, SSPM suggests a remediation action based on best practices.
To onboard your Microsoft SharePoint instance, you complete the following actions:

Collect Information for Connecting to Your Microsoft SharePoint Instance

To access your Microsoft SharePoint instance, SSPM requires the following information, which you will specify during the onboarding process.
Item
Description
Username
The login email address for a Microsoft account. The account must not require multi-factor authentication (MFA).
Required Permissions
: The user must be assigned to one of the following roles.
  • SharePoint Administrator
  • Global Administrator
Password
The password for the Microsoft account.
Client ID
SSPM will access a Microsoft API through an Azure AD application that you create. During the onboarding process, SSPM prompts you for a Client ID that uniquely identifies the application.
As you complete the following steps, make note of the values of the items described in the preceding table. You will need to enter these values during onboarding to access your Microsoft SharePoint instance from SSPM.
  1. Identify the Microsoft account that SSPM will use to access your Microsoft SharePoint instance.
    Account requirements:
    • The account must have SharePoint Administrator or Global Administrator permissions.
    • The account must not require MFA.
    After SSPM establishes the connection, it will perform an initial scan of your Microsoft SharePoint instance, and will then run scans at regular intervals of approximately 30 minutes. For SSPM to run these scans, the administrator account that you use to establish the initial connection must remain available. For this reason, we recommend that you use a dedicated service account to grant SSPM access. If you delete the service account, or update the account password, the scans will fail and you will need to onboard Microsoft SharePoint again.
  2. During onboarding, SSPM will access a Microsoft API through an Azure AD client application that you create. Follow the instructions to register an Azure AD client application, and note the Client ID that Azure AD generates for the client app.
    If you have already onboarded another Microsoft application that requires an Azure AD client application, you can use that same Azure AD client app to onboard Microsoft SharePoint. If necessary, ask the administrator who registered the Azure AD client app for its Client ID.
    Do not continue to the next step unless you have obtained the Client ID. You will provide this information to SSPM during the onboarding process.

Enable Required Enterprise Applications

To complete its scans, SSPM also requires the Microsoft Graph Command Line Tools and the PnP Management Shell enterprise applications.
  1. As a Global Administrator, log in to the the Azure portal and navigate to the Enterprise applications page. To quickly navigate to this page, enter
    Enterprise applications
    in the search field at the top of the page.
  2. Enable Microsoft Graph Command Line Tools and PnP Management Shell for user sign in. Complete the following steps for both of these enterprise applications.
    1. On the Enterprise applications page, use the search box to quickly locate the Microsoft Graph Command Line Tools or PnP Management Shell application.
    2. Click the application name and, from the left navigation pane, navigate to its
      Properties
      .
    3. Set the
      Enabled for users to sign-in
      property to
      Yes
      .
    4. Save
      your changes.
    5. Make sure you have completed the preceding steps for both Microsoft Graph Command Line Tools and PnP Management Shell.

Connect SSPM to Your Microsoft SharePoint Instance

By adding a Microsoft SharePoint app in SSPM, you enable SSPM to connect to your Microsoft SharePoint instance.
  1. From the Add Application page (
    Posture Security
    Applications
    Add Application
    ), click the Microsoft SharePoint tile.
  2. Under posture security instances,
    Add Instance
    or, if there is already an instance configured,
    Add New
    instance.
  3. Log in with Credentials
    .
  4. When prompted, provide SSPM with the Microsoft user credentials and the Client ID of the Azure AD application.
  5. Connect
    .

Recommended For You