- Go 93%
- CSS 6%
- Shell <1%
- Makefile <1%
- Docker <1%
Parcae #
Open-source Identity Governance & Administration (IGA) layer for self-hosted OIDC identity providers (Authentik, Keycloak).
Users browse a requestable catalog, request access with justification, approvers review, Parcae provisions the group membership automatically — with time-bounded grants, automatic expiry, retry with backoff, webhook notifications, and a DB-enforced append-only audit trail.
Name origin: the Roman Fates — Nona (grants), Decima (reviews), Morta (revokes).
What it looks like #
The approver's docket: waiting requests on the left, the selected request's facts, reason and history on the right, Approve and Decline always in view.

The requester's view: each request as a card with a three-step progress bar and one plain sentence, and "What you have" listing current access and when it ends.

Both shots come from the demo data in scripts/seed-demo.sql (local dev
database only; it replaces requests and catalog items).
Features #
- OIDC login via your existing IdP (Authentik, Keycloak, ...) — PKCE, encrypted cookie sessions
- Group sync — periodic + on-demand sync of groups from the IdP admin API
- Access catalog — admin curates which groups are requestable (ADR-002: synced, never live-queried)
- Access requests — users pick an item, give a justification, track status
- Approval workflow — request routes to a configured approver (sub / email / group); self-approval prevented
- Auto-provisioning — approved requests add the user to the IdP group; failures retry with 1m/5m/30m backoff, then admins can retry manually
- Time-bounded grants — optional max duration per catalog item; expired grants are auto-revoked
- Audit trail — append-only, enforced by a dedicated INSERT-only Postgres role (ADR-003)
- Webhooks — lifecycle events POSTed as JSON to one global endpoint
- Formal state machine — every transition validated and DB-enforced (ADR-004)
Container image #
docker pull ghcr.io/antoinetielbeke/parcae:latest
Published to the GitHub Container Registry from deploy/Dockerfile; the
GitHub repository is a read-only mirror of this README, development
happens here.
Quickstart (Docker Compose) #
cp .env.example .env # then set PARCAE_AUTH_ISSUER + PARCAE_OIDC_CLIENT_SECRET
make up # builds and starts Postgres + Parcae
open http://localhost:8080
Register an OIDC client in your IdP with redirect URI
http://localhost:8080/auth/callback, and create the IdP connection in the
admin UI (Settings → Identity provider, /admin/settings) using the IdP's admin API credentials.
Development #
Requires Go 1.27+, templ, golangci-lint, Docker.
make build # build bin/parcae (runs templ-generate first)
make run # run locally (needs parcae.yaml; listens on :8080)
make test # run tests (-race)
make test-integration # integration tests vs ephemeral Postgres 17
make lint # golangci-lint
make fmt # gofmt
make docker # build Docker image (parcae:dev)
make up / down # compose quickstart stack
Config is YAML with ${VAR} env substitution — copy
deploy/parcae.example.yaml to parcae.yaml
or point PARCAE_CONFIG at it. All configuration options are documented in
docs/architecture/deployment.md.
GET /healthz returns {"status":"ok"}.
Architecture & docs #
- Architecture overview
- Data model
- Request state machine
- Connector interface
- Security model
- Architecture decisions (ADRs)
- MVP scope · Roadmap
License #
AGPL-3.0-or-later — see LICENSE.