: Onboard an Aha.io App to SSPM
Focus
Focus

Onboard an Aha.io App to SSPM

Table of Contents

Onboard an Aha.io App to SSPM

Connect an Aha.io instance to SSPM to detect posture risks.
For SSPM to detect posture risks in your Aha.io instance, you must onboard your Aha.io instance to SSPM. Through the onboarding process, SSPM logs in to Aha.io using administrator account credentials. SSPM uses this account to scan your Aha.io instance for misconfigured settings. If there are misconfigured settings, SSPM suggests a remediation action based on best practices.
SSPM gets access to your Aha.io 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 Aha.io instance, you complete the following actions:

Collect Information for Accessing Your Aha.io Instance

To access your Aha.io instance, SSPM requires the following information, which you will specify during the onboarding process.
Item
Description
User
An email address of an Okta user account.
Required Permissions:
The user account must be assigned to both the Account and Billing administrator roles in Aha.io.
Password
The password for the Okta user account.
Okta Domain
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.
Instance Host
The custom domain for accessing your organization's Aha.io account. You specify this domain when you sign up for an Aha.io account, and it is included as part of the URL that you use to access the account.
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 Aha.io instance from SSPM.
  1. Identify the Okta user account that SSPM will use to access your Aha.io instance. The user account must be assigned to both the Account and Billing administrator roles in Aha.io.
    Remember which account you will use to access your Aha.io instance through Okta SSO authentication from SSPM. You will provide the login credentials to SSPM during the onboarding process.
  2. Make note of your organization's Aha.io instance host name.
    After you log in to Aha.io, the instance host name is a unique subdomain included in the Aha.io URL. The URL format is
    <instance_host>
    .aha.io.

Connect SSPM to Your Aha.io Instance

By adding an Aha.io app in SSPM, you enable SSPM to connect to your Aha.io instance.
  1. From the Add Application page (
    Posture Security
    Applications
    Add Application
    ), click the Aha.io tile.
  2. Under posture security instances,
    Add Instance
    or, if there is already an instance configured,
    Add New
    instance.
  3. Choose the option to
    Log in with Credentials
    .
  4. Enter the user credentials, Okta domain, MFA secret key, and instance host name for accessing your Aha.io instance.
  5. Connect
    .

Recommended For You