new steps for org sync through ui

EdwardAngert · EdwardAngert · commit 86ee782e7d3b · 2024-12-05T21:28:21.000Z
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
@@ -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' }}
diff --git a/docs/admin/users/idp-sync.md b/docs/admin/users/idp-sync.md
@@ -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**.
 
-   ```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
