> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pads4.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Okta

<Warning>
  This article requires you to have at least PADS4 version 2025.2.
</Warning>

PADS4 allows integration with **Okta** to streamline **user authentication and management**. This is accomplished through the **Credentials** interface in **PADS4 CTRL Center**.

Follow the steps below to connect your Okta instance:

## **1. Accessing the PADS4 CTRL Center**

To begin:

* Open your **web browser**.
* Navigate to the **PADS4 server URL** (either a DNS name or IP address).
* Log in using an **Administrator account**.

Once logged in:

* Click on **Home**.
* Use the **Toggle Sidebar** button at the **top-left** of the screen.
* Navigate to **Credentials**.
* Then select **Providers**.

## **2. Create the Okta application**

To configure an Okta identity provider, you will need to connect to Okta as an Administrator and create a new okta app integration.

* On Okta, go to Applications page
* Click on “Create App Integration”

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/Okta-app1.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=b932d16d02bf3b64b5584d1de6fd6441" alt="Okta App1" width="752" height="388" data-path="images/ctrl-centre/administration/credentials/Okta-app1.png" />

* Select “SAML 2.0” sign-in method and click “Next”

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/Okta-app2.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=b422e9159431da9ca8d550e090cde6cc" alt="Okta App2" width="918" height="504" data-path="images/ctrl-centre/administration/credentials/Okta-app2.png" />

* Fill in the information requested in the from and click "Next"

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/Okta-app3.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=90b8c177180d2681f40e56ba81e6d9a0" alt="Okta App3" width="716" height="366" data-path="images/ctrl-centre/administration/credentials/Okta-app3.png" />

For example:

* Name: PADS4

## **3. Setup SAML 2.0 configuration**

* Edit the SAML Settings configuration

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/Okta-app4.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=2c4daa016249952ccc1b3d01f81c3a82" alt="Okta App4" width="740" height="600" data-path="images/ctrl-centre/administration/credentials/Okta-app4.png" />

<Note>
  Make sure the values "Single sign-on URL" and "Audience URI (SP Entity ID)" have the structure as described below or the configuration will not work.
</Note>

* Single sign-on URL:
  * local pads4 url with **/rdx/**[**nds.services**](http://nds.services)**.authentication.integration/api/v1/pads/Saml2/Acs**
  * For example: [https://pads4.mycompany.com/rdx/nds.services.authentication.integration/api/v1/pads/Saml2/Acs](https://pads4.mycompany.com/rdx/nds.services.authentication.integration/api/v1/pads/Saml2/Acs)
* Audience URI (SP Entity ID):
  * local pads4 url with **/saml** 
  * For example: [https://pads4.mycompany.com/saml](https://pads4.mycompany.com/saml)

<Warning>
  If the domain of your pads4 instance is different than “pads”, you must update the domain with your own domain name. (e.g : for a domain named “domaineone”, the url will be [https://pads4.mycompany.com/rdx/nds.services.authentication.integration/api/v1/domainone/Saml2/Acs](https://pads4.mycompany.com/rdx/nds.services.authentication.integration/api/v1/domainone/Saml2/Acs)

  Your configured domain name can be verified by logging in with your su\root account and go to the "Domains" section:

  <img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/Domain-config.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=aa3c47e7ec4a59408c1bf89d8e4be43c" alt="Domain Config" width="1808" height="413" data-path="images/ctrl-centre/administration/credentials/Domain-config.png" />
</Warning>

## **4. Attributes & claims**

* Edit the attributes and claims to match the values below

| Name                                                                                                                                     | Name format | Value          |
| ---------------------------------------------------------------------------------------------------------------------------------------- | ----------- | -------------- |
| [http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress](http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress) | Unspecified | user.email     |
| [http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname](http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname)       | Unspecified | user.firstName |
| [http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname](http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname)           | Unspecified | user.lastName  |

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/Okta-app5.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=bd0361c3602d68b6f09ea3a964c11238" alt="Okta App5" width="1017" height="527" data-path="images/ctrl-centre/administration/credentials/Okta-app5.png" />

* For the group attribute, please follow the configuration below and ensure the filter is set on the **"Matches regex"** option.

| Name                                                                               | Name format | Filter        | Value |
| ---------------------------------------------------------------------------------- | ----------- | ------------- | ----- |
| [http://schemas.xmlsoap.org/claims/group](http://schemas.xmlsoap.org/claims/group) | Unspecified | Matches regex | (\*?) |

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/Okta-app6.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=5e779e7f1a7cd3225d32047a9b9e2a00" alt="Okta App6" width="974" height="334" data-path="images/ctrl-centre/administration/credentials/Okta-app6.png" />

* Click on the "Next" button
* Then click on the "Finish" button to create the app integration

## **5. Assign user groups to the application**

To define which user groups will have access to the application, you will need to assign the expected user groups to the application.

* On the application you just created, on the top menu, click on the "Assignments" item
* Click on the "Assign" button and then click on "Assign to groups"

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/Okta-app7.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=0f34285fa3ded77066f8ea31f1646cdb" alt="Okta App7" width="762" height="456" data-path="images/ctrl-centre/administration/credentials/Okta-app7.png" />

* Click "Assign" on any groups you want to assign to the application and click on "Done"

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/Okta-app8.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=705d1dd4a4c98c2e6ac3fbc40acf91c5" alt="Okta App8" width="746" height="388" data-path="images/ctrl-centre/administration/credentials/Okta-app8.png" />

## **6. Collection configuration data required for creating the identity provider in PADS4**

In order to create the identity provider in PADS4, you will need to collect some information on your newly created Okta Entra identity provider that will allow you to configure the provider in PADS4. 

For this you will need to click on the “Sign On” tab of your created app and follow the instructions below:

* Go to the "Sign On" app
* On the SAML 2.0 panel, click on the "More details" button
* Collect the following information:

| Req. info           | Example                                                                                                                  |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Metadata URL        | [https://myokta.okta.com/app/xxxxxxxxxxxx/sso/saml/metadata](https://myokta.okta.com/app/xxxxxxxxxxxx/sso/saml/metadata) |
| Sign on URL         | [https://myokta.okta.com/app/xxxxxxx/xxxxxxxxxxxx/sso/saml](https://myokta.okta.com/app/xxxxxxx/xxxxxxxxxxxx/sso/saml)   |
| Signing certificate | okta.cert                                                                                                                |

## **7. Configuring the provider in PADS4**

With the information configurated and retrieved above you will be able to configurate the Okta integration in PADS4.

* Login to the PADS4 Web Portal of your PADS4 instance with an account that has atleast the PADS4 System Management license.
* On the Dashboard open the left menu and browse to "Credentials" at the bottom left.
* Now click on "Providers" followed by "New"

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/Credentials-okta.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=138213afefb515880fafbac21e41b268" alt="Credentials Okta" width="867" height="545" data-path="images/ctrl-centre/administration/credentials/Credentials-okta.png" />

* Open the Okta configuration menu

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/okta-provider-details.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=471a675860adcc76cc621aa2bd1e83c1" alt="Okta Provider Details" width="802" height="1168" data-path="images/ctrl-centre/administration/credentials/okta-provider-details.png" />

Fill in the information as follows:

* Name: Represent the name of your provider in PADS4 (can be any value)
* Indentifier: Represent the "**Issuer**" value collected in step 6.
* Reply URL: Represent your local pads4 FQDN
  * Example: [**https://pads4.mycompany.com**](https://pads4.mycompany.com)
* Metadata URL: Represent the "**Metadata URL**" collected in step 6
* **Indentifier** and **Assertion Consumer Service URL** will be filled in automatically.

Now go to step 2 to upload the certificates required:

<img src="https://mintcdn.com/pads4/qMxdQGAt_6z5sHV4/images/ctrl-centre/administration/credentials/okta-certificate.png?fit=max&auto=format&n=qMxdQGAt_6z5sHV4&q=85&s=7d35ac3383b58850af8e4bcf3b5b6962" alt="Okta Certificate" width="802" height="912" data-path="images/ctrl-centre/administration/credentials/okta-certificate.png" />

* **Provider signing certificate**: Upload the Okta signing certificate retrieved in step 6.
* **Certificate from/for "domainone"**: Upload any certificate (.PFX) you want to sign assertions from PADS4 to the external identity provider.
* **Private key password**: Fill in the password that relates to the PFX certificate used above.

<Tip>
  **If you don’t need to enable SCIM Provisioning on your identity provider configuration, you can finish the identity provider creation process by clicking on the “Create” button**
</Tip>
