Dec 10, 2024 · Dec 5, 2024 · Dec 5, 2024 · Dec 9, 2024 · Dec 9, 2024 · Dec 10, 2024
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
          ./scripts/check_unstaged.sh
        shell: bash

      - name: markdownlint-cli2-action
        uses: DavidAnson/markdownlint-cli2-action@v18.0.0
        with:
          globs: "docs/**/*.md"

  gen:
    timeout-minutes: 8
    runs-on: ${{ github.repository_owner == 'coder' && 'depot-ubuntu-22.04-8' || 'ubuntu-latest' }}
diff --git a/docs/admin/users/idp-sync.md b/docs/admin/users/idp-sync.md
   Depending on the OIDC provider, this claim may be called something else.
   Common names include `groups`, `memberOf`, and `roles`.

 1. Configure the Coder server to read groups from the claim name with the OIDC
   organization field server flag:

   ```sh
   # as an environment variable
   CODER_OIDC_ORGANIZATION_FIELD=groups
   ```

 1. Fetch the corresponding organization IDs using the following endpoint:

   ```text
   https://[coder.example.com]/api/v2/organizations
   ```

 1.Set the following in your Coder server [configuration](../setup/index.md).
 1.As a Coder admin, go to **Settings** > **IdP organization sync**.

   ```env
   CODER_OIDC_ORGANIZATION_MAPPING='{"data-scientists":["d8d9daef-e273-49ff-a832-11fe2b2d4ab1",  "70be0908-61b5-4fb5-aba4-4dfb3a6c5787"]}'
   ```
 1. In the **Organization sync field** text box, enter the organization claim,
   then select **Save**.

 > One claim value from your identity provider can be mapped to many
 > organizations in Coder. The example above maps to two organizations in
 > Coder.
 If there are already users in the default organization, leave **Assign
 Default Organization** enabled. Disabling it might remove users from the
 default organization.

 1.By default, all users are assigned to the default (first) organization. You
 can disable that with:
 1.Enter an IdP organization name and Coder organization, then select **Add IdP
 organization**:

   ```env
   CODER_OIDC_ORGANIZATION_ASSIGN_DEFAULT=false
   ```
   ![IdP organization sync](../../images/admin/users/organizations/idp-org-sync.png)

 </div>

diff --git a/docs/images/admin/users/organizations/idp-org-sync.png b/docs/images/admin/users/organizations/idp-org-sync.png
Original file line number	Diff line number	Diff line change
Expand Up		@@ -221,6 +221,11 @@ jobs:
		./scripts/check_unstaged.sh
		shell: bash

		- name: markdownlint-cli2-action
		uses: DavidAnson/markdownlint-cli2-action@v18.0.0
		with:
		globs: "docs/*/.md"

		gen:
		timeout-minutes: 8
		runs-on: ${{ github.repository_owner == 'coder' && 'depot-ubuntu-22.04-8' \|\| 'ubuntu-latest' }}
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -420,36 +420,25 @@ settings, a user's memberships will update when they log out and log back in.
		Depending on the OIDC provider, this claim may be called something else.
		Common names include `groups`, `memberOf`, and `roles`.

		1. Configure the Coder server to read groups from the claim name with the OIDC
		organization field server flag:

		```sh
		# as an environment variable
		CODER_OIDC_ORGANIZATION_FIELD=groups
		```

		1. Fetch the corresponding organization IDs using the following endpoint:

		```text
		https://[coder.example.com]/api/v2/organizations
		```

		1.Set the following in your Coder server [configuration](../setup/index.md).
		1.As a Coder admin, go to Settings > IdP organization sync.
Copy link Member johnstcnDec 10, 2024• edited Loading Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Note: we should probably clarify that the user must be an Organization Admin or a site-wide User Admin. ref:https://github.com/coder/coder/blob/main/coderd/rbac/roles.go (search for`ResourceIdpsyncSettings`) EdwardAngert reacted with thumbs up emoji

		```env
		CODER_OIDC_ORGANIZATION_MAPPING='{"data-scientists":["d8d9daef-e273-49ff-a832-11fe2b2d4ab1", "70be0908-61b5-4fb5-aba4-4dfb3a6c5787"]}'
		```
		1. In the Organization sync field text box, enter the organization claim,
		then select Save.

		> One claim value from your identity provider can be mapped to many
		> organizations in Coder. The example above maps to two organizations in
		> Coder.
		If there are already users in the default organization, leave **Assign
Copy link Contributor jaaydenhDec 9, 2024 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. As I understand it, when Assign Default Organization is enabled, users will always be added to the default organization and when it is disabled users will always be removed from the default organization. I think it may be useful to let users know that this is always the case whether or not users are already in the default organization.
		Default Organization** enabled. Disabling it might remove users from the
EdwardAngert marked this conversation as resolved. Show resolvedHide resolved
		default organization.

		1.By default, all users are assigned to the default (first) organization. You
		can disable that with:
		1.Enter an IdP organization name and Coder organization, then select **Add IdP
EdwardAngert marked this conversation as resolved. Show resolvedHide resolved
		organization**:

		```env
		CODER_OIDC_ORGANIZATION_ASSIGN_DEFAULT=false
		```
		![IdP organization sync](../../images/admin/users/organizations/idp-org-sync.png)

		</div>

Expand Down