Skip to content

Conversation

@zangell44
Copy link
Collaborator

Expand the SCIM documentation to include comprehensive coverage of WorkOS role mapping functionality. The previous docs only had a 3-line mention of SCIM, but customers need detailed setup instructions for role mapping between their identity provider groups and Prefect Cloud account roles.

Changes

  • Add detailed role mapping section to configure-sso.mdx with WorkOS dashboard setup steps
  • Explain how directory groups map to account roles (Owner, Admin, Member, Collaborator)
  • Add SCIM team management section to manage-teams.mdx covering automatic team synchronization
  • Update cross-references between documentation pages

The updated docs now provide step-by-step configuration guidance and explain how WorkOS role mapping works with Prefect Cloud's account role system.

Closes CLOUD-3141

🤖 Generated with Claude Code

Expand the SCIM documentation to include comprehensive coverage of WorkOS role mapping functionality. The previous docs only had a 3-line mention of SCIM, but customers need detailed setup instructions for role mapping between their identity provider groups and Prefect Cloud account roles.

Changes:
- Add detailed role mapping section to configure-sso.mdx with WorkOS dashboard setup steps
- Explain how directory groups map to account roles (Owner, Admin, Member, Collaborator)
- Add SCIM team management section to manage-teams.mdx covering automatic team synchronization
- Update cross-references between documentation pages

Closes CLOUD-3141

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Copy link
Contributor

@bunchesofdonald bunchesofdonald left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the steps for role mapping are generally accurate, but maybe need a bit more detail / color?


Role mapping is configured in your WorkOS organization dashboard:

1. Navigate to your WorkOS dashboard
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

They need to go into the account settings to generate a link to get to the workos dashboard, might be worth calling out here.

Role mapping is configured in your WorkOS organization dashboard:

1. Navigate to your WorkOS dashboard
2. Select your organization
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe it'll go directly to their organization when they go through the link.

@github-actions
Copy link
Contributor

This pull request is stale because it has been open 14 days with no activity. To keep this pull request open remove stale label or comment.

@github-actions
Copy link
Contributor

github-actions bot commented Jan 8, 2026

This pull request was closed because it has been stale for 14 days with no activity. If this pull request is important or you have more to add feel free to re-open it.

@github-actions github-actions bot closed this Jan 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants