# OKTA

Infraon–Okta Integration enables secure authentication and centralized user management by integrating Okta with Infraon. It allows organizations to synchronize **users, manage roles, and enable Single Sign-On (SSO)** for both Infraon users and Self-Service Portal (SSP) requesters.

Using this integration, administrators can configure Okta credentials, synchronize user data, and ensure consistent user access control across the platform.

You can:

* Configure Okta integration from the Marketplace
* Enable SSO login for Infraon and SSP users
* Synchronize users, roles, and attributes from Okta
* Manage user lifecycle (activation/deactivation)
* Schedule and monitor user synchronization
* Export unsynced users for troubleshooting

## **How To Install**

**Step 1:** Go to the **Marketplace** tab on the left navigation panel to begin the integration. Click on the **Okta** card from the available integrations to open the plugin details page.

![](https://content.gitbook.com/content/E4mkwSP8a1BSD9BFNFav/blobs/PBbg00UZP198BZvNNHPK/Unknown%20image)

**Step 2:** On the plugin page, click the **Install** button to add the Okta integration to your Infraon environment.

Once installed, the configuration page will become available for setup.

![](https://content.gitbook.com/content/E4mkwSP8a1BSD9BFNFav/blobs/tpNTKftItppgvR5RHuuH/Unknown%20image)

**Step 3:** Enter the Okta connection details so Infraon Infinity can communicate with your Tenable instance.

![](https://content.gitbook.com/content/E4mkwSP8a1BSD9BFNFav/blobs/4KlGCN155RSOJulEy0xI/Unknown%20image)

**Configuration |** Basic Details

<table><thead><tr><th width="157.79998779296875">Label</th><th width="129.4000244140625">Action</th><th>Description / Example</th></tr></thead><tbody><tr><td><strong>Config Name</strong></td><td>Enter value</td><td>Specify a name for the Okta configuration. This is used to identify the integration setup within Infraon, especially when managing multiple configurations.<br><br><strong>Example:</strong> Okta-SSO-Production</td></tr><tr><td><strong>Okta Domain URL</strong></td><td>Enter value</td><td>Enter the Okta organization domain used for integration. This value is used to establish a connection with Okta APIs for authentication and user synchronization.<br><br><strong>Example:</strong> your-org.okta.com</td></tr><tr><td><strong>API Token</strong></td><td>Enter value</td><td>Enter the API token generated from Okta. This token is required to authenticate API requests and fetch user data (users, groups, attributes) from Okta into Infraon.<br><br><strong>Example:</strong> Token generated from Okta Admin Console → Security → API → Tokens</td></tr><tr><td><strong>Sync</strong></td><td>Select from the dropdown</td><td><p>Select the user types to be synchronized from Okta into Infraon.<br><strong>Options:</strong><br></p><ul><li><strong>Users:</strong> Syncs internal users such as technicians and admins into Infraon.</li><li><strong>Requesters:</strong> Syncs end users who raise requests via the Self-Service Portal (SSP).</li></ul><p><strong>Example:</strong> Select Users to sync technician accounts, or select Requesters to sync SSP users.</p></td></tr><tr><td><strong>Verify</strong></td><td>Click to validate configuration</td><td>Validates the provided Okta Domain and API Token by establishing a connection with Okta. If successful, the configuration can proceed to installation. If validation fails, appropriate error messages are displayed, and installation is blocked.</td></tr></tbody></table>

**Step 4:** Once the Okta configuration is successfully added and verified, navigate to the **Settings** section to perform additional configuration and manage synchronization operations.

**Configure Settings |** Basic Details

<table><thead><tr><th width="156.20001220703125">Label</th><th width="159.79998779296875">Action</th><th>Description / Example</th></tr></thead><tbody><tr><td><strong>Sync Data</strong></td><td>Click Sync Now</td><td>Initiates an immediate synchronization between Okta and Infraon. This process fetches user data (profiles, attributes, and group memberships) and updates Infraon with the latest information from Okta.<br><br>Click Sync Now after initial setup to import all users from Okta into Infraon.</td></tr><tr><td><strong>Okta – Infraon Configuration</strong></td><td>Click Configuration</td><td>Opens the configuration settings to manage field mappings between Okta and Infraon.<br><br>This ensures that user attributes such as name, email, and roles are accurately synchronized.</td></tr><tr><td><strong>Schedule Sync</strong></td><td>Click Schedule</td><td>Allows you to configure automated synchronization at defined intervals. This helps keep user data up to date without manual intervention.<br><br><strong>Example:</strong> Schedule a daily sync at 02:00 AM to automatically update user changes from Okta.</td></tr><tr><td><strong>Export Unsynced Data</strong></td><td>Click Export</td><td>Downloads a CSV file containing records that failed to sync due to errors such as invalid configurations or missing data.<br><br><strong>Example:</strong> Export unsynced users to review missing attributes or failed mappings.</td></tr></tbody></table>

![](https://content.gitbook.com/content/E4mkwSP8a1BSD9BFNFav/blobs/eTA3Qd8yEnk2MEtEQMFO/Unknown%20image)