Skip to content
Udibo
On this page
View Markdown

Start with Udibo

Udibo gives you two ways to add authentication: connect your application to Udibo Identity, the managed service, or use @udibo/oauth2 to run authentication inside your own application. Choose who operates identity first; the rest of your setup follows from that decision.

Is Udibo right for your app?

Start with the product overview for the value of hosted sign-in, organizations, and permissions working together. Then explore the pricing and provider comparisons against your requirements.

For an app sold to teams, see the B2B SaaS walkthrough. For individual accounts, see the consumer app walkthrough. For sharing client documents, see the client portal walkthrough. Each shows how the identity pieces fit into a product you might be building.

Choose your path

You want to…Start hereYou operate
Let Udibo manage sign-in, accounts, and recoveryConnect your first applicationYour application, its sessions, and its data authorization
Replace an existing identity integrationMove an existing appThe rollout, identity mapping, and application changes
Own credential storage and run authentication yourselfPackage quickstartYour authentication service, persistence, email, and security operations
Give a coding agent the implementation taskBuild with an agentThe integration decisions and review of its result

You can use the package as the client of the managed service. Installing it does not require you to run an authorization server or build password-reset pages.

What the managed service takes care of

Your users sign in on your tenant's hosted pages. You configure the sign-in methods, account creation, and MFA policy; your application receives the result through an OAuth2 authorization-code flow.

Your backend still protects your application's records. A valid session proves who someone is; it does not, by itself, give them access to another customer's data. The concepts guide explains that boundary with examples.

What the package gives you

@udibo/oauth2 supplies OAuth2/OIDC clients, authorization and resource servers, Hono integration, a backend-for-frontend (BFF), and React bindings. A BFF is your app's backend layer that keeps tokens on the server and gives the browser a session cookie.

The package's documentation index separates managed integration from app-owned authentication. Its known limitations and runtime support belong in your evaluation before you choose storage or deploy.

Availability and fit

Start at Udibo for how to get an account. Once you have one, you can create a tenant from the dashboard, owned by you or by an organization you own. You can explore the package's local identity provider without a managed account.

The hosted service currently offers password, social, email-code, magic-link, and passkey sign-in, with TOTP and passkey MFA and recovery codes. SAML federation, SCIM provisioning, and custom domains for hosted pages are not available. If one is a launch requirement, evaluate an alternative that provides it today. The comparison guides explain the tradeoffs without treating planned features as available features.

Your first milestone

Aim for a browser sign-in that returns to your application, an authenticated API request, and a sign-out that ends the application's session. Once that works, add the capabilities your product needs and use the production checklist before inviting real users.

Keep building

Your next goalGuide
Connect a first applicationGet started
Choose a template or runnable exampleStarting projects
Offer the right sign-in experienceSign-in methods
Admit users in stagesSign-up and waitlist
Put your name and logo on the hosted pagesBrand your hosted pages
Give customers their own workspaceOrganizations
Control access to features or recordsPermissions and roles
Add sign-out and device controlsSessions and sign-out
Invite teammates to the dashboardTeam access
Choose which API your code callsChoose the right API
Prepare a launchProduction checklist
Set email limits and confirm usage alertsUsage, limits, and alerts
Fix an integration problemTroubleshooting

Last verified 2026-11-01.