https://github.com/workos/ueberauth_workos_authkit
Ueberauth Strategy for WorkOS SSO with managed users
https://github.com/workos/ueberauth_workos_authkit
Last synced: 4 months ago
JSON representation
Ueberauth Strategy for WorkOS SSO with managed users
- Host: GitHub
- URL: https://github.com/workos/ueberauth_workos_authkit
- Owner: workos
- License: apache-2.0
- Created: 2024-07-22T15:59:29.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-02T18:28:53.000Z (about 1 year ago)
- Last Synced: 2025-04-02T20:50:19.411Z (about 1 year ago)
- Language: Elixir
- Size: 21.5 KB
- Stars: 1
- Watchers: 7
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ueberauth WorkOS Authkit
> **Note:** this an experimental SDK and breaking changes may occur. We don't recommend using this in production since we can't guarantee its stability.
Implementation of an Ueberauth Strategy for WorkOS Single Sign-On with managed users.
## Installation
Add `ueberauth_workos_authkit` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[
{:ueberauth_workos_authkit, "~> 0.1.0"}
]
end
```
## Configuration
This provider uses the WorkOS library, which requires API keys to be
[configured](https://github.com/workos/workos-elixir?tab=readme-ov-file#configuration) for that libary directly.
### Example
``` elixir
config :ueberauth, Ueberauth,
providers: [
workos: {Ueberauth.Strategy.WorkOS.AuthKit, []}
]
config :workos, WorkOS.Client,
api_key: "sk_example_123456789",
client_id: "client_123456789"
```
## SDK Versioning
For our SDKs WorkOS follows a Semantic Versioning process where all releases will have a version X.Y.Z (like 1.0.0) pattern wherein Z would be a bug fix (I.e. 1.0.1), Y would be a minor release (1.1.0) and X would be a major release (2.0.0). We permit any breaking changes to only be released in major versions and strongly recommend reading changelogs before making any major version upgrades.
## More Information
- [User Management Guide](https://workos.com/docs/user-management)
- [Single Sign-On Guide](https://workos.com/docs/sso/guide)
- [Directory Sync Guide](https://workos.com/docs/directory-sync/guide)
- [Admin Portal Guide](https://workos.com/docs/admin-portal/guide)
- [Magic Link Guide](https://workos.com/docs/magic-link/guide)
- [Domain Verification Guide](https://workos.com/docs/domain-verification/guide)