Onboard a Box App to SSPM
Table of Contents
Onboard a Box App to SSPM
Connect a Box instance to SSPM to detect posture risks.
For SSPM to detect posture risks in your Box instance, you must onboard your Box
instance to SSPM. Through the onboarding process, SSPM logs in to Box using
administrator account credentials. SSPM uses this account to scan your Box instance
for misconfigured settings. If there are misconfigured settings, SSPM suggests a
remediation action based on best practices.
During the onboarding process, you will supply Box account credentials to SSPM. SSPM
can access the account directly or through the Okta identity provider. Having SSPM
access the account through Okta requires MFA, which adds an extra layer of security.
To onboard your Box instance, you complete the following actions:
Collect Information for Connecting to Your Box Instance
To access your Box instance, SSPM requires the following information, which you will specify
during the onboarding process.
| Item | Description |
|---|---|
| Username | The username of the administrator
account. (Required Permissions) The user must
be a Box administrator. At a minimum, the user must be a
Co-Admin with permission to "View settings and apps for your
company". |
| Password | The password for the administrator account. |
If you are logging in through Okta, 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. |
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 Box instance from SSPM.
- Identify the administrator account that SSPM will use to access your Box instance. The user account must have administrator privileges in Box. At a minimum, the user must be a Co-Admin with permission to "View settings and apps for your company". SSPM needs this access to monitor your Box instance.
Connect SSPM to Your Box Instance
By adding a Box app in SSPM, you enable SSPM to connect to your Box instance.- From the Add Application page ( ), click the Box 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 Box instance. SSPM can Log in with Credentials or Log in with Okta.When prompted, provide SSPM with the administrator credentials. If SSPM is connecting to the account through Okta, specify the information that SSPM needs for MFA.Connect.
