- 19 Apr 2023
- 4 Minutes to read
- Print
- DarkLight
- PDF
Okta
- Updated on 19 Apr 2023
- 4 Minutes to read
- Print
- DarkLight
- PDF
Okta provides cloud software that helps companies manage their employees' passwords, by providing a “single sign-on” experience.
Related Enforcement Actions:
Types of Assets Fetched
This adapter fetches the following types of assets:
- Devices
- Users
Parameters
Okta URL (required) - The hostname or IP address of the Okta server. This field format is '[instance].okta.com'.
Okta API Key (required) - An API key, created in the admin panel. For details, see Creating an API Token in Okta.
Number of parallel requests (required, default: 75) - Specify the maximum parallel requests that will be created when connecting to the value supplied in Okta URL.
API rate limit threshold percentage (required, 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 will reach to the supplied value.
Filters users by group name - Use this option to only fetch users from a specific group. In order to use this feature a group with users must be configured in Okta. 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 (optional) - A proxy to use when connecting to the value supplied in Okta URL.
7.To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.
Advanced Settings
Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection, refer to Advanced Configuration for Adapters.
- Email domaininclude list (optional) - specify a comma-separated list of email domains to only fetch users whose email domain is in the specified list.
- Fetch users apps (required, default: True)
- If enabled, all connections of this adapter will also fetch information on users application.
- If disabled, all connections of this adapter will not fetch information on users application.
- Fetch users groups (required, default: True) - Select whether to fetch users groups.
- If enabled, all connections of this adapter will also fetch users groups details.
- If disabled, all connections of this adapter will not fetch users groups details.
- Fetch users authentication factors
- If enabled, all connections of this adapter will also fetch users authentication factors.
- If disabled, all connections of this adapter will not fetch users authentication factors.
- Time in seconds to sleep between each request (optional) - Specify sleeping time in seconds between each API request Axonius sends to Okta.
- If supplied, all connections for this adapter will use the specified time between API requests Axonius sends to this adapter.
- If not supplied, all connections for this adapter will have no sleep time between API requests Axonius sends to this adapter.
- Fetch logs (required, default: True) - Select whether to fetch information about user's log events, that include details such as: IP address, browser, OS type.
- If enabled, all connections of this adapter will also fetch information on users' log events.
- If disabled, all connections of this adapter will not fetch information on users log events.
- Fetch logs from the last X days - Enter a number of days back from which to fetch logs.
- Fetch admin roles - Select whether to fetch additional information on admin roles.
- If enabled, all connections of this adapter will also fetch additional information on admin roles.
- If disabled, all connections of this adapter will only fetch users with admin roles, without additional information about those roles.
- Fetch deprovisioned users - Select whether to fetch users that are deprovisioned.
- Display recovery question in View Advanced - Select whether to save the users' recovery questions in the Axonius database.
- When you enable this parameter, the recovery question is displayed in plain-text in the View Advanced data for the Okta Adapter.
- User results limit (required, default: 100) - Specify the number of results per page when Axonius makes the API call. The maximum value is 200.
- Only fetch user records (optional) - Select whether to only fetch user records from Okta.
For details on general advanced settings under the Adapter Configuration tab, see Adapter Advanced Settings.
Creating an API Token in Okta
To create an API key
- Go to Security and select API.
.
2. Then select Tokens.
Select Create Token and select a token with Okta API type.
On the pop-up, type a new name for the token and click Create Token.
Copy the token value and save it to a secure location (you will need it later when configuring the adapter).
Configuring a Group in Okta
To use Filters users by group name, you need to create a group in Okta.
To create a group in Okta:
- Go to the Okta admin panel
- From Directory choose Groups
- Select Add Group
Give a name to the group and if you want, add a description
Select the Rules tab and choose Add Rule
On that rule add the user email, contains, and add the domain
- On the rules list, from Actions, select Activate to activate the rule.
The group must include users with that domain. This group can now be used as a filter to fetch users for Axonius. Use this group name in the Group name to filter users setting.
Permissions
Read Only Admin permissions are required to use this adapter.
If you need to use the "Fetch Admin Roles", then this requires configuring credentials to have Super Admin access to view the other admin roles.
For more information, see Standard Administrator Roles and Permissions.
Additional permissions are required for Okta Enforcement Actions. Refer to Okta Action Permissions.