nswdpc/silverstripe-okta-boilerplate

An Okta authentication boilerplate for Silverstripe

Installs: 1 263

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 3

Forks: 1

Open Issues: 1

Type:silverstripe-vendormodule

v1.0.0-rc1 2024-07-26 00:48 UTC

README

This module adds Okta OAuth2 authentication to your Silverstripe website

⚠️ 🧪 This module is under active development and may include breaking changes.

Scope

With this module you can

  • Create an OAuth2 client via configuration using bigfork/silverstripe-oauth-login
  • Authenticate an Okta user that may or may not be a Silverstripe member, via Okta OAuth
  • Link a user to an Okta group
  • Optionally disallow/allow the default member authenticator alongside Okta auth

You will need

  • An Okta account
  • An Okta OAuth service application configured with scopes granted
  • If you require multiple sites authenticating via Okta, a service application per site.
  • A clientId and clientSecret for OAuth

Documentation

Start here for project setup and configuration examples.

Requirements

See composer.json

Installation

Via composer:

composer require nswdpc/silverstripe-okta-boilerplate

After installing the module, run a dev/build then start with the documentation.

License

BSD-3-Clause

Maintainers

Bugtracker

We welcome bug reports, pull requests and feature requests on the Github Issue tracker for this project.

Please review the code of conduct prior to opening a new issue.

Security

If you have found a security issue with this module, please email digital[@]dpc.nsw.gov.au in the first instance, detailing your findings.

Development and contribution

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.

Please review the code of conduct prior to completing a pull request.