Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alphanodes/redmine_sudo
Sudo for Redmine - work without administrator permission, and switch to it if needed
https://github.com/alphanodes/redmine_sudo
administrator permission redmine redmine-plugin sudo
Last synced: 3 days ago
JSON representation
Sudo for Redmine - work without administrator permission, and switch to it if needed
- Host: GitHub
- URL: https://github.com/alphanodes/redmine_sudo
- Owner: alphanodes
- License: gpl-2.0
- Created: 2020-09-03T13:25:55.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-02-06T11:59:39.000Z (almost 2 years ago)
- Last Synced: 2024-08-02T02:10:46.944Z (3 months ago)
- Topics: administrator, permission, redmine, redmine-plugin, sudo
- Language: Ruby
- Homepage: https://www.redmine.org/plugins/redmine_sudo
- Size: 962 KB
- Stars: 7
- Watchers: 6
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-redmine - redmine_sudo - Sudo for Redmine - work without administrator permission, and switch to it if needed. (Plugins / Active Plugins)
README
# Sudo plugin for Redmine
[](https://www.redmine.org/plugins/redmine_sudo) [](https://github.com/AlphaNodes/redmine_sudo/actions?query=workflow%3A%22Run+Linters%22) [](https://github.com/AlphaNodes/redmine_sudo/actions?query=workflow%3A%22Run+Brakeman%22) [](https://github.com/AlphaNodes/redmine_sudo/actions?query=workflow%3ATests)
## 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.
## 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](https://github.com/alphanodes/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](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
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
-------
* @jbbarth for the idea of this plugin, but a different workflow. You can find his version here: https://github.com/jbbarth/redmine_sudo