The Auth0 Marketplace listing enables administrators to add 1Kosmos as a Social Connection, allowing users to authenticate with biometric passwordless login on Auth0-powered applications.
Integration type
Marketplace
Added
Overview
The Auth0 Marketplace listing enables administrators to add 1Kosmos as a Social Connection, allowing users to authenticate with biometric passwordless login on Auth0-powered applications.
The 1Kosmos listing on the Auth0 Marketplace is distinct from the direct Auth0 SAML integration. Where the direct integration configures 1Kosmos as the primary identity provider for an Auth0 tenant via a one-click SAML setup, the Marketplace Social Connection approach allows 1Kosmos to be added as one of multiple identity sources on the Auth0 login form. Users can choose to authenticate with 1Kosmos alongside other configured connections.
This integration is suited for organizations already using Auth0 as their customer identity platform who want to add biometric passwordless login as an option without replacing their existing Auth0 configuration. The underlying mechanism uses SAML 2.0 to federate authentication between Auth0 and 1Kosmos.
Prerequisites
Active Auth0 tenant: Administrator access to the Auth0 Dashboard. The target application must be configured in Auth0 before adding the 1Kosmos Social Connection.
Active 1Kosmos tenant: Administrator access to the AdminX portal. Contact 1kosmos.com/contact if your tenant is not yet provisioned.
Auth0 plan with custom social connections: Custom social connections require a paid Auth0 plan. Confirm your plan supports adding custom identity connections before proceeding.
1Kosmos mobile app installed: Users must have the app on iOS or Android with biometrics enrolled before testing.
Configuration values
Values to collect from 1Kosmos AdminX for the Auth0 Social Connection:
Field | Where to find it |
|---|---|
Client ID | AdminX → Applications → [your SAML or OIDC app] → Client Credentials |
Client Secret | AdminX → Applications → [your SAML or OIDC app] → Client Credentials |
Authorization URL | AdminX → Settings → Authorization Server → Metadata URI → authorization_endpoint |
Token URL | AdminX → Settings → Authorization Server → Metadata URI → token_endpoint |
Issuer | AdminX → Settings → Authorization Server → Metadata URI → issuer |
Values to collect from Auth0 after creating the connection:
Field | Description |
|---|---|
Callback URL | Generated by Auth0 when the Social Connection is created; add this to the 1Kosmos OIDC application's Redirect URIs |
Integration steps
Step 1: Find the 1Kosmos listing on the Auth0 Marketplace
Navigate to marketplace.auth0.com and search for "1Kosmos."
Select the 1Kosmos listing and click the integration option to begin adding it to your Auth0 tenant.
Step 2: Create an OIDC application in AdminX for Auth0
Log in to the AdminX portal and navigate to Applications → Add Application → OIDC → Add Integration.
Enter a name (e.g., "Auth0 Social Connection"), set Grant Type to Authorization Code, and set the Signing Algorithm to RS256.
Add a placeholder redirect URI for now. You will update this with the Auth0 Callback URL after creating the connection. Enable the
openid,email, andprofilescopes.Click Create and copy the Client ID and Client Secret from the generated credentials.
Navigate to Settings → Authorization Server → Metadata URI and copy the Authorization URL, Token URL, and Issuer values.
Step 3: Configure the Social Connection in Auth0
In the Auth0 Dashboard, navigate to Authentication → Social and click Create Connection.
Select the 1Kosmos connection type from the marketplace or choose Create Custom if adding manually.
Enter the Client ID and Client Secret collected from AdminX.
Enter the Authorization URL, Token URL, and Issuer values from the 1Kosmos metadata response.
Set the Scope to include
openid,email, andprofile.Save the connection and copy the Callback URL generated by Auth0.
Step 4: Update the redirect URI in AdminX
Return to the AdminX portal and open the OIDC application created in Step 2.
Replace the placeholder redirect URI with the Callback URL copied from Auth0.
Save the application.
Step 5: Enable the connection for your Auth0 applications
In Auth0, navigate to Applications and open the application where you want to offer 1Kosmos login.
Go to the Connections tab and enable the 1Kosmos Social Connection.
The 1Kosmos login option will now appear on the Auth0 Universal Login form for that application.
Step 6: Test the integration
Navigate to your Auth0-powered application login page.
Select the 1Kosmos login option. You will be redirected to the 1Kosmos AdminX portal for authentication.
Open the 1Kosmos mobile app, scan the QR code, and complete biometric authentication.
Confirm you are returned to the application as an authenticated Auth0 user.
Test with a single user account before enabling for production users.
Integration notes
The Auth0 Marketplace Social Connection and the direct Auth0 SAML integration (available via AdminX pre-built integrations) serve different purposes. The Social Connection is appropriate when 1Kosmos login should appear as one option alongside other connections on the Auth0 login form. The direct SAML integration is appropriate when 1Kosmos should be the sole authentication provider for the tenant.
Choose the approach that matches your Auth0 architecture before beginning configuration. Credentials passed during the connection setup are used for the OIDC exchange only and should be stored securely in Auth0's connection settings.
