Sign in with REAN

REAN ID is a standard OAuth 2.0 authorization server and OpenID Connect provider. Any OAuth or OIDC library works with it.

Choose a flow

Your appFlowGuide
Website with a serverAuthorization code (+ PKCE), confidential clientWebsites
Single-page web appAuthorization code + PKCE, public clientWebsites
Desktop or mobile appAuthorization code + PKCE with a loopback or app-scheme redirectDesktop and mobile
Game, console, TV, CLIDevice authorization (RFC 8628)Device code
PC game on the REAN LauncherLauncher code (REAN extension)Launcher sign-in

Discovery

Libraries that support OpenID Connect Discovery only need the issuer:

text
https://api.reanstudios.com/.well-known/openid-configuration
Excerpt
{
  "issuer": "https://api.reanstudios.com",
  "authorization_endpoint": "https://reanstudios.com/oauth/authorize",
  "token_endpoint": "https://api.reanstudios.com/api/oauth/token",
  "userinfo_endpoint": "https://api.reanstudios.com/api/oauth/userinfo",
  "jwks_uri": "https://api.reanstudios.com/api/oauth/jwks",
  "revocation_endpoint": "https://api.reanstudios.com/api/oauth/revoke",
  "device_authorization_endpoint": "https://api.reanstudios.com/api/oauth/device",
  "response_types_supported": ["code"],
  "code_challenge_methods_supported": ["S256"],
  "id_token_signing_alg_values_supported": ["RS256"],
  "token_endpoint_auth_methods_supported": ["client_secret_basic", "client_secret_post", "none"]
}

What players see

Players sign in on reanstudios.com, never inside your app, so you never handle their password or two-step code. The consent screen shows your app name, what you asked for, who they are signed in as and where they will be sent back. Players who already allowed the same scopes go straight back to you.

Security rules

  • Only response_type=code. The implicit and password grants are not supported.
  • PKCE with S256 is required for public clients and recommended for everyone.
  • Always send and check state. Send a nonce and compare it with the ID token's nonce.
  • The redirect carries iss=https://api.reanstudios.com (RFC 9207). Check it if you talk to several providers.
  • Codes last 5 minutes and work once. A second use revokes everything the first use produced.