# Extension + Okta Integration Guide

### What You'll Need to do

There are two main steps you’ll need to follow to complete the deployment. Total time is usually under 30 minutes.

* Download the On-Prem MFA Agent from the Okta administrative dashboard.
* Install the On-Prem MFA Agent. Configure the agent with the values provided by your Twosense account manager.

***

### Prerequisites

* An Okta Org. If you don't already have one, you can get a free account at <https://developer.okta.com/>
* An account or active trial with Twosense. Please contact us [here](https://www.twosense.ai/demo) to obtain a 30-day trial if you don’t have one already.
* You will need an Okta account with organization level privileges to install the Okta On-Prem MFA Agent.
* Provide your Twosense account manager the IP address of the server that will be running the Okta On-Prem MFA Agent.
* The **Radius host**, **port**, and **shared secret** provided by your Twosense account manager.

***

### Step-by-step

1. Log in to your Okta instance with an administrator account.
2. Navigate to **Security** → **Multifactor**, then select **On-Prem MFA** in the navigation menu.
3. Click **Add New Agent**.
4. Use the **Download the agent** link provided in this window to download the On-Prem MFA agent. Make note of the Instance ID provided to you. It will be used during the installation.
5. Run the downloaded agent on your Microsoft Windows server. You may need to adjust IE security settings to allow interaction with the Okta website during this process. Follow the step-by-step installation until it is completed.
6. Once the installation is complete, you should edit the **On-Prem Multifactor Authentication Settings** within the same page where you downloaded the agent. The following settings will need to be configured:
   * Provider username format: Okta username
   * Hostname: Provided by your Twosense account manager
   * Authentication Port: Provided by your Twosense account manager
   * Shared Secret: Provided by your Twosense account manager


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.twosense.ai/browser-extension-sdk/browser-extension/okta-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
