Skip to content

correct okta documentation flow #77

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
codyllord wants to merge 2 commits into
base: main
Choose a base branch
from
Open

correct okta documentation flow #77

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2c97b5f
correct okta documentation flow
codyllord Oct 27, 2025
da68824
Add details in regards to service namespace
codyllord Oct 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 2 additions & 7 deletions docs/Security/creating-your-auth-service/okta-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ This guide will walk you through setting up Okta Single Sign-On (SSO) authentica

![okta SAML Service Creation Blank Page](/img/okta-auth-config/okta-saml-blank-service-page.png)

2. You will need to fill in the Namespace field, this will become part of the URI structure for the service
2. You will need to fill in the Namespace field, this will become part of the URI structure for the service. The Namespace field must end with _sso, for instance a valid Namespace would be DreamFactoryOkta_sso.

3. The Label of the service will become the text in the button to login with Okta at the main login page for your DreamFactory instance

Expand All @@ -72,11 +72,6 @@ This guide will walk you through setting up Okta Single Sign-On (SSO) authentica

![okta SAML Service Creation ](/img/okta-auth-config/okta-saml-2-service-creation.png)

### 2.5 Configure Service
1. **Info Tab**: Configure basic service information
2. **Config Tab**: Configure according to your Okta Setup instructions
3. **API Docs Tab**: Review the new endpoints for Okta integration

## Step 3: Okta Second Configuration

### 3.1 Assign Application to Users
Expand All @@ -96,7 +91,7 @@ This guide will walk you through setting up Okta Single Sign-On (SSO) authentica
## Step 4: Application Configuration

### 4.1 Configure SSO Endpoint
You can now sign in by going to the `/sso` endpoint (see DreamFactory configuration > Step 2.5). Since we used the SAML 2.0 you should now see on the login landing page for your DreamFactory instance a new button below the normal login credentials fields, clicking this should redirect you to the Okta SSO page and proceed with requesting users to authenticate.
You can now sign in by going to the `/sso` endpoint. Since we used the SAML 2.0 you should now see on the login landing page for your DreamFactory instance a new button below the normal login credentials fields, clicking this should redirect you to the Okta SSO page and proceed with requesting users to authenticate.

### 4.2 Configure CORS
**Important**: Don't forget to add your application and Okta domains to DreamFactory > Config > CORS. For detailed instructions on configuring CORS settings, see our [CORS and SSL documentation](../system-settings/config/cors-ssl.md).
Expand Down