Setting up Okta

This guide walks you through configuring Okta to manage visitor authentication for your WriteDocs site using SAML 2.0.

Enterprise Feature

The end-user authentication feature is only available for Enterprise customers. If you are interested in upgrading your plan please, please contact sales@writedocs.io.

1

Create a new SAML 2.0 application in Okta

1. Access the Okta Admin Console:

   • Navigate to your Okta Admin Dashboard.

2. Initiate App integration:

   • Click on Applications in the left sidebar.
   • Select Create App Integration.

3. Configure App settings:

   • For Sign-in method, choose SAML 2.0.
   • Click Next.

4. Define general settings:

   • Provide an appropriate App name (e.g., "WriteDocs SAML Auth").
   • (Optional) Upload an application logo.
   • Click Next.

5. Configure SAML settings:

   • In the Single sign-on URL field, enter the Assertion Consumer Service (ACS) URL provided by WriteDocs.
   • In the Audience URI (SP Entity ID) field, enter the Entity ID provided by WriteDocs.
   • Set Name ID format to EmailAddress.
   • Set Application username to Email.
   • (Optional) Add attribute statements to pass user information:
     • Name: firstName | Value: user.firstName
     • Name: lastName | Value: user.lastName
     • Name: email | Value: user.email
   • Click Next.

2

Retrieve Identity Provider Metadata

• After saving, you'll be directed to the application's Sign On tab.
• Click View Setup Instructions.
• Save the Metadata URL with the WriteDocs team.

3

The WriteDocs team will add your domain to our systems

4

Test the integration

• Visit your published WriteDocs site.
• You should be redirected to the Okta sign-in page.
• Log in using your Okta credentials to verify successful integration.