blumeops/docs/reference/services
Erich Blume ff63679efb Enable zot registry auth + wire CI credentials (#237)
## Summary

- Enable OIDC + API key authentication on zot registry with three-tier accessControl
  - `anonymousPolicy: ["read"]` — anyone can pull
  - `artifact-workloads` group: `["read", "create"]` — CI push, no overwrite/delete
  - `admins` group: `["read", "create", "update", "delete"]` — break-glass
- Wire both CI push paths (Dagger and Nix/skopeo) with `ZOT_CI_API_KEY` credentials
- Add `artifact-workloads` PolicyBinding in Authentik blueprint for zot app access
- Add `ZOT_CI_API_KEY` to Forgejo Actions secrets via existing ansible role

Completes the `wire-ci-registry-auth` and `harden-zot-registry` Mikado cards.

## Manual Deployment Steps (after merge)

1. Deploy Authentik blueprint: `argocd app sync authentik`
2. In Authentik admin UI: set a password for the `zot-ci` service account
3. Deploy zot config: `mise run provision-indri -- --tags zot`
4. Log in to `https://registry.ops.eblu.me` as `zot-ci` via OIDC → generate API key
5. Store API key in 1Password as `zot-ci-apikey` in blumeops vault
6. Sync Forgejo secrets: `mise run provision-indri -- --tags forgejo_actions_secrets`
7. Trigger a test container build to verify CI push
8. Verify anonymous pull: `curl -sf https://registry.ops.eblu.me/v2/_catalog`

## Uncertainties

- **Zot `accessControl` group matching with OIDC:** Groups from Authentik's `profile` scope claim should map to zot policy groups, but the exact claim-to-group matching needs runtime verification
- **`http.auth.apikey: true`:** This config key is documented but needs verification against the specific zot version built from source on indri
- **API key permissions:** Need to confirm zot API keys inherit the generating user's group for accessControl evaluation

## Test Plan

- [ ] `mise run provision-indri -- --check --diff --tags zot` shows expected config changes
- [ ] Anonymous pull works after deploy
- [ ] Unauthenticated push fails (401)
- [ ] OIDC browser login redirects to Authentik and back
- [ ] API key push works after key generation
- [ ] CI push succeeds with both Dagger and skopeo paths
- [ ] `mise run services-check` passes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/237
2026-02-21 12:20:29 -08:00
..
1password.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
alloy.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
argocd.md Add reference/tools/ category with Dagger, ArgoCD CLI, Ansible, and Pulumi cards (#178) 2026-02-12 19:18:46 -08:00
authentik.md Integrate Forgejo with Authentik OIDC (#228) 2026-02-20 17:39:50 -08:00
automounter.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
borgmatic.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
caddy.md Add CV service reference card and docs updates (#171) 2026-02-12 11:45:32 -08:00
cv.md Add CV service reference card and docs updates (#171) 2026-02-12 11:45:32 -08:00
devpi.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
docs.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
flyio-proxy.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
forgejo.md Integrate Forgejo with Authentik OIDC (#228) 2026-02-20 17:39:50 -08:00
frigate.md Fix services-check and update docs for Frigate migration to ringtail (#218) 2026-02-19 14:38:21 -08:00
grafana.md Deploy Authentik identity provider (C2 Mikado) (#227) 2026-02-20 12:55:59 -08:00
immich.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
jellyfin.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
kiwix.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
loki.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
miniflux.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
navidrome.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
ntfy.md Review ntfy: upgrade to v2.17.0 and add reference docs (#201) 2026-02-17 09:51:40 -08:00
postgresql.md Doc review: connect-to-postgres, create-release-artifact-workflow, deploy-k8s-service (#191) 2026-02-15 07:42:01 -08:00
prometheus.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
teslamate.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
transmission.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
zot.md Enable zot registry auth + wire CI credentials (#237) 2026-02-21 12:20:29 -08:00