# Okta Org2Org Integration
## Overview
This integration enables members of your team to seamlessly authenticate into the Threatrix app with granted permissions.
This integration requires a 3-step process
* [Create org2org app](#step-1-create-an-org2org-app): The customer configures Threatrix org2org integration in their Okta account
* [Threatrix IdP setup](#step-2-threatrix-idp-setup): Necessary credentials are provided to Threatrix to complete customer integration with Okta.
* [Complete Setup](#step-3-complete-org2org-setup): The customer completes org2org integration configuration
The total setup and configuration time is **approximately 20 minutes**.
## Step 1: Create an Org2Org app
\
Login to your Okta administration console and navigate to Applications->Applicatons. Click Brows App Catalog
Select or search "org2org"
Click "Add Integration"
Give the integration a name. “Threatrix Integration (Org2Org)” for example.\
Input into Base URL field.\
Leave other fields default and proceed.
On the next page select SAML 2.0
Scroll down and click “Setup Instructions”
On the page which just has opened navigate to step 6. Copy and save “IdP Issuer URI”, “IdP Single Sign On URL” and download the certificate.
Back to Org2Org setup page, scroll down and paste into “Hub ACS URL” and “Audience URI” fields and click Done.
## **Step 2: Threatrix IdP Setup**
Provide the above URI, URL, and certificate to the Threatrix team.
## Step 3: Complete org2org Setup
Putting actual values for “Hub ACS URL” and “Audience URI” fields. Go to “Threatrix Integration (Org2Org)” app page, Sign On tab and click Edit.
* Scroll down to “Advanced Sign-on Settings” section and input data.
* Into "Hub ACS URL" field input value of "Assertion Consumer Service URL" field provided by the Threatrix team.
* Into "Audience URI" field input value of "Audience URI" field provided by the Threatrix team.
* Click Save.
Setup provisioning
Enable API integration, input API token provided by the Threatrix team, click “Test API Credentials” to make sure the token is ok, and click Save.
After adding the token you’ll see the Provisioning tab with the “To App” section selected, click Edit.
Make selections like those shown in the screenshot below and click Save.
**Create Treatrix-related groups.**\
Groups are required to identify the organization to which users belong and the user roles.
Go to the Directory/Groups page and create group with the prefix "TRX\_ORG\_" which will determine organization and groups with the prefix "TRX\_ROLE\_" which will define user roles.
Then go to the Directory/People page and add groups to desired user(s).
**Add the Push Groups Rule**
Go back to the Threatrix integration (Org2Org) page, Push Groups tab and add the rule.
Name it "Push Threatrix Related Groups", add filter by prefix "TRX\_" and click Save.
Now assign the Threatrix Integration (Org2Org) app to people as shown in the next several screenshots
**That’s it**! You've completed the setup of Threatrix SAML/Okta org2org Integration.
---
# 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.threatrix.io/administration/okta/okta-org2org-integration.md?ask=
```
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.
