# Okta to 2Checkout cPanel – SSO Integration Setup Guide

This guide walks you through configuring Okta as an Identity Provider (IdP) for Single Sign-On (SSO) access to your 2Checkout cPanel using SAML 2.0.

## Prerequisites

* Admin access to your Okta organization
* A 2Checkout representative contact to share configuration details with

## Setup and configuration

{% stepper %}
{% step %}

### Create a new app integration in Okta

* Log in to your **Okta Admin Console**.
* In the left-hand navigation menu, go to **Applications → Applications**.
* Click **Create App Integration**.
  {% endstep %}

{% step %}

### Select the Sign-In method

In the **Create a new app integration** dialog, select **SAML 2.0** as the sign-in method.

Click **Next**.
{% endstep %}

{% step %}

### General settings

* Enter a descriptive **App name** (e.g., 2Checkout cPanel SSO).
* Optionally, upload an **App logo**.
* Click **Next**.
  {% endstep %}

{% step %}

### Configure SAML settings

On the **Configure SAML** screen, fill in the following fields:

<table><thead><tr><th width="271">Field</th><th>Value</th></tr></thead><tbody><tr><td><strong>Single sign-on URL</strong></td><td><a href="https://secure.2checkout.com/cpanel/saml-login">https://secure.2checkout.com/cpanel/saml-login</a></td></tr><tr><td><strong>Audience URI (SP Entity ID)</strong></td><td><a href="https://secure.2checkout.com/cpanel/saml-login">https://secure.2checkout.com/cpanel/saml-login</a></td></tr><tr><td><strong>Name ID format</strong></td><td>EmailAddress</td></tr><tr><td><strong>Application username</strong></td><td>Email</td></tr></tbody></table>

✅ Make sure the checkbox **"Use this for Recipient URL and Destination URL"** remains checked under the Single sign-on URL field.

Leave all other settings on this page at their **default values**.

Click **Next**, then complete the final **Feedback** step to finish creating the integration.
{% endstep %}

{% step %}

### Retrieve and share the metadata URL

* Once the app is created, navigate to the Sign On tab of your newly created application.
* Under Metadata details, locate the Metadata URL.
* Click Copy to copy the URL.
* Send this Metadata URL to your 2Checkout representative so they can complete the IdP configuration on their end.
  {% endstep %}

{% step %}

### Assign a test user

Before rolling out SSO to all users, validate the integration with a single test account:

* In the application, go to the **Assignments** tab.
* Click **Assign** and select **Assign to People**.
* Find and assign a test user, then click **Done**.
* Notify your 2Checkout representative that a test user has been assigned and that you are ready to begin testing.
  {% endstep %}

{% step %}

### Full rollout

Once testing is successful with the test user:

* Return to the **Assignments** tab.
* Assign the remaining users (individually or via groups) to the application.
  {% endstep %}
  {% endstepper %}

#### Need help?

If you encounter any issues during setup, contact your 2Checkout representative for assistance.

***

<sub>*This document was generated with the assistance of AI and has been reviewed and verified by a 2Checkout team member.*</sub>\ <sub>*The information contained in this document was tested and verified using an Okta trial licence. Setup steps may differ for full licence or on-premises installations.*</sub>


---

# 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.2checkout.com/get-started/getting-started/activate-your-account/universal-sso-with-2checkout-saml-based/okta-to-2checkout-cpanel-sso-integration-setup-guide.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.