about summary refs log tree commit diff
path: root/test/python
diff options
context:
space:
mode:
authorPjotr Prins <pjotr.public01@thebird.nl>2026-10-04 06:54:32 +0000
committerPjotr <wrk@bosa.lan>2026-10-04 06:54:32 +0000
commitabb1fe51b1e8cf4079c462b3657e21376d389b99 (patch)
treeeeeeeb1dd0edc8c2e6e33f200f10f3f49b23cca2 /test/python
parent1d7b30777d11c7553e8612bbe2b50ab8dba656e3 (diff)
downloadgenenetwork4-abb1fe51b1e8cf4079c462b3657e21376d389b99.tar.gz
doc: Add docs/gn-auth.md, how to call the gn-auth service.
* docs/gn-auth.md: New file. Explains how a client (genenetwork4)
should authenticate callers against gn-auth: tokens are RS256 JWTs,
verified locally via the JWKS at GET /auth/public-jwks (mirroring
genenetwork3's gn3/oauth2/jwks.py, with two improvements -- cache and
periodically refresh the key set instead of refetching per request,
and check exp/nbf/iss, not just the signature); resource-scoped
authorization checks (e.g. "can this token's user do X on InbredSet
Y") via /auth/resource/populations/resource-id/... and
/auth/resource/authorisation, mirroring genenetwork3's
gn3/api/case_attributes.py:required_access. Documents why
POST /auth/introspect should not be used yet (unconfigured client
allow-list, no client ever created with the client_type it requires,
and JWT tokens are never persisted for it to find).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XDDpXvZBQat9uSgDeEMJ8d
Diffstat (limited to 'test/python')
0 files changed, 0 insertions, 0 deletions