Skip to content

Latest commit

 

History

History
91 lines (56 loc) · 4.28 KB

README.md

File metadata and controls

91 lines (56 loc) · 4.28 KB
Raw

Sudo plugin for Redmine

Rate at redmine.org Run Linters Run Brakeman Run Tests

Features

  • User can switch to admin permission
  • User with admininistrator permission can drop admin permission
  • Multilingual

PROs vs default behavior

No extra user with admin permissions is required. Common use case is, to create a user called "admin" for it and multiple other users use it.

Fast switch between admin permission and default user permission. You just activate it, re-enter your password (if required), work as administrator.

Automatically timeout of working time with admin permission. This can be configured with sudo_mode_timeout. After a specific time period of doing nothing you are automatically logged out as administrator and proceed doing your work with the regular permissions.

Redmine Sudo

Break Redmine default

If a user has to have admin permisson, he has not this permission after login. He/she must switch to it (with top menu toggle) to get it. Redmine sudo-mode is used for time period and requesting password to switch to admin permission.

Redmine Requirements

  • Redmine version >= 5.0
  • Redmine Plugin: additionals
  • Ruby version >= 3.0
  • Redmine sudo_mode has to be turned on in config/configuration.yml

Installation

Note: all existing admin users will be converted to sudoer (which means, they can switch to admin)

Note2: Make sure you created a backup of your database before install!

Install redmine_sudo plugin for Redmine

cd $REDMINE_ROOT
git clone git://github.com/alphanodes/redmine_sudo.git plugins/redmine_sudo
git clone git://github.com/alphanodes/additionals.git plugins/additionals
bundle config set --local without 'development test'
bundle install
bundle exec rake redmine:plugins:migrate RAILS_ENV=production

Restart Redmine (application server) and you should see the plugin show up in the Plugins page.

Uninstall

Note: all existing sudoer users will be converted to admin users.

Uninstall redmine_sudo

cd $REDMINE_ROOT
bundle exec rake redmine:plugins:migrate NAME=redmine_sudo VERSION=0 RAILS_ENV=production
rm -rf plugins/redmine_sudo

Restart Redmine (application server)

Known problems

  • for api calls admin permissions are temorarily set for sudoer (not to database). This can be some negative side effect for some return values

License

This plugin is licensed under the terms of GNU/GPL v2. See LICENSE for details.

Redmine Copyright

The redmine_sudo is a plugin extension for Redmine Project Management Software, whose Copyright follows. Copyright (C) 2006- Jean-Philippe Lang

Redmine is a flexible project management web application written using Ruby on Rails framework. More details can be found in the doc directory or on the official website http://www.redmine.org

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Credits