# How to install SCIM in Soffid

## Installation

### Download

Please download the Soffid SCIM add-on.

You can download it at the following link [http://www.soffid.com/download/enterprise/](http://www.soffid.com/download/enterprise/) if you have Soffid user with authorization, or in the following [http://download.soffid.com/download/](http://download.soffid.com/download/) by registering.

### Upload

Once the SCIM add-on is downloaded, please log in to IAM Console.

<p class="callout info">You need to be an administrator user of the Soffid console or a user with permissions to upload addons.</p>

<p class="callout info">It is recommended to upload the addons to master, this is the way to maintain updated all, master and tenants if there are.</p>

In the Soffid console, please go to: "Main Menu &gt; Administration &gt; Configure Soffid &gt; Global Settings &gt; Plugins" and upload the addon file, for more information visit the [Addons Getting started](https://bookstack.soffid.com/books/addons-getting-started/page/getting-started "Addons installation") page

Finally, when the addon is installed, it will be required to restart the Soffid Console.

## Testing

### Confirm authorization

To access to the SCIM REST web service, a user with correct authorization is required.

First we can check the authorization created by the SCIM add-on:

- Go to: Main Menu &gt; Administration &gt; Configure Soffid &gt; Security settings &gt; Authorizations
- Filter by the field "name" with the value "scim"
- Confirm that exists "scim:invoke"

### Confirm access

Once a user is available to access SCIM functionality, testing is easily done with a browser.

For example, to list groups.

- Please introduce the next URL: <u>http://&lt;domain&gt;/webservice/scim2/v1/Group</u> (*note, you must replace "&lt;domain&gt;" for your Soffid IAM Console domain*).
- Now a browser prompt requests the user and password for the authentication (note, you must use the user with the SCIM authorization).
- Finally, if the response is something like a compact JSON (Chrome) or a download file (Firefox).

Comments

- One can use a REST client extension in the browser, for example, [RESTer](https://bookstack.soffid.com/link/118#bkmrk-rester)
- One can show a JSON formatted with a browser extension, for example, JSONView (*note, it's necessary include the CONTENT-TYPE="application/scim+json" in the extension preferences*).