mitgliederverwaltung/docs
Simon c381b86b5e
All checks were successful
continuous-integration/drone/push Build is passing
Improve oidc only mode (#474)
## Description of the implemented changes
The changes were:
- [x] Bugfixing
- [x] New Feature
- [ ] Breaking Change
- [x] Refactoring

**OIDC-only mode improvements and UX tweaks (success toasts, unauthenticated redirect).**

## What has been changed?

### OIDC-only mode (new feature)
- **Admin settings:** "Only OIDC sign-in" is an immediate toggle at the top of the OIDC section (no save button). Enabling it also turns off "Allow direct registration". When OIDC-only is on, the registration checkbox is disabled and shows a tooltip (DaisyUI `<.tooltip>`).
- **Backend:** Password sign-in is forbidden via Ash policy (`OidcOnlyActive` check). Password registration is blocked via validation `OidcOnlyBlocksPasswordRegistration`. New plug `OidcOnlySignInRedirect`: when OIDC-only and OIDC are configured, GET `/sign-in` redirects to the OIDC flow; GET `/auth/user/password/sign_in_with_token` is rejected with redirect + flash. `AuthController.success/4` also rejects password sign-in when OIDC-only.
- **Tests:** GlobalSettingsLive (OIDC-only UI), AuthController (redirect and password sign-in rejection), User authentication (register_with_password blocked when OIDC-only).

### UX / behaviour (no new feature flag)
- **Success toasts:** Success flash messages auto-dismiss after 5 seconds via JS hook `FlashAutoDismiss` and optional `auto_clear_ms` on `<.flash>` (used for success in root layout and `flash_group`).
- **Unauthenticated users:** Redirect to sign-in without the "You don't have permission to access this page" flash; that message is only shown to logged-in users who lack access. Logic in `LiveHelpers` and `CheckPagePermission` plug; test updated accordingly.

### Other
- Layouts: comment about unprocessed join-request count no longer uses "TODO" (Credo).
- Gettext: German translation for "Home" (Startseite); POT/PO kept in sync.
- CHANGELOG: Unreleased section updated with the above.

## Definition of Done
### Code Quality
- [x] No new technical depths
- [x] Linting passed
- [x] Documentation is added where needed (module docs, comments where non-obvious)

### Accessibility
- [x] New elements are properly defined with html-tags (labels, aria-label on checkboxes)
- [x] Colour contrast follows WCAG criteria (unchanged)
- [x] Aria labels are added when needed (e.g. oidc-only and registration checkboxes)
- [x] Everything is accessible by keyboard (toggles and buttons unchanged)
- [x] Tab-Order is comprehensible
- [x] All interactive elements have a visible focus (existing patterns)

### Testing
- [x] Tests for new code are written (OIDC-only UI, auth controller, user auth; SMTP config builder and mailer)
- [x] All tests pass
- [ ] axe-core dev tools show no critical or major issues (not re-run for this PR; suggest spot-check on settings and sign-in)

## Additional Notes
- **OIDC-only:** When the `OIDC_ONLY` env var is set, the toggle is read-only and shows "(From OIDC_ONLY)". When OIDC is not configured, the toggle is disabled.
- **Invalidation:** Enabling OIDC-only sets `registration_enabled: false` in one update; disabling OIDC-only only updates `oidc_only` (registration left as-is).
- **Review focus:** Plug order in router (OidcOnlySignInRedirect), policy/validation order in User, and that all OIDC-only paths (form, plug, controller) stay consistent.

Reviewed-on: #474
Co-authored-by: Simon <s.thiessen@local-it.org>
Co-committed-by: Simon <s.thiessen@local-it.org>
2026-03-16 19:09:07 +01:00
..
admin-bootstrap-and-oidc-role-sync.md Improve oidc only mode (#474) 2026-03-16 19:09:07 +01:00
badge-wcag-phase1-analysis.md style: consistent badges with sufficient color contrast 2026-02-26 08:33:52 +01:00
csv-member-import-v1.md docs: adds country 2026-02-24 09:35:00 +01:00
custom-fields-search-performance.md docs: updated docs 2025-12-11 13:44:30 +01:00
daisyui-drawer-pattern.md feat: improve sidebar handling 2026-01-06 10:29:20 +01:00
database-schema-readme.md docs: adds country 2026-02-24 09:35:00 +01:00
database_schema.dbml docs: adds country 2026-02-24 09:35:00 +01:00
development-progress-log.md fix: join confirmation mail configuration 2026-03-13 09:34:56 +01:00
email-layout-mockup.md feat: add join confirmation and mail templating 2026-03-09 18:15:12 +01:00
email-sync.md Doc: Loader auth-independent for link checks; email-sync rule rationale 2026-02-03 16:07:13 +01:00
email-validation.md refactor: adds schemales changeset and validation constant 2026-01-19 11:43:51 +01:00
feature-roadmap.md Improve oidc only mode (#474) 2026-03-16 19:09:07 +01:00
groups-architecture.md feat: add groups to search vector 2026-02-18 12:47:23 +01:00
membership-fee-architecture.md Setting: remove unused actor in default_fee_type validation 2026-02-04 11:40:19 +01:00
membership-fee-overview.md chore: update docs 2026-01-20 14:10:41 +01:00
oidc-account-linking.md Rename OIDC strategy from :rauthy to :oidc, update callback path 2026-02-24 11:51:00 +01:00
onboarding-join-concept.md feat: prevent join requests with equal mail 2026-03-13 11:18:34 +01:00
page-permission-route-coverage.md test: add tests for approval ui 2026-03-10 23:21:57 +01:00
pdf-generation-imprintor.md feat: adds pdf export with imprintor 2026-02-11 11:47:26 +01:00
policy-bypass-vs-haspermission.md Update documentation: Remove NoActor bypass references 2026-01-24 02:21:08 +01:00
roles-and-permissions-architecture.md Fix unlink-by-omission: on_missing :ignore, test, doc, string-key 2026-02-04 14:07:39 +01:00
roles-and-permissions-implementation-plan.md Add PermissionSets for Group, MemberGroup, MembershipFeeType, MembershipFeeCycle 2026-02-03 23:52:09 +01:00
roles-and-permissions-overview.md chore: update docs 2026-01-20 14:10:41 +01:00
settings-authentication-mockup.txt feat: allow disabling registration 2026-03-13 16:40:39 +01:00
smtp-configuration-concept.md refactor: unify smtp config logic 2026-03-16 14:23:46 +01:00
statistics-page-implementation-plan.md Update docs and guidelines for statistics feature 2026-02-12 19:35:48 +01:00
test-performance-optimization.md docs: consolidate test performance docs 2026-01-29 15:34:14 +01:00
user-resource-policies-implementation-summary.md Update documentation: Remove NoActor bypass references 2026-01-24 02:21:08 +01:00
vereinfacht-api.md Vereinfacht client: email normalization, multi-match warning, Bypass tests, doc note 2026-03-04 20:55:59 +01:00