Skip to content

docs: add Okta group-based role provisioning to SCIM guide#829

Merged
danielfsousa merged 4 commits intomainfrom
docs/scim-okta-groups
Apr 17, 2026
Merged

docs: add Okta group-based role provisioning to SCIM guide#829
danielfsousa merged 4 commits intomainfrom
docs/scim-okta-groups

Conversation

@danielfsousa
Copy link
Copy Markdown
Contributor

@danielfsousa danielfsousa commented Apr 16, 2026

Context

A customer asked whether they could use Okta groups for SparkPost role provisioning. We confirmed this works and are now documenting the steps.

Summary

  • Adds a new "Managing User Roles with Okta Groups" section to the SCIM provisioning docs
  • Covers creating Okta groups per SparkPost role, assigning them to the app with role mappings, and managing group priority for multi-group users
  • Includes 4 annotated screenshots walking through the Okta admin console workflow

Preview

https://deploy-preview-829--support-docs.netlify.app/docs/my-account-and-profile/scim

Test plan

  • Verify screenshots render correctly in the docs site
  • Confirm all image paths resolve (media/scim/assign_to_groups.png, assign_sparkpost_to_groups.png, assign_group_role.png, group_priority.png)
  • Review steps against a live Okta admin console

Note

Low Risk
Docs-only change; main risk is broken/incorrect instructions or missing screenshot assets/paths on the docs site.

Overview
Documents Okta group-based role provisioning for SCIM by adding a new “Managing User Roles with Okta Groups” section to content/docs/my-account-and-profile/scim.md, including supported role mappings, setup steps (create groups, assign to app with role attribute, manage group priority), and new screenshots.

Also refreshes the page metadata by updating lastUpdated to 04/16/2026.

Reviewed by Cursor Bugbot for commit a36f322. Bugbot is set up for automated code reviews on this repo. Configure here.

Adds a new section documenting how to manage SparkPost user roles
using Okta groups via SCIM, including step-by-step instructions
for creating groups, assigning them to the SparkPost app with role
mappings, and managing group priority for users in multiple groups.
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 16, 2026

Deploy Preview for support-docs ready!

Name Link
🔨 Latest commit a36f322
🔍 Latest deploy log https://app.netlify.com/projects/support-docs/deploys/69e0f65195ab0c000808a199
😎 Deploy Preview https://deploy-preview-829--support-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Expand the role table with detailed permission descriptions for each
SparkPost role (admin, developer, templates, reporting).
@danielfsousa danielfsousa force-pushed the docs/scim-okta-groups branch from 8233082 to a36f322 Compare April 16, 2026 14:46
@danielfsousa danielfsousa merged commit 8b994ec into main Apr 17, 2026
5 of 6 checks passed
@danielfsousa danielfsousa deleted the docs/scim-okta-groups branch April 17, 2026 16:22
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