Keycloak and Outline wiki OIDC_SCOPES help needed #50267

hafteto · 2026-06-23T17:30:57Z

hafteto
Jun 23, 2026

Hello All,

I have setup Keycloak and Outline wiki and all is working.

I want to extend the OIDC_SCOPES=openid profile email to OIDC_SCOPES=openid profile email groups

Guides that i found point ot add custom mapper Clients --> Client details -->Dedicated scopes --> Configure New Mapper --> Group Membership

After that i reciave errors and it seem groups are not mapped.

OAuth error during authentication: Invalid scopes: openid profile email groups

Can someone point me or provide info how this shuld be set.

Thanks in advance

daveshenal · 2026-06-24T00:54:27Z

daveshenal
Jun 24, 2026

The error means Keycloak doesn't recognize groups as a valid scope for your client. Adding a mapper inside the dedicated client scope isn't quite enough on its own. You need to create a proper client scope named groups and assign it to your client.

Create the client scope
Left menu -> Client Scopes -> Create client scope -> name it groups, type: Optional -> Save
Add the Group Membership mapper
Inside the new scope -> Mappers** -> Add mapper -> By configuration -> Group Membership

Token Claim Name: groups
Full group path: off (unless Outline expects /group/name)
Enable for ID token, Access token, Userinfo -> Save

Assign it to your Outline client
Clients -> your Outline client -> Client Scopes tab -> Add client scope -> add groups as Optional

That should do it... OIDC_SCOPES=openid profile email groups will now be recognized and group membership will show up in the token. Hope it helps

1 reply

hafteto Jun 24, 2026
Author

Thanks a lot.

I see groups now exported in .well-known/openid-configuration

["openid","basic","profile","phone","microprofile-jwt","offline_access","groups","address","organization","acr","email","roles","web-origins","service_account"

Navigation Menu

Repository navigation

Keycloak and Outline wiki OIDC_SCOPES help needed #50267

Uh oh!

{{title}}

Uh oh!

Replies: 1 comment 1 reply

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Keycloak and Outline wiki OIDC_SCOPES help needed #50267

Uh oh!

hafteto Jun 23, 2026

Replies: 1 comment · 1 reply

Uh oh!

daveshenal Jun 24, 2026

Uh oh!

hafteto Jun 24, 2026 Author

hafteto
Jun 23, 2026

Replies: 1 comment 1 reply

daveshenal
Jun 24, 2026

hafteto Jun 24, 2026
Author