Redmine

OpenID Connect single sign-on plugin for Redmine. Works with any OIDC-compliant identity provider including Google, Microsoft Entra ID, Okta, Keycloak, and others.

Features¶

• SSO login -- adds a configurable "Sign in with ..." button to the Redmine login page
• Self-service account linking -- users can link their own OIDC identity from My Account, even if their OIDC email * differs from their Redmine email
• Conflict detection -- if an OIDC identity is already linked to another Redmine user, linking is rejected
• Auto-registration -- optionally create Redmine accounts on first OIDC login
• Email matching -- optionally match existing Redmine users by email when no OIDC link exists (login flow only)
• Admin OIDC management -- admins can view and remove OIDC links from the user edit page
• Multiple link support -- correctly handles users with multiple OIDC links (e.g. after a provider change)
• Standard flow -- uses the Authorization Code flow with OIDC Discovery

For more details, check https://github.com/enricohuang/redmine_oidc

Clone or copy the plugin into your Redmine plugins directory:

cd /path/to/redmine/plugins
git clone https://github.com/enricohuang/redmine_oidc.git

Run the plugin migration:

cd /path/to/redmine
bundle exec rake redmine:plugins:migrate RAILS_ENV=production
Restart Redmine.