Introduction

Alien SSO SDK enables web and mobile applications to integrate non-custodial verification and authentication using Alien ID. It provides secure, privacy-preserving sign-in flows while maintaining compatibility with standard OAuth2.0, OpenID Connect protocols.

Who can use this SDK?

Any web or mobile application that needs user verification and authentication:

• Web applications: (React, Next.js, Vue, vanilla JavaScript).
• Mobile apps: with WebView integration.
• Backend services: requiring token verification.
• Decentralized applications: (dApps) needing web2-compatible flows.

Key Features

• Standard OAuth2.0/OIDC flow: works like Google/GitHub OAuth but is non-custodial.
• QR code & deep link: seamless mobile app verification.
• TypeScript-first: full type safety with Zod validation.
• React hooks: pre-built components and hooks for React apps.

Packages

• @alien_org/sso-sdk-core - Core client for any JavaScript/TypeScript project
• @alien_org/sso-sdk-react - React hooks, components, and providers for React applications

How it works

1. The user initiates sign-in from your app.
2. QR code or deep link opens in the Alien App.
3. The user approves verification and selects claims to share.
4. Your app receives an access token with verified user data.
5. Your app validates the access token as needed.

Installation

# For vanilla JavaScript/TypeScript projects
npm install @alien_org/sso-sdk-core
 
# For React projects
npm install @alien_org/sso-sdk-react

Next Steps

Choose your integration path based on your project:

• Core Integration Guide - For vanilla JavaScript/TypeScript projects.
• React Integration Guide - For React applications.
• API Reference - Core - Complete API documentation for Core SDK.
• API Reference - React - Complete API documentation for React SDK.
• Demo App - Example implementation and source code.