-
Notifications
You must be signed in to change notification settings - Fork 226
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add troubleshooting note for group visibility issue in Assign Global Role #1591
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Could we exclude the non-Markdown files from the PR. Also the repo uses Yarn so adding a package-lock.json doesn't make sense.
This also needs to be ported to 2.9 (based on the parent issue) and the zh translation files, which I can help with if needed.
|
||
### Unable to See Groups When Assigning Global Roles | ||
|
||
When setting up an Keycloak OIDC, if the user isn't part of any groups, `groupSearchEnabled` is disabled, preventing group search in Assign Global Roles. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
When setting up an Keycloak OIDC, if the user isn't part of any groups, `groupSearchEnabled` is disabled, preventing group search in Assign Global Roles. | |
If you use a user that is not part of any groups for initial setup, then you cannot search for groups when trying to assign a global role. |
Some style-based suggestions and added some omissions:
- not mentioning keycloak since we're on the keyclocak page
- groupSearchEnabled since it's an implementation detail and not something they can current edit using normal procedures
This can't be updated through the UI. You can do one of the following workaround. | ||
|
||
- **Workaround 1:** Edit the `authconfig/keycloakoidc` on Rancher local: | ||
```bash | ||
kubectl edit authconfigs.management.cattle.io keycloakoidc | ||
``` | ||
Set `groupSearchEnabled: true`. | ||
|
||
- **Workaround 2:** Reconfigure the Keycloak OIDC setup using a user that is assigned to at least one group in Keycloak. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This can't be updated through the UI. You can do one of the following workaround. | |
- **Workaround 1:** Edit the `authconfig/keycloakoidc` on Rancher local: | |
```bash | |
kubectl edit authconfigs.management.cattle.io keycloakoidc | |
``` | |
Set `groupSearchEnabled: true`. | |
- **Workaround 2:** Reconfigure the Keycloak OIDC setup using a user that is assigned to at least one group in Keycloak. | |
To resolve this, you can either: | |
1. Manually edit the `authconfig/keycloakoidc` object to enable group search. | |
1. On the Rancher server: | |
```bash | |
kubectl edit authconfigs.management.cattle.io keycloakoidc | |
``` | |
1. Set `groupSearchEnabled: true`. | |
1. Save your changes. | |
1. Reconfigure your Keycloak OIDC setup using a user that is assigned to at least one group in Keycloak. |
4fef593
to
b7e7b74
Compare
b7e7b74
to
685b53b
Compare
Hi @btat |
Hi @pratikjagrut, let's go ahead and merge this. We can forego my comment on the zh files since that's out of scope for PRs submitted by engineering. My team can handle that part separately. |
Fixes rancher/rancher#48146
Reminders
See the README for more details on how to work with the Rancher docs.
Verify if changes pertain to other versions of Rancher. If they do, finalize the edits on one version of the page, then apply the edits to the other versions.
If the pull request is dependent on an upcoming release, remember to add a "MERGE ON RELEASE" label and set the proper milestone.
Description
Comments