libre.sh/discourse-scim
2
0
Fork 0
Code Issues Pull requests Releases Packages Activity Actions
No description
13 commits 1 branch 0 tags 78 KiB
Ruby 100%
Find a file
Peter Bouda 922ff50e06 DEV: Move user and group class extensions to mixins
2024-10-22 09:31:57 +01:00
app/controllers/scim_v2 DEV: Add spec for scoped API key 2024-10-10 09:28:13 +01:00
config DEV: Add Group replace and destroy endpoints 2024-10-14 09:43:13 +01:00
lib/discourse_scim DEV: Move user and group class extensions to mixins 2024-10-22 09:31:57 +01:00
spec/integration DEV: Add integration tests for group endpoints 2024-10-15 10:49:17 +01:00
.gitignore Initial commit 2024-10-06 18:39:16 +01:00
LICENSE.txt DEV: Add README and LICENSE 2024-10-09 12:13:14 +01:00
plugin.rb DEV: Move user and group class extensions to mixins 2024-10-22 09:31:57 +01:00
README.md DEV: Add README and LICENSE 2024-10-09 12:13:14 +01:00

README.md

Discourse SCIM Plugin

A simple plugin that adds SCIM endpoints to Discourse.

The plugin is currently under development, not everything might work.

SCIM is a standard proposed by the IETF through RFC7644 and RFC7643 which aims to provide solution for user/group management through a simple Rest API.

The development of this plugin was funder by NGI via NLNet, you can read the proposal and about related work in our forum here.

To install the plugin

The easiest way to install the plugin to your running Discourse instance is to clone this repository and link or copy the main folder of this repository to the plugins/ folder in the Discourse code:

$ git clone https://forge.libre.sh/libre.sh/discourse-scim.git
$ cd discourse
$ ln -s ../discourse-scim plugins/

The plugin is enabled automatically when you (re)start the Discourse instance.

Query the SCIM endpoints

To query the SCIM endpoints you have to create an API key first. You can have a global API key for all users or a granular (scoped) API key for all users as described here:

https://meta.discourse.org/t/create-and-configure-an-api-key/230124

Please use the scope scim. Currently you have to allow access to all endpoints together.

Then to query all users with curl for example:

$ curl -H 'Authorization: Bearer <your_api_key>' -H 'Content-Type: application/scim+json' -v http://localhost:4200/scim_v2/Users