Skip to content

feat: #1007 - Option to disable local login when OIDC is enabled - #1020

Merged
jmattheis merged 1 commit into
gotify:masterfrom
DerDummePunkt:github_1007_option_to_disable_local_login_when_oidc_enabled
Aug 13, 2026
Merged

jmattheis merged 1 commit into
gotify:masterfrom
DerDummePunkt:github_1007_option_to_disable_local_login_when_oidc_enabled

Conversation

@DerDummePunkt

Copy link
Copy Markdown
Contributor

This PR attempts to implement #1007

Adds configurable local authentication through GOTIFY_LOCALAUTH_ENABLED, defaults to true to preserve existing behavior.

When local authentication is disabled:

  • The server does not register POST /auth/local/login.
  • Basic Auth with local Gotify user credentials is rejected by authentication middleware.
  • The check for a local admin account and subsequent creation is skipped.
  • The UI hides the local username/password login form, registration button, and password-based elevation form.
  • The UI receives the public localauth flag through injected window.config.
  • GET /gotifyinfo exposes the same flag as localauth.

The server exits with a fatal error when both local authentication and OIDC are disabled, preventing startup without an available login method.

@DerDummePunkt
DerDummePunkt requested a review from a team as a code owner August 4, 2026 18:33

@jmattheis jmattheis left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good so far. I've some remarks and haven't tested it manually.

Comment thread auth/authentication.go Outdated
Comment thread router/router.go
Comment thread app.go Outdated
Comment thread model/gotifyinfo.go Outdated

@jmattheis jmattheis left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've made some small fixes.

I'll test this some more and will merge it around end of next week. (For security related stuff I want to take my time and I'm currently a bit busy).

@DerDummePunkt

Copy link
Copy Markdown
Contributor Author

No worries, take your time, there's no rush

@jmattheis
jmattheis force-pushed the github_1007_option_to_disable_local_login_when_oidc_enabled branch from 68b1976 to 529f75e Compare August 13, 2026 18:41
@jmattheis
jmattheis force-pushed the github_1007_option_to_disable_local_login_when_oidc_enabled branch from 529f75e to 795d9d1 Compare August 13, 2026 18:48
@codecov

codecov Bot commented Aug 13, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 93.10345% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.63%. Comparing base (491a17a) to head (795d9d1).

Files with missing lines Patch % Lines
app.go 0.00% 1 Missing ⚠️
router/router.go 85.71% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##           master    #1020      +/-   ##
==========================================
+ Coverage   74.28%   74.63%   +0.34%     
==========================================
  Files          66       66              
  Lines        3512     3532      +20     
==========================================
+ Hits         2609     2636      +27     
+ Misses        698      690       -8     
- Partials      205      206       +1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@jmattheis jmattheis left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks

@jmattheis
jmattheis added this pull request to the merge queue Aug 13, 2026
Merged via the queue into gotify:master with commit aceb5ff Aug 13, 2026
3 checks passed
bigSmooth7867 pushed a commit to bigSmooth7867/swarm that referenced this pull request Sep 21, 2026
This PR contains the following updates:

| Package | Update | Change |
|---|---|---|
| [gotify/server](https://github.com/gotify/server) | major | `2.9.1` → `3.1.1` |

[Release notes](https://github.com/gotify/server/releases)

---

### Release Notes

<details>
<summary>gotify/server (gotify/server)</summary>

### [`v3.1.1`](https://github.com/gotify/server/releases/tag/v3.1.1)

[Compare Source](gotify/server@v3.1.0...v3.1.1)

- Require an elevated session for creating users (GHSA-phfm-q6fr-wv34 via [#&#8203;1048](gotify/server#1048))
- Move theme selection and password change to separate settings page ([#&#8203;1040](gotify/server#1040) via [#&#8203;1041](gotify/server#1041) by [@&#8203;justadityaraj](https://github.com/justadityaraj))
- Disable password change form when [`GOTIFY_LOCALAUTH_ENABLED`](https://gotify.net/docs/config#gotify-localauth-enabled) is disabled ([#&#8203;1040](gotify/server#1040) via [#&#8203;1041](gotify/server#1041) by [@&#8203;justadityaraj](https://github.com/justadityaraj))
- Fix crash when a Let's Encrypt request fails ([#&#8203;1046](gotify/server#1046) by [@&#8203;NotAFlightRisk](https://github.com/NotAFlightRisk))
- Update dependencies

### [`v3.1.0`](https://github.com/gotify/server/releases/tag/v3.1.0)

[Compare Source](gotify/server@v3.0.0...v3.1.0)

Notable features:

- Add setting [`GOTIFY_LOCALAUTH_ENABLED`](https://gotify.net/docs/config#gotify-localauth-enabled) for disabling local user authentication [Docs](https://gotify.net/docs/oidc#disabling-local-authentication) ([#&#8203;1007](gotify/server#1007) via [#&#8203;1020](gotify/server#1020) by [@&#8203;DerDummePunkt](https://github.com/DerDummePunkt))
- Allow mapping user admin status from OIDC claims [OIDC Groups Docs](https://gotify.net/docs/oidc#groups) ([#&#8203;957](gotify/server#957) via [#&#8203;1033](gotify/server#1033) by [@&#8203;UiP9AV6Y](https://github.com/UiP9AV6Y))
- Prompt for re-authentication when authenticating with OIDC by default, configurable via [`GOTIFY_OIDC_PROMPT`](https://gotify.net/docs/config#gotify-oidc-prompt) ([#&#8203;1029](gotify/server#1029) by [@&#8203;DerDummePunkt](https://github.com/DerDummePunkt))
- Add setting [`GOTIFY_OIDC_IDP_NAME`](https://gotify.net/docs/config#gotify-oidc-idp-name) to change the label of the "login with oidc" button ([#&#8203;991](gotify/server#991) via [#&#8203;1022](gotify/server#1022) by [@&#8203;DerDummePunkt](https://github.com/DerDummePunkt))
- Add setting [`GOTIFY_OIDC_AUTO_REDIRECT`](https://gotify.net/docs/config#gotify-oidc-auto-redirect) to auto redirect to the IdP when opening the login page ([#&#8203;991](gotify/server#991) via [#&#8203;1029](gotify/server#1029) by [@&#8203;DerDummePunkt](https://github.com/DerDummePunkt))
- Highlight the current session in the client page ([#&#8203;677](gotify/server#677) via [#&#8203;1025](gotify/server#1025) by [@&#8203;SulimanAbdulrazzaq](https://github.com/SulimanAbdulrazzaq))

Miscellaneous changes:

- Update go module path to github.com/gotify/server/v3 ([#&#8203;1030](gotify/server#1030) by [@&#8203;eternal-flame-AD](https://github.com/eternal-flame-AD))
- Fix potential crash when pushing messages while a client disconnects with plugins active ([GHSA-78w7-2h8c-8252](GHSA-78w7-2h8c-8252) via [#&#8203;1035](gotify/server#1035))
- Fix potential crash when removing a user with plugins active ([#&#8203;1005](gotify/server#1005) by [@&#8203;Osamaali313](https://github.com/Osamaali313))
- Show password hashing errors in the UI instead of crashing ([#&#8203;1013](gotify/server#1013) via [#&#8203;1014](gotify/server#1014) by [@&#8203;eternal-flame-AD](https://github.com/eternal-flame-AD))
- Fix OIDC ID being removed when updating a user ([#&#8203;1009](gotify/server#1009) via [#&#8203;1010](gotify/server#1010))
- Read the OIDC username claim from the ID token and only fall back to the userinfo endpoint when it's missing ([#&#8203;1033](gotify/server#1033))

### [`v3.0.0`](https://github.com/gotify/server/releases/tag/v3.0.0)

[Compare Source](gotify/server@v2.9.1...v3.0.0)

Notable features:

- Add OIDC login support. See [OIDC Docs](https://gotify.net/docs/oidc) ([#&#8203;433](gotify/server#433) via [#&#8203;941](gotify/server#941), [#&#8203;977](gotify/server#977), [#&#8203;982](gotify/server#982), [#&#8203;1003](gotify/server#1003))
  - Thanks to [@&#8203;KovachVL](https://github.com/KovachVL) and [@&#8203;alanturing881](https://github.com/alanturing881) for reporting security issues for this feature.
- Add session elevation for sensitive actions in the web UI. [Session Elevation Docs](https://gotify.net/docs/session-elevation) (GHSA-3hcj-9m7p-wwm9, [#&#8203;944](gotify/server#944) via [#&#8203;952](gotify/server#952), [#&#8203;954](gotify/server#954)).
- Automatically delete inactive clients/sessions ([#&#8203;943](gotify/server#943) via [#&#8203;959](gotify/server#959))

Breaking changes:

- The `config.yml` file is no longer supported, convert it to the new env format with [`migrate-config`](https://gotify.net/docs/migrate-to-3#migrating-your-config).
- If you set list or map environment variables, their syntax changed, see [List and map syntax](https://gotify.net/docs/migrate-to-3#environment-list-and-map-syntax).
- API tokens are no longer returned in the GET endpoints and are only exposed on creation or rotation. See [Tokens are only shown once](https://gotify.net/docs/migrate-to-3#tokens-are-only-shown-once).
- If you have scripts hitting client-token endpoints, they may now need [elevation](https://gotify.net/docs/migrate-to-3#step-up-authentication).
- The paging.next URL in message list responses is now a relative path. See [Paging next URL is relative](https://gotify.net/docs/migrate-to-3#paging-next-url-is-relative).

Miscellaneous changes:

- Rework configuration ([#&#8203;366](gotify/server#366), [#&#8203;392](gotify/server#392) via [#&#8203;967](gotify/server#967))
- Don't store tokens in plain text ([#&#8203;325](gotify/server#325) via [#&#8203;971](gotify/server#971) by [@&#8203;eternal-flame-AD](https://github.com/eternal-flame-AD))
- Publish a `gotify/server:master` docker image for testing unreleased changes. [Docs: Testing master](https://gotify.net/docs/testing-master) ([#&#8203;953](gotify/server#953), [#&#8203;956](gotify/server#956))
- Allow sending messages with a client token ([#&#8203;964](gotify/server#964))
- Allow refreshing application tokens ([#&#8203;985](gotify/server#985) via [#&#8203;986](gotify/server#986) by [@&#8203;eternal-flame-AD](https://github.com/eternal-flame-AD))
- Increase token keyspace to >128 bits ([#&#8203;936](gotify/server#936) via [#&#8203;939](gotify/server#939) by [@&#8203;eternal-flame-AD](https://github.com/eternal-flame-AD))
- Switch logging to zerolog ([#&#8203;962](gotify/server#962))
- Add OCI labels to docker images ([#&#8203;924](gotify/server#924) via [#&#8203;927](gotify/server#927) by [@&#8203;eternal-flame-AD](https://github.com/eternal-flame-AD))
- Use use HTTP-only session cookies instead of local storage for UI sessions ([#&#8203;941](gotify/server#941))
- Add `createdAt` to users, clients, applications and plugins ([#&#8203;959](gotify/server#959))
- Add a CLI with `gotify serve`, `gotify version` and `gotify migrate-config` commands ([#&#8203;967](gotify/server#967))
- Fix Messenger plugins that are added after init ([#&#8203;653](gotify/server#653) via [#&#8203;998](gotify/server#998) by [@&#8203;TowyTowy](https://github.com/TowyTowy))
- Update dependencies

</details>

---

### Configuration

📅 **Schedule**: (UTC)

- Branch creation
  - At any time (no schedule defined)
- Automerge
  - At any time (no schedule defined)

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Mend Renovate CLI](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0NC4yNi4yIiwidXBkYXRlZEluVmVyIjoiNDQuODIuMyIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOlsibWFqb3IiLCJyZW5vdmF0ZSJdfQ==-->

Reviewed-on: https://gitea.vcasaserver.com/omar/swarm/pulls/705
Co-authored-by: Renovate Bot <renovate-bot@vcasaserver.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants