Adstxt

SAML SSO Integration Guide

SAML SSO Integration Guide

You must be an admin user in app.adstxt.dev to complete this setup.

Setup in app.adstxt.dev

Step 1: Open the SAML Configuration Page

  • Navigate to the Connect SAML page in app.adstxt.dev.
  • You will find your License ID on this page, which is required for configuring your Identity Provider (IdP).

Identity Provider (IdP) Setup

Okta Setup Instructions

Step 1: Create a New Application in Okta

  1. Log in to your Okta Admin Console.

  2. Navigate to the Applications section and create a new application.

    • Go to Applications -> Create App Integration -> Select SAML 2.0.
    • Enter name Ads.txt Manager

Step 2: Configure SAML Settings

  1. In the SAML configuration page, fill in the required fields:

  • Single sign-on URL:
    https://app.adstxt.dev/api/saml/{YOUR_LICENCE_ID}/auth

  • Audience URI (SP Entity ID):
    https://app.adstxt.dev/api/saml/{YOUR_LICENCE_ID}/metadata

  • Name ID format:
    EmailAddress

  1. Complete the app creation by clicking Finish.

Step 3: Retrieve Okta Configuration Values

  • Once the application is created, go to the Sign On tab of the Okta app to find key values.

  • Click the More Details button if these fields are not immediately visible.

  • Sign On URL:
    https://trial-xxxxxxxx.okta.com/app/trial-xxxx__1/xxxxxxxx/sso/saml

  • Sign Out URL:
    https://trial-xxxxxxxx.okta.com

  • Issuer:
    http://www.okta.com/xxxxxxxx

  • Signing Certificate:
    Retrieve the certificate from this section

Step 4: Configure SAML in app.adstxt.dev

  1. Go back to the Connect SAML page in app.adstxt.dev.
  2. Enter the following values from your Okta setup:

  • Your domain:
    yourdomain.com

  • Entity ID of IdP:
    The Issuer value from Okta

  • Login URL of IdP:
    The Sign On URL value from Okta

  • Logout URL of IdP:
    The Sign Out URL value from Okta

  • X509 Certificate of IdP:
    The Signing Certificate value from Okta

  • Users:
    Define which users are allowed to access Adstxt manager.

Step 5: User Assignments at Okta

Add users for the application you have created at Okta.

Step 6: Test the Integration

To test your SSO setup:

  1. Visit the Ads.txt Manager SSO login page.
  2. Enter your domain to log in using your newly configured SAML SSO setup.