IDP integration

This document explains how an integration application is created during the Getting started onboarding flow in the OXU Developer Portal.

Who is this guide for?

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.

👉 To learn more about the differences between these environments, see: Environments: sandbox & production

---

Why create an integration application?

Creating an Application allows your system to connect securely with OXU Identity.

Today, the application is used to:

• Enable Login with OXU for your system

• Manage authentication securely

• Control who can access your application

In the future, the same application can be extended to:

• 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

👉 Think of an Application as a bridge between your system and Oten — you create it once, and it grows with your needs.

---

New to OXU? Start here

If this is your first time integrating with OXU, start from https://oten.com .

Entry point

1. Go to http://oten.com
2. From the landing page:

   • Select Products → Single Sign-On, or

   • Click Start Integration in the Integration section
3. You will see an introduction page explaining:

   • What Oten Identity is

   • What problems it solves

   • How it helps your organization
4. Click Start Integration

5. Sign in with your OXU account

6. You will be redirected to the OXU Developer ortal

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

---

What will happen during onboarding?

During the onboarding flow, OXU will guide you to:

• 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

⚠️ You do not need to create an application in advance. The Integration Application is created during onboarding.

---

Before you start

Required

• A valid OXU account

• Access to a Workspace

• Basic information about your application:

  • Application name

  • Redirect and logout URLs

  • Application type (SPA, Web, Native)

Optional (recommended)

• Basic understanding of OAuth 2.0 / OpenID Connect

• Access to your application source code

• Ability to configure environment variables

---

Step-by-step: Create an integration application

Step 1: Access Developer portal

Access and signing in, the Getting Started onboarding screen will be displayed. All you need is within 1 click to Start Integration button.

---

Step 2: Review the quick guide and begin

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.

1. Take a moment to briefly review the quick guide on the screen.

2. Click the Got it button to start creating your application.

---

Step 3: Create the integration application

Create your app by:

1. Enter:

   • App name

   • App description (if needed)
2. Click Create app

Your Integration application is now created when you see a successful toast.

---

Step 4: Create a client

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:

Application scenario	Client identity type to select
Building a browser-based web application (React, Javascript, frontend-only)	Single Page Application
Building a web application with a backend server where login is handled on the server	Regular Web Application
Building a mobile or desktop application (iOS, Android, desktop)	Native Application

Notes

• 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.