Login
    Contents x
    Okta - Delete Role
    • 13 Mar 2024
    • 4 Minutes to read
    • Print
    • Dark
      Light
    • PDF
    Contents

    Okta - Delete Role

    • Updated on 13 Mar 2024
    • 4 Minutes to read
    • Print
    • Dark
      Light
    • PDF
    Article Summary

    Okta - Delete Role deletes roles in Okta for assets retrieved from the saved query supplied as a trigger (or users selected in the asset table).

    See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.

    General Settings

    • Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonius. You can change the name according to your needs.
    • Add description - Click to add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
    • Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
    • Action name (required) - The name of the Main action. A default value is added by Axonius. You can change the name according to your needs.
    • Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.

    • Use stored credentials from the Okta Adapter - Select this option to use the first connected Okta adapter credentials.
    Note:

    To use this option, you must successfully configure an Okta adapter connection.

    Required Fields

    These fields must be configured to run the Enforcement Set.

    Additional Fields

    These fields are optional.

    Connection Parameters

    When Use stored credentials from the Okta adapter is toggled Off, these fields are required:

    • Okta URL - The hostname or IP address of the Okta server. This field format is '[instance].okta.com'.

    • Authentication - The type of authentication to use.

    • Okta API Key (Access via API Token) - An API key, created in the admin panel. For details, see Creating an API Token in Okta.

    • Okta Client ID (Access via OAuth2) - Client ID of the service app. This is required when OAuth2 is selected in the Authentication drop-down.

    • Okta JWK Private/Public Keys - The JSON web key which was generated and assigned in the OAuth 2.0 service app integration in the Admin Console of Okta. This is required when OAuth2 is selected in the Authentication drop-down.

    • Throttling rate percentage (default: 10) - Specify the threshold percentage of the Okta API rate limit when connecting to the value supplied in Okta URL. Axonius will stop the data fetch when the API rate limit reaches the supplied value.

    • Number of parallel requests (default: 75) - Specify the maximum parallel requests that will be created when connecting to the value supplied in Okta URL.

    • Admin URL - The hostname or IP address of the Okta admin server. This field format is '[instance]-admin.okta.com'.

    • Admin Username - The value you enter in the User Name field in Okta for the new user you created to allow Axonius to fetch SaaS Management data.

    • Admin Password - The password you set for the new user in Okta.

    • 2FA Secret Key - The secret generated in Okta for setting up 2-factor authentication for the Okta user created for collecting SaaS Management data.

    • SSO Provider - If your organization uses Okta for SSO, you can set this select this check box (selected by default). For more information, see Connecting your SSO Solution Provider Adapter.

    • Department Field (default: department) - This is the mapping of the department value for the Okta authentication object. Check if your organization's 'department' value is different from the default value ('department').

    • User Filter Params - You can use the Okta Expression language to filter a subset of users (for example, users who belong to specific departments) to be retrieved by the Okta adapter and displayed in Axonius.

    • Filters users by group name - Enter a group name to only fetch users from the specific group. Refer to Configuring a Group in Okta for details.

    • Add users inside the devices - Select this option to fetch the devices with the users.

    • HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.

    • Gateway Name - Select the gateway through which to connect to perform the action.

    APIs

    Axonius uses the Core Okta API.

    Permissions

    The value supplied in Okta API Key must have write or admin permissions.

    Required Ports

    Axonius must be able to communicate with the value supplied in Connection Settings via the following ports:

    • TCP port 443
    • TCP port 80

    Version Matrix

    This adapter has only been tested with the versions marked as supported, but may work with other versions. Please contact Axonius Support if you have a version that is not listed and it is not functioning as expected.

    VersionSupportedNotes
    Okta 4.5Yes

    For more details about other Enforcement Actions available, see Action Library.

    Was this article helpful?
    What's Next
    Change password!
    Changing your password will log you out immediately. Use the new password to log back in.
    Change profile
    Success!
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.
    Logout