jojo/routers/common
forgejo-backport-action a1222ebb5b [v15.0/forgejo] refactor: clarify four different outputs that authentication methods provide (#12468)
**Backport:** https://codeberg.org/forgejo/forgejo/pulls/12231

#12202 began a refactor of Forgejo's authentication implementations by providing structured data on an authentication success.  However, error cases were maintained as-is in that refactor, leaving a complex situation: what does returning an error from an authentication method mean?; does it mean that the authentication failed, or that a server error occurred?  Can another authentication still be tried?

This PR changes authentication methods so that they can return one of four things:
- `AuthenticationSuccess` with an authentication result.
- `AuthenticationNotAttempted` which indicates that no credentials relevant for this authentication method were presented.  If every method returned `AuthenticationNotAttempted`, then you would have an unauthenticated access.
- `AuthenticationAttemptedIncorrectCredential` which indicates that credentials were present and failed validation -- a situation indicating a `401 Unauthorized`.
- `AuthenticationError` which indicates that an internal server error occurred and failed authentication -- indicating a `500 Internal Server Error`.

This paves the way for one more refactor coming next: `basic.go` and `oauth2.go` perform 3-4 different authentications each (access tokens, oauth JWTs, actions tokens, actions JWTs, and username/password).  With the capability to return these more precise responses, these authentication methods can be split up into separate logic that isn't intertwined together.

Co-authored-by: Mathieu Fenniak <mathieu@fenniak.net>
Reviewed-on: https://codeberg.org/forgejo/forgejo/pulls/12468
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-05-08 07:31:33 +02:00
..
auth.go [v15.0/forgejo] refactor: clarify four different outputs that authentication methods provide (#12468) 2026-05-08 07:31:33 +02:00
compare.go chore: branding import path (#7337) 2025-03-27 19:40:14 +00:00
db.go chore: rename 'migrations' to 'gitea_migrations' 2025-10-14 14:40:49 -06:00
errpage.go chore: move template context (#8663) 2025-07-25 11:55:15 +02:00
errpage_test.go chore: branding import path (#7337) 2025-03-27 19:40:14 +00:00
markup.go feat: match on compound filename extensions (#11439) 2026-03-19 01:25:51 +01:00
middleware.go Improvement: Do not set session cookie for empty session 2026-03-11 04:18:06 +01:00
middleware_test.go chore: branding import path (#7337) 2025-03-27 19:40:14 +00:00
redirect.go chore: branding import path (#7337) 2025-03-27 19:40:14 +00:00
search.go chore: fix typos throughout the codebase (#10753) 2026-01-26 22:57:33 +01:00
serve.go chore: branding import path (#7337) 2025-03-27 19:40:14 +00:00