Skip to content

Commit

Permalink
Merge pull request #1 from keitaroinc/update-docs-for-keycloak
Browse files Browse the repository at this point in the history
Update the readme file with requirements about keycloak
  • Loading branch information
JGulic authored Feb 10, 2023
2 parents ae4d5b2 + 102480e commit 345fbce
Showing 1 changed file with 19 additions and 3 deletions.
22 changes: 19 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,16 +6,32 @@ ckanext-keycloak is an extension for CKAN, that adds Single Sign On options for

## Requirements

**TODO:** For example, you might want to mention here which versions of CKAN this
extension works with.
**Note**
This extension requires users to have set up a Keycloak server and have a client set up for CKAN. For more information on how to set up Keycloak, please refer to the [Keycloak documentation](https://www.keycloak.org/documentation.html).

If your extension works across different versions you can add the following table:
For the development, the following requirements must be met:

* Create a realm in Keycloak
* Create a client in Keycloak
* Set the client's `Valid Redirect URIs` to `http://localhost:5000/user/sso_login`
* Configure identity providers in Keycloak (e.g. Google, GitHub, etc.)

If you want to use multiple identity providers, you need to set the `first_login_broker` as authentication workflow. This workflow will redirect the user to the login page of the identity provider. After the
user has logged in, the user will be logged in to CKAN.


## Compatibility

Compatibility with core CKAN versions:

| CKAN version | Compatible? |
| --------------- | ------------- |
| 2.9 | YES |
| --------------- | ------------- |
| 2.10 | YES |
| --------------- | ------------- |
| master | YES |
| --------------- | ------------- |


## Installation
Expand Down

0 comments on commit 345fbce

Please sign in to comment.