Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit82415a6

Browse files
authored
chore: add documentation to address common group sync errors (#8212)
* chore: Add documentation to address common group sync errors
1 parent80ef147 commit82415a6

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

‎docs/admin/auth.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -282,6 +282,32 @@ OIDC provider will be added to the `myCoderGroupName` group in Coder.
282282

283283
[azure-gids]:https://github.com/MicrosoftDocs/azure-docs/issues/59766#issuecomment-664387195
284284

285+
### Troubleshooting
286+
287+
Some common issues when enabling group sync.
288+
289+
#### Invalid Scope
290+
291+
If you see an error like the following, you may have an invalid scope.
292+
293+
```console
294+
The application '<oidc_application>' asked for scope 'groups' that doesn't exist on the resource...
295+
```
296+
297+
This can happen because the identity provider has a different name for the scope. For example, Azure AD uses `GroupMember.Read.All` instead of `groups`. You can find the correct scope name in the IDP's documentation. Some IDP's allow configuring the name of this scope.
298+
299+
The solution is to update the value of `CODER_OIDC_SCOPES` to the correct value for the identity provider.
300+
301+
#### No `group` claim in the `got oidc claims` log
302+
303+
Steps to troubleshoot.
304+
305+
1. Ensure the user is a part of a group in the IDP. If the user has 0 groups, no `groups` claim will be sent.
306+
2. Check if another claim appears to be the correct claim with a different name. A common name is `memberOf` instead of `groups`. If this is present, update `CODER_OIDC_GROUP_FIELD=memberOf`.
307+
3. Make sure the number of groups being sent is under the limit of the IDP. Some IDPs will return an error, while others will just omit the `groups` claim. A common solution is to create a filter on the identity provider that returns less than the limit for your IDP.
308+
-[Azure AD limit is 200, and omits groups if exceeded.](https://learn.microsoft.com/en-us/azure/active-directory/hybrid/connect/how-to-connect-fed-group-claims#options-for-applications-to-consume-group-information)
309+
-[Okta limit is 100, and returns an error if exceeded.](hhttps://developer.okta.com/docs/reference/api/oidc/#scope-dependent-claims-not-always-returned)
310+
285311
## Provider-Specific Guides
286312

287313
Below are some details specific to individual OIDC providers.

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp