Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Latest commit d581b57 Jun 26, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_config Automatically enable sudo mode when logging in Jun 6, 2019
client Reduce setPasswordInput callback passing Jun 6, 2019
docs/_images NEW Add sudo mode controller and service to check/activate Jun 6, 2019
src NEW Update default lifetime for sudo mode to 45 minutes Jun 23, 2019
tests/php extend test coverage for MemberExtension Jun 18, 2019
.editorconfig Initial commit, adding template files and webpack config Jun 4, 2019
.eslintrc.js
.gitattributes Initial commit, adding template files and webpack config Jun 4, 2019
.gitignore Initial commit, adding template files and webpack config Jun 4, 2019
.nvmrc Add shell for sudo mode state container and update to node 10 + React 16 Jun 4, 2019
.scrutinizer.yml Override scrutinizer dependencies config to only run composer install Jun 6, 2019
.travis.yml Remove SS 4.0 and 4.1 from Travis builds Jun 23, 2019
LICENSE.md Initial commit, adding template files and webpack config Jun 4, 2019
README.md DOCS Update badge URLs in readme Jun 25, 2019
composer.json Merge branch '4.0' Jun 26, 2019
package.json Add tests for LoadingIndicator and SudoMode HOC Jun 6, 2019
phpcs.xml.dist Initial commit, adding template files and webpack config Jun 4, 2019
phpunit.xml.dist Initial commit, adding template files and webpack config Jun 4, 2019
webpack.config.js Initial commit, adding template files and webpack config Jun 4, 2019
yarn.lock Add tests for LoadingIndicator and SudoMode HOC Jun 6, 2019

README.md

SilverStripe Security Extensions

Build Status Scrutinizer Code Quality codecov License SilverStripe supported module

Overview

This module is a polyfill for some security related features that will become part of the core SilverStripe product, but are required for older SilverStripe 3.7 and 4.x support in the meantime.

Installation

$ composer require silverstripe/security-extensions 1.x-dev

Features

Sudo mode

Sudo mode represents a heightened level of permission in that you are more certain that the current user is actually the person whose account is logged in. This is performed by re-validating that the account's password is correct, and will then last for a certain amount of time (configurable) until it will be checked again.

Sudo mode will automatically be enabled for the configured lifetime when a user logs into the CMS. Note that if the PHP session lifetime expires before the sudo mode lifetime, that sudo mode will also be cleared (and re-enabled when the user logs in again). If the user leaves their CMS open, or continues to use it, for an extended period of time with automatic refreshing in the background, sudo mode will eventually deactivate once the max lifetime is reached.

Configuring the lifetime

The default SudoModeServiceInterface implementation is SudoModeService, and its lifetime can be configured with YAML. You should read the lifetime value using SudoModeServiceInterface::getLifetime().

SilverStripe\SecurityExtensions\Services\SudoModeService:
  lifetime_minutes: 25

Enabling sudo mode for controllers

You can add the SilverStripe\SecurityExtensions\Services\SudoModeServiceInterface as a dependency to a controller that requires sudo mode for one of its actions:

class MyController extends Controller
{
    private $sudoModeService;

    private static $dependencies = ['SudoModeService' => '%$' . SudoModeServiceInterface::class];

    public function setSudoModeService(SudoModeServiceInterface $sudoModeService): self
    {
        $this->sudoModeService = $sudoModeService;
        return $this;
    }
}

Performing a sudo mode verification check in a controller action is simply using the service to validate the request:

public function myAction(HTTPRequest $request): HTTPResponse
{
    if (!$this->sudoModeService->check($request->getSession()) {
        return $this->httpError(403, 'Sudo mode is required for this action');
    }
    // ... continue with sensitive operations
}

Using sudo mode in a React component

This module defines a React Higher-Order-Component which can be applied to React components in your module or code to intercept component rendering and show a "sudo mode required" information and login screen, which will validate, activate sudo mode, and re-render the wrapped component afterwards on success.

Note: the JavaScript injector does not currently support injecting transformations/HOCs, so we have coupled the application of these injector transformations into this module itself for the silverstripe/mfa module. Unfortunately, if you want to apply this to your own code you will need to either duplicate the SudoMode HOC into your project or module and apply the transformation at that point.

Sudo mode HOC example

Example implementation:

import WithSudoMode from '../containers/SudoMode/SudoMode';

Injector.transform('MyComponentWithSudoMode', (updater) => {
  updater.component('MyComponent', WithSudoMode);
});

Requirements for adding to a component

While the sudoModeActive prop is gathered automatically from the Redux configuration store, backend validation is also implemented to ensure that the frontend UI cannot simply be tampered with to avoid re-validation on sensitive operations.

Ensure you protected your endpoints from cross site request forgery (CSRF) at the same time.

Require password change on next log in

Administrators with the ability to administer members can see a checkbox in the CMS under the area to set the member's password. Checking this box will set the password expiry to the current date, meaning the next time the member logs in they will be required to choose a new password for their account.

The date is set selectively in order to not batter the database with updates to that member's records each time an unrelated setting is changed and saved. The matrix is as follows (- indicates no change):

Expiry Date Checked Unchecked
Null now -
Future now -
Expired - null

No change is made when setting this field and the password is already expired for auditing purposes (an administrator could see how long ago a password expired).

Similarly no change is made when unsetting this field and the expiry date is in the future, it should remain so - the checkbox is for immediately requiring a new password on the next log in.

Given the above two paragraphs, it should not be possible to reach these cases under normal (CMS) usage, as the UI reflects the current state of the PasswordExpiry field on load. The checkbox will be checked if the current password is already expired.

Versioning

This library follows Semver. According to Semver, you will be able to upgrade to any minor or patch version of this library without any breaking changes to the public API. Semver also requires that we clearly define the public API for this library.

All methods, with public visibility, are part of the public API. All other methods are not part of the public API. Where possible, we'll try to keep protected methods backwards-compatible in minor/patch versions, but if you're overriding methods then please test your work before upgrading.

Reporting Issues

Please create an issue for any bugs you've found, or features you're missing.

License

This module is released under the BSD 3-Clause License.

You can’t perform that action at this time.