App
An app is a registered application in the Samna platform. Apps configure OAuth properties, custom fields, and branding to integrate with the Auth service.
OAuth Configuration
Each app registers its redirect URI, JWKS endpoint, and client secrets. When a user authenticates through an app, Auth uses this configuration to issue tokens and redirect the user back to the correct application.
Properties
| Property | Purpose |
|---|---|
| Name | Display name of the application |
| Slug | URL friendly identifier for routing |
| Redirect URI | Where to send the user after authentication |
| JWKS | JSON Web Key Set for token validation |
| Providers | Which OAuth providers this app supports |
| Styling | Custom colors and branding |
Custom Fields
Apps can define custom fields using JSON Schema. These fields extend the data model for users and objects within that application. When a user interacts with the app, they can fill in app specific metadata defined by these schemas.
App Users
Each user that interacts with an app gets an app user profile. This allows the same person to have different usernames, avatars, and metadata across different applications while maintaining a single underlying identity.