# ueberauth/guardian

Elixir Authentication

Repository: https://github.com/ueberauth/guardian
Canonical: https://ross.abutalabs.com/products/guardian
Language: Elixir
License: MIT
License Family: permissive
Topics: elixir, jwt, authentication, plug, jwt-tokens, phoenix, guardian
Last push: 2026-08-18T14:11:33+00:00

## Health v2 (maintenance only)
Score: 87/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 66, longevity 100
- inputs: {"age_days": 4096, "days_push": 15, "days_rel": 16, "gap_med": 187.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3514, forks 387 (observed 2026-08-28T04:08:07.792988+00:00)

## What it is
Guardian is a token-based authentication library for Elixir applications, with JSON Web Tokens supported out of the box. It integrates with Plug and Phoenix, including channels/sockets, and supports custom token types via the Guardian.Token behaviour.

## Use cases
- add jwt authentication to a phoenix app
- authenticate phoenix channels with tokens
- token-based auth for elixir web endpoints
- issue and verify signed tokens in elixir
- support multiple token configurations in one app

## When to choose
- you're building an Elixir or Phoenix app needing token-based authentication
- you need JWT support with customizable claims
- you want auth beyond HTTP, e.g. channels or custom protocols

## When to avoid
- you need session-based or OAuth-only authentication flows
- you're not using Elixir
- you want a turnkey hosted identity provider

## Facets
- artifact type: library
- maturity: stable
- function: auth, middleware
- domain: web-development, backend, security
- platform: elixir
- tags: jwt, phoenix, plug, token-authentication, web-server

## Member repositories
- ueberauth/guardian (main) score 87

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:07.792988+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:35:36.641970+00:00, confidence not recorded.
  - readme: https://github.com/ueberauth/guardian (fetched 2026-08-28T04:08:07.792988+00:00, sha 3d036cac67ed)
- Data as of 2026-08-30T08:39:29.467469+00:00.