IDP integration
This document explains how an integration application is created during the Getting started onboarding flow in the OXU Developer Portal.
Last updated
This document explains how an integration application is created during the Getting started onboarding flow in the OXU Developer Portal.
Last updated
This guide helps customers create an integration application on the OXU Developer Portal.
It is designed for:
Organizations that already have a system and users
Admins or product owners (not necessarily developers)
Customers who want to enable “Login with OXU” for their system
By following this guide, you will understand:
Why an integration application is needed
Where to start if you are new
How this application is used now and in the future
OXU IDP supports two integration protocols, choose your integration method:
OAuth 2.0 / OpenID Connect (OIDC) - used for Web application, Single Page Applications, Native apps
👉 (Continue with the guides below)
SAML (Single Sign-On) - used for Enterprise SSO & integrating with external identity providers (Github)
👉 See guide here: SAML integration
Oten provides two separate environments to support IDP integration:
Sandbox – used for integration, testing, and configuration validation
Production – used for live operation with real users
Partners should start the integration in the sandbox environment. Once the integration has been successfully tested and verified, you can proceed to production for real-world usage.
Creating an Application allows your system to connect securely with OXU Identity.
Today, the application is used to:
In the future, the same application can be extended to:
👉 Think of an Application as a bridge between your system and Oten — you create it once, and it grows with your needs.
Entry point
From here, OXU will guide you step by step.
✔ No technical knowledge is required to begin ✔ Clear instructions and ready-to-use settings are provided
During the onboarding flow, OXU will guide you to:
⚠️ You do not need to create an application in advance. The Integration Application is created during onboarding.
Access and signing in, the Getting Started onboarding screen will be displayed. All you need is within 1 click to Start Integration button.
A welcome dialog will appear to provide an overview of the integration journey, helping you understand how to select the right application type for your needs.
Create your app by:
Your Integration application is now created when you see a successful toast.
Next, you will create a client for your application.
You will be asked to select a Client type.
Client type selection guide
Use the following guidance to choose the appropriate client type based on how your application is built:
Notes
👉 To learn more about the differences between these environments, see: Environments: sandbox & production
Enable Login with OXU for your system
Manage authentication securely
Control who can access your application
Manage user roles and permissions (authorization)
Enable social login and enterprise SSO
Be published to the Oten Marketplace (if you choose)
Integrate with other applications in the Oten ecosystem
If this is your first time integrating with OXU, start from https://oten.com .
Go to http://oten.com
From the landing page:
Select Products → Single Sign-On, or
Click Start Integration in the Integration section
You will see an introduction page explaining:
What Oten Identity is
What problems it solves
How it helps your organization
Click Start Integration
Sign in with your OXU account
You will be redirected to the OXU Developer ortal
Register your application in OXU
Generate a Client ID and Client secret
Configure allowed redirect and logout URLs
Access SDK and integration guidance
Test the login flow end to end
A valid OXU account
Access to a Workspace
Basic information about your application:
Application name
Redirect and logout URLs
Application type (SPA, Web, Native)
Basic understanding of OAuth 2.0 / OpenID Connect
Access to your application source code
Ability to configure environment variables
Take a moment to briefly review the quick guide on the screen.
Click the Got it button to start creating your application.
Enter:
App name
App description (if needed)
Click Create app
Application scenario
Client identity type to select
Building a browser-based web application (React, Javascript, frontend-only)
Building a web application with a backend server where login is handled on the server
Building a mobile or desktop application (iOS, Android, desktop)
Select Single page application if authentication is handled entirely in the browser.
Select Regular web application if your backend server manages authentication and sessions.
Select Native application for applications installed on user devices.
