Focus

SaaS Security Administrator's Guide

Onboard an Envoy App to SSPM

Table of Contents

Onboard an Envoy App to SSPM

Connect an Envoy instance to SSPM to detect posture risks.

For SSPM to detect posture risks in your Envoy instance, you must onboard your Envoy instance to SSPM. Through the onboarding process, SSPM logs in to Envoy using administrator account credentials. SSPM uses this account to scan your Envoy instance for misconfigured settings. If there are misconfigured settings, SSPM suggests a remediation action based on best practices.

SSPM gets access to your Envoy instance by using Okta SSO credentials that you provide during the onboarding process. For this reason, your organization must be using Okta as an identity provider. The Okta account must be configured for multi-factor authentication (MFA) using one-time passcodes.

To onboard your Envoy instance, you complete the following actions:

Collect Information for Accessing Your Envoy Instance

Connect SSPM to Your Envoy Instance

Collect Information for Accessing Your Envoy Instance

To access your Envoy instance, SSPM requires the following information, which you will specify during the onboarding process.

Item	Description
Username	An email address of an Okta user account. `Required Permissions:` The user must be assigned to the Global Admin role in Envoy.
Password	The password for the Okta user account.
Okta Subdomain	The Okta subdomain for your organization. The subdomain was included in the login URL that Okta assigned to your organization.
MFA Secret Key	A key that is used to generate one-time passcodes for multi-factor authentication.

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 Envoy instance from SSPM.

Identify the Okta user account that SSPM will use to access your Envoy instance. The user account must be assigned to the Global Admin role in Envoy. SSPM needs this administrator access to monitor your Envoy instance.

Remember which account you will use to access your Envoy instance through Okta SSO authentication from SSPM. You will provide the login credentials to SSPM during the onboarding process.

To access the administrator account using Okta credentials:

Identify your Okta subdomain.

Generate and copy an MFA secret key.