Skip to content

Commit c02339f

Browse files
authored
Update sso.md
finished keycloak guide
1 parent 1e7ab14 commit c02339f

File tree

1 file changed

+19
-3
lines changed

1 file changed

+19
-3
lines changed

docs/docs/sso.md

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,27 @@ You can use external OpenID Providers like Google, Keycloak, ... to allow your u
55
!!! Keep in mind
66
You still have to create the user accounts in Libredesk, they do not get created automatically.
77

8+
## Google
9+
10+
There is currently no documentation for it. Feel free to change that!
11+
812
## Keycloak
913

10-
1. Go to your keycloak admin console and create a new client.
11-
2. xxxxx
14+
1. Go to your Keycloak Admin Console and log in.
15+
2. Open your Libredesk Dashboard and navigat to "Security" > "SSO".
16+
3. Click the "New SSO" button to add a new SSO.
17+
4. Navigate to "Clients" on the left menu.
18+
5. Click "Create" to add a new client.
19+
6. Enter a Client ID (e.g. `libredesk-app`) and select OpenID Connect as the protocol.
20+
7. Set the "Root URL" (e.g. `https://ticket.example.com`).
21+
8. Set the "Web origins" (e.g. `https://ticket.example.com`).
22+
9. Uncheck everything besides "Standard flow" at "Authentication flow" and save your changes.
23+
10. Go to the "Credentials" tab and change the "Client Authenticator" to `Client Id and Secret`.
24+
11. Enter `https://keycloak.example.com/realms/yourrealm` as the "Provider URL" and choose a name (e.g. `Keycloak`) in Libredesk.
25+
12. Copy and paste the Client ID and secret into Libredesk and save.
26+
13. Afer you save, click on the three dots and choose "Edit" to open the just created SSO.
27+
14. Copy the "Callback URL" and paste it into the "Valid redirect URIs" field inside Keycloak (e.g. `https://ticket.example.com/api/v1/oidc/1/finish`).
1228

1329
## Other providers
1430

15-
You can use them, but there is currently no documentation for it. Feel free to change that!
31+
There is currently no documentation for it. Feel free to change that!

0 commit comments

Comments
 (0)