Connect your Okta organization to Provisionr with an OAuth 2.0 API service app that syncs users and manages group membership and app assignments by policy.
If Okta is your Identity Provider (IdP), connecting it is the first thing you’ll do in a new Provisionr workspace, because the first integration that you create becomes your primary integration. You’ll set up Provisionr’s access in your Okta org with a public key and a least-privilege admin role, and then activate the integration so that the first sync can begin.This page covers the setup in this order:
How your primary integration is chosen
How Provisionr authenticates with Okta, and the access levels that you can choose from
The steps in Okta and in Provisionr to connect
Primary Integration
Your primary integration is the source of the unified Directory User profile. It provides each person’s name and email address, their manager relationships and employee ID, and the lifecycle timestamps for when they’re provisioned and deprovisioned as an employee or contractor. Every integration that you add after it enriches Directory Attributes and gives us the user metadata from that vendor, which we use to assign group and resource membership.The first integration that you create becomes your primary integration, and you can’t change it later. We recommend making your IdP your primary integration, because your IdP is the source of truth for Directory Users. If you already have a Google Workspace integration, then Google Workspace is your primary integration.
If Okta is your IdP, you’re in the right place. Create your Okta integration before any other integration so that Okta becomes your primary integration. From then on, each person’s Directory User follows their Okta status between staged, active, and suspended, and a person who is deprovisioned in Okta is deprovisioned in Provisionr as well. Okta Users explains how each Okta status is mapped.
Security Architecture
We authenticate with the Okta API using OAuth 2.0, through an API Services app integration in your Okta organization. Okta doesn’t allow client secrets to be used with the Okta management API, so Provisionr signs each token request with a private key instead, and Okta verifies the signature with the public key that you register on the app. Okta then returns a short-lived access token that is bound to Provisionr with Demonstrating Proof of Possession (DPoP). In other words, there are no passwords or static secrets that could be replayed if they were leaked.You decide what Provisionr can access with the Okta API scopes that you grant to the app and the custom admin role that you assign to it.
Okta OAuth2 Architecture explains each token request, what each Okta API scope and admin role permission allows, and how DPoP protects access tokens.
Access Levels
Provisionr can work with Okta at one of three access levels, and you choose one when you create the integration. Each level has a list of admin role permissions and a list of Okta API scopes with the same name. In the steps below, you’ll select the permissions from the list for your level, and you’ll also grant the scopes from the list with the same name.
Access level
What Provisionr can do in Okta
Groups + App Assignments
Read users, groups, and apps, create groups and manage their members, assign each app’s Provisionr group to its app, and optionally remove the direct app assignments that are left over. This level covers all of the functionality that Provisionr currently supports for Okta.
Groups Only (No App Cleanup)
Read users, groups, and apps, and create groups and manage their members. You assign each app’s Provisionr group to its app in Okta, and you clean up direct app assignments yourself.
Audit (Read-Only)
Read users, groups, and apps without changing anything. The sync reports how far each group whose policy isn’t ignored has drifted from its policy, but it never writes to Okta.
If you’re just getting started, you can begin with Audit (Read-Only). When you’re ready for Provisionr to make changes, you edit the role to add permissions, grant the read-write scopes, and change your access level. Admin Role Permissions explains why Provisionr needs each permission, and Access Levels and Policy Modes shows which sync stages run at each access level.
Connection Test
When you activate your integration, Provisionr tests your Okta app against the access level that you chose. Each access level is a set of capabilities, and a capability is one thing that Provisionr can do in Okta, such as reading users or adding someone to a group. The integration stays staged until every capability in your level passes, so a missing scope or admin role permission shows up right away instead of during a sync. Capabilities lists each one.
Access level
What Provisionr tests
Audit (Read-Only)
Reads one user, one group, the members of that group, and one app. Nothing in Okta changes.
Groups Only (No App Cleanup)
The same reads, and then adds a user to the test group and removes them.
Groups + App Assignments
Everything above, and confirms that Okta grants the okta.apps.manage scope.
The Test Group
The two levels that write to Okta use a group named provisionr.connection-test. We use a group of our own because adding someone to a real group could give them its apps. The group stays empty between tests, and it should never have apps assigned. If it does, the test stops without adding anyone.Provisionr looks for the group by name and creates it if it’s missing. If your admin role can’t create groups, activation stops and asks you to create the group yourself. A group that you create counts for the test, so Provisionr then only confirms that Okta grants the scope for creating groups. Create a group in Okta named exactly provisionr.connection-test, leave it with no apps, and run prv okta-integration:activate again.Each write test adds two entries to your Okta System Log, one when the user is added and one when they’re removed. A passing test proves that Provisionr can change the members of this group. If you use a narrower resource set, make sure that it also includes the groups that your policies manage.
Testing Again
You can test your integration at any time with this Provisionr CLI command.
prv okta-integration:healthcheck
The command shows the result of each capability, and a failure doesn’t deactivate anything. Provisionr only uses a capability that’s in your access level and that the last test passed, so if the write test fails, you can’t change a policy to additive or authoritative until it passes.
Result
What it means
verified
A real call to Okta worked.
granted
Okta issued the scope, and there’s no safe way to test further.
denied
Okta refused, or the test couldn’t be set up. The details say what to change.
error
The test couldn’t finish, so nothing is known. You can run it again.
skipped
It wasn’t tested, because something that it depends on failed first.
To change your access level, first update the admin role and the scopes in Okta, and then run this command. Provisionr tests your Okta app against the new level, and only saves it if the test passes.
prv okta-integration:update
Connecting Okta
Provisionr connects to Okta with a Provisionr-managed key. We generate the key pair for you inside Cloud KMS, and the private key can’t be exported by anyone, including us, so you only need to paste the public key into Okta.You keep full control of what Provisionr can access through the scopes and admin role that you assign to the app, and you can revoke access at any time from the Okta Admin Console.
1
Creating the Okta Integration
Start by creating a new Okta integration in your workspace with the Provisionr CLI.
prv okta-integration:create
The CLI prompts you for your Okta org URL, such as https://redshirt.okta.com, the environment type, and your access level. Okta Preview orgs (*.oktapreview.com) and custom domains are supported as well.Your integration is created in a staged state. Your workspace generates a key pair automatically and displays the public key as a JSON Web Key (JWK). The key ID (kid) starts with provisionr-, so that you can recognize it in Okta.
Keep your terminal open. After you create the app in the Okta Admin Console in the steps that follow, you’ll come back to the CLI prompt to enter the app’s Client ID. If you close your terminal, run prv okta-integration:credentials to see the public key again and enter the Client ID.
2
Okta Super Administrator Role
The steps in Okta need an account with the Super Administrator role, because Okta only allows a Super Administrator to grant API scopes to an app and to create custom admin roles.If you don’t have that permission, ask your Okta administrator to perform these steps, and share the public key from the previous step with them.
Never assign the Super Administrator role to the Provisionr app itself. You’ll assign it a least-privilege custom admin role in an upcoming step.
3
Creating the Custom Admin Role
Okta API scopes control which API endpoints Provisionr can call, and an admin role controls which actions Provisionr can take on those endpoints, so your app needs both. Scopes and Admin Roles explains how the two work together.In the Okta Admin Console, go to Security > Administrators, open the Roles tab, and click Create new role. Fill in the role with these values:
Role name:Provisionr Sync
Role description:This is a custom role that allows Provisionr to view apps, users, and manage groups and group members.
Select the permissions in the list for your access level, and click Save role. Each list has the same name as the list of Okta API scopes that you’ll grant in an upcoming step.If you’re just getting started, you can start with Audit (Read-Only) and edit the role to add permissions when you’re ready for Provisionr to make changes.
Application- View application and their details- Edit application's user or group assignmentsGroup- View groups and their details- Create groups- Manage group membership- Edit groups' application assignmentsUser- View users' profile attributes- View users and their details- Edit users' group membership- Edit users' application assignments
Application- View application and their details- Edit application's user or group assignmentsGroup- View groups and their details- Create groups- Manage group membershipUser- View users' profile attributes- View users and their details- Edit users' group membership
Application- View application and their detailsGroup- View groups and their detailsUser- View users' profile attributes- View users and their details
The screenshots show the Groups + App Assignments permissions, and you can click a screenshot to enlarge it.
Application permissions
Selecting Manage groups also works, but we select each permission for least-privilege clarity.
User permissions
Okta requires Edit application’s user or group assignments before Provisionr can change group members or app assignments, even when the group and user permissions are selected.
4
Creating the API Services App
In the Okta Admin Console, go to Applications and Resources > Applications and click Create App Integration.Select the Classic experience tab. These steps use the Classic experience because the new Okta Integration Wizard is still changing frequently.
Select API Services as the sign-in method, and click Next.
Fill in the app with these values:
App integration name:Provisionr Sync
Client definition:Use Okta-generated client ID
Click Save.
5
Adding the Public Key
On the General tab of your new app, find the Public keys section and click Edit.
Leave Configuration set to Save keys in Okta, and click Add key.
Paste the entire public key JWK that the Provisionr CLI displayed in the first step, and click Done. Don’t click Generate new key, because Provisionr can only sign with the key pair that it generated. You can ignore the Key Size option, which only applies to keys that Okta generates.
The key is listed as Inactive until you change the client authentication method in the next step. Click Save.
6
Enabling Public Key Authentication
In the Client Credentials section, click Edit.
Select Public key / Private key for Client authentication, and click Save.
A client secret can’t be used instead. Okta only supports public key authentication for the Okta API scopes that Provisionr uses, so client secrets can’t be used to access the Okta management API.
Okta warns that the existing client secrets will be deleted. Provisionr doesn’t use client secrets, so click Save.Your public key is now Active.
7
Requiring DPoP
On the General tab, make sure that Require Demonstrating Proof of Possession (DPoP) header in token requests is selected. If it isn’t, click Edit in that section, select it, and click Save.With DPoP, Provisionr binds every access token to a key that only Provisionr has, so a leaked access token can’t be replayed by anyone else. Demonstrating Proof of Possession explains how it works.
8
Saving the Client ID
Copy the Client ID from the Client Credentials section and paste it at the Provisionr CLI prompt.Provisionr saves the Client ID with your staged integration. The Client ID is a public identifier, not a secret.
9
Granting Okta API Scopes
Provisionr needs Okta API scopes to read Okta users and apps and to manage groups and group members. OAuth2 Scopes describes what each scope allows.Open the Okta API Scopes tab of your app, and click Grant next to each scope in the list that matches the admin role permissions that you selected.
okta.users.readokta.groups.manageokta.apps.manage
okta.users.readokta.groups.manageokta.apps.read
okta.users.readokta.groups.readokta.apps.read
Okta API Scopes tab
10
Assigning the Admin Role
Go to Applications > Applications, open the Provisionr Sync app, open the Admin roles tab, and click Edit assignments.
Select the Provisionr Sync role and the default resource set, such as All Users, and click Save Changes. Okta may ask you to authenticate again.You can ignore the warning that the resource set includes resources that aren’t affected by the permissions in the role.
After you save, check that the Admin roles tab lists only the Provisionr Sync role. If it also lists Super Administrator, remove it.Okta’s Public client app admins org setting can assign the Super Administrator role to API service apps automatically when scopes are granted. Okta recommends turning off this setting once you assign admin roles to apps yourself.
11
Activating the Integration
Now that you’ve registered the public key, granted the Okta API scopes, and assigned the admin role, activate your Okta integration with the Provisionr CLI.
prv okta-integration:activate
The command runs the connection test for your access level. If it passes, the integration is activated, and the initial sync of your Okta users, groups, and apps into Provisionr begins. If it doesn’t, the command shows the reason, and you can run it again after you fix the app in Okta.How the Okta Sync Works walks through what each sync does, and Okta OAuth2 Architecture explains how Provisionr authenticates with Okta along the way.
Once your integration is active, the first sync reads your Okta users, groups, and apps into Provisionr. The next page looks more closely at how Provisionr authenticates with Okta, and at what each scope and admin role permission allows.Continue reading: Okta OAuth2 Architecture →
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Provisionr","colors":{"primary":"#d946ef","light":"#d946ef","dark":"#d946ef"},"logo":{"light":"https://mintcdn.com/provisionr/5ukSD9JI1H_kpmU4/logo/light.svg?fit=max\u0026auto=format\u0026n=5ukSD9JI1H_kpmU4\u0026q=85\u0026s=6dc390c4a465580ff27f8fe8d49a11fc","dark":"https://mintcdn.com/provisionr/5ukSD9JI1H_kpmU4/logo/dark.svg?fit=max\u0026auto=format\u0026n=5ukSD9JI1H_kpmU4\u0026q=85\u0026s=f625db342df2b8e7f8a556e48af38b72"},"favicon":"https://mintcdn.com/provisionr/9LyziSRkPeMlxOSc/favicon.png?fit=max\u0026auto=format\u0026n=9LyziSRkPeMlxOSc\u0026q=85\u0026s=8b0e87185aa48df7f1a68a2c0fd8e328","api":{"playground":{"display":"simple"},"examples":{"languages":["curl","powershell","python","laravel","javascript"]}},"navbar":{"links":[],"primary":{"type":"button","label":"Workspace HQ","href":"https://hq.provisionr.io"}},"footer":{"socials":{"website":"https://provisionr.io","slack":"https://community.provisionr.io","x":"https://x.com/provisionr_io","linkedin":"https://www.linkedin.com/company/provisionr-io","github":"https://github.com/provisionr-io","youtube":"https://www.youtube.com/@provisionr"}},"fonts":{"heading":{"family":"IBM Plex Sans"},"body":{"family":"IBM Plex Sans"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Documentation","icon":"file-lines","href":"https://docs.provisionr.io"},{"anchor":"Workspace HQ","icon":"server","href":"https://hq.provisionr.io"},{"anchor":"Slack Community","icon":"slack","href":"https://community.provisionr.io"},{"anchor":"Support Ticket","icon":"comments","href":"https://docs.provisionr.io/support/help"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"provisionr","hasAudioNarration":false,"actualSubdomain":"provisionr","customDomains":["docs.provisionr.io"],"gitSource":{"type":"github","owner":"provisionr-io","repo":"doc","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afa11cdf773a48258659ef4","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"API Endpoints","count":153},{"language":"default","tag":"CLI Commands","count":151},{"language":"default","tag":"Endpoints","count":149},{"language":"default","tag":"Commands","count":144},{"language":"default","tag":"Runbooks","count":21},{"language":"default","tag":"Billing","count":20},{"language":"default","tag":"Why Provisionr","count":19},{"language":"default","tag":"Workforce Identity Foundations","count":16},{"language":"default","tag":"Concepts","count":13},{"language":"default","tag":"Coming Soon","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"@import url('https://googleapis.com');.prose,.prose p,.prose li,.prose ul,.prose ol,.prose h1,.prose h2,.prose h3,.prose h4{line-height:1.6!important}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.5em}.code-block{margin-bottom:1.25rem!important}.steps{margin-top:1.5rem!important}code,pre,kbd,samp,.token{font-family:'IBM Plex Mono', monospace!important;line-height:1.1rem}kbd{margin-left:3px;margin-right:3px;padding-top:0.1em!important;padding-bottom:0.1em!important;font-weight:600!important}img.nav-logo{height:1.75rem!important}.mintlify-container .some-content-class{max-width:1600px!important;width:90%!important}.styled-feature-list{list-style:none;padding:0;margin:0}.styled-feature-list .group-title{display:flex;align-items:center;gap:0.5rem;font-weight:600;font-size:0.95rem;color:var(--primary);margin-bottom:0.5rem;padding:0.25rem 0}.styled-feature-list,.styled-feature-list ul,.styled-feature-list li{list-style:none!important;list-style-type:none!important}.styled-feature-list>li{margin-left:0!important;padding-left:0!important;list-style:none!important;list-style-type:none!important}.styled-feature-list>li::before,.styled-feature-list>li::marker{content:none!important;display:none!important}.styled-feature-list .group-items{margin-left:0!important;padding-left:0!important;margin-bottom:1rem}.styled-feature-list .group-items .feature-item{list-style:none!important;list-style-type:none!important}.styled-feature-list .group-items .feature-item::before{content:none!important;display:none!important}.styled-feature-list .group-items .feature-item::marker{content:none!important;display:none!important}.styled-feature-list .feature-item{display:flex;align-items:center;gap:0.5rem;padding:0.25rem 0;font-size:0.875rem;line-height:1.5;background:transparent!important}.styled-feature-list .feature-item:hover{background:transparent!important}.styled-feature-list .feature-item i{color:#22c55e;width:1rem;flex-shrink:0}.styled-feature-list .feature-item.highlight{background-color:rgba(217, 70, 239, 0.1)!important;border-radius:4px;padding:0.375rem 0.5rem}.styled-feature-list .feature-item.highlight:hover{background-color:rgba(217, 70, 239, 0.1)!important}.styled-feature-list .feature-item.highlight i{color:var(--primary)}.styled-feature-list .badge{font-size:0.7rem;padding:0.125rem 0.375rem;border-radius:9999px;background-color:#6366f1;color:white;font-weight:500;margin-left:auto}table td{min-width:10px!important}"}],"page":{"pagePath":"integrations/okta/connect","slug":"/integrations/okta/connect","pageMetadata":{"title":"Connect to Okta","description":"Connect your Okta organization to Provisionr with an OAuth 2.0 API service app that syncs users and manages group membership and app assignments by policy.","icon":"link","mode":"wide","href":"/integrations/okta/connect"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect your Okta organization to Provisionr with an OAuth 2.0 API service app that syncs users and manages group membership and app assignments by policy.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Columns,Frame,Heading,Info,Note,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`If Okta is your Identity Provider (IdP), connecting it is the first thing you’ll do in a new Provisionr workspace, because the first integration that you create becomes your primary integration. You’ll set up Provisionr’s access in your Okta org with a public key and a least-privilege admin role, and then activate the integration so that the first sync can begin.`}),`\n`,_jsx(_components.p,{children:`This page covers the setup in this order:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`How your primary integration is chosen`}),`\n`,_jsx(_components.li,{children:`How Provisionr authenticates with Okta, and the access levels that you can choose from`}),`\n`,_jsx(_components.li,{children:`The steps in Okta and in Provisionr to connect`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`primary-integration`,children:`Primary Integration`}),`\n`,_jsxs(_components.p,{children:[`Your `,_jsx(_components.strong,{children:`primary integration`}),` is the source of the unified Directory User profile. It provides each person’s name and email address, their manager relationships and employee ID, and the lifecycle timestamps for when they’re provisioned and deprovisioned as an employee or contractor. Every integration that you add after it enriches Directory Attributes and gives us the user metadata from that vendor, which we use to assign group and resource membership.`]}),`\n`,_jsx(_components.p,{children:`The first integration that you create becomes your primary integration, and you can’t change it later. We recommend making your IdP your primary integration, because your IdP is the source of truth for Directory Users. If you already have a Google Workspace integration, then Google Workspace is your primary integration.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`If Google Workspace is your IdP instead of Okta, stop here and `,_jsx(_components.a,{href:`/integrations/google/connect`,children:`create the Google Workspace integration`}),` before you create your Okta integration.`]})}),`\n`,_jsxs(_components.p,{children:[`If Okta is your IdP, you’re in the right place. Create your Okta integration before any other integration so that Okta becomes your primary integration. From then on, each person’s Directory User follows their Okta status between staged, active, and suspended, and a person who is deprovisioned in Okta is deprovisioned in Provisionr as well. `,_jsx(_components.a,{href:`/integrations/okta/users`,children:`Okta Users`}),` explains how each Okta status is mapped.`]}),`\n`,_jsx(Heading,{level:`2`,id:`security-architecture`,children:`Security Architecture`}),`\n`,_jsx(_components.p,{children:`We authenticate with the Okta API using OAuth 2.0, through an API Services app integration in your Okta organization. Okta doesn’t allow client secrets to be used with the Okta management API, so Provisionr signs each token request with a private key instead, and Okta verifies the signature with the public key that you register on the app. Okta then returns a short-lived access token that is bound to Provisionr with Demonstrating Proof of Possession (DPoP). In other words, there are no passwords or static secrets that could be replayed if they were leaked.`}),`\n`,_jsx(_components.p,{children:`You decide what Provisionr can access with the Okta API scopes that you grant to the app and the custom admin role that you assign to it.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/integrations/okta/oauth2`,children:`Okta OAuth2 Architecture`}),` explains each token request, what each Okta API scope and admin role permission allows, and how DPoP protects access tokens.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`access-levels`,children:`Access Levels`}),`\n`,_jsx(_components.p,{children:`Provisionr can work with Okta at one of three access levels, and you choose one when you create the integration. Each level has a list of admin role permissions and a list of Okta API scopes with the same name. In the steps below, you’ll select the permissions from the list for your level, and you’ll also grant the scopes from the list with the same name.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Access level`}),_jsx(_components.th,{children:`What Provisionr can do in Okta`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Groups + App Assignments`}),_jsxs(_components.td,{children:[`Read users, groups, and apps, create groups and manage their members, assign each app’s `,_jsx(_components.a,{href:`/integrations/okta/apps#provisionr-groups`,children:`Provisionr group`}),` to its app, and optionally remove the direct app assignments that are left over. This level covers all of the functionality that Provisionr currently supports for Okta.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Groups Only (No App Cleanup)`}),_jsx(_components.td,{children:`Read users, groups, and apps, and create groups and manage their members. You assign each app’s Provisionr group to its app in Okta, and you clean up direct app assignments yourself.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Audit (Read-Only)`}),_jsx(_components.td,{children:`Read users, groups, and apps without changing anything. The sync reports how far each group whose policy isn’t ignored has drifted from its policy, but it never writes to Okta.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`If you’re just getting started, you can begin with `,_jsx(_components.strong,{children:`Audit (Read-Only)`}),`. When you’re ready for Provisionr to make changes, you edit the role to add permissions, grant the read-write scopes, and `,_jsx(_components.a,{href:`#testing-again`,children:`change your access level`}),`. `,_jsx(_components.a,{href:`/integrations/okta/oauth2#admin-role-permissions`,children:`Admin Role Permissions`}),` explains why Provisionr needs each permission, and `,_jsx(_components.a,{href:`/integrations/okta/sync#access-levels-and-policy-modes`,children:`Access Levels and Policy Modes`}),` shows which sync stages run at each access level.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connection-test`,children:`Connection Test`}),`\n`,_jsxs(_components.p,{children:[`When you activate your integration, Provisionr tests your Okta app against the access level that you chose. Each access level is a set of capabilities, and a capability is one thing that Provisionr can do in Okta, such as reading users or adding someone to a group. The integration stays staged until every capability in your level passes, so a missing scope or admin role permission shows up right away instead of during a sync. `,_jsx(_components.a,{href:`/integrations/okta/oauth2#capabilities`,children:`Capabilities`}),` lists each one.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Access level`}),_jsx(_components.th,{children:`What Provisionr tests`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Audit (Read-Only)`}),_jsx(_components.td,{children:`Reads one user, one group, the members of that group, and one app. Nothing in Okta changes.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Groups Only (No App Cleanup)`}),_jsx(_components.td,{children:`The same reads, and then adds a user to the test group and removes them.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Groups + App Assignments`}),_jsxs(_components.td,{children:[`Everything above, and confirms that Okta grants the `,_jsx(_components.code,{children:`okta.apps.manage`}),` scope.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`the-test-group`,children:`The Test Group`}),`\n`,_jsxs(_components.p,{children:[`The two levels that write to Okta use a group named `,_jsx(_components.code,{children:`provisionr.connection-test`}),`. We use a group of our own because adding someone to a real group could give them its apps. The group stays empty between tests, and it should never have apps assigned. If it does, the test stops without adding anyone.`]}),`\n`,_jsxs(_components.p,{children:[`Provisionr looks for the group by name and creates it if it’s missing. If your admin role can’t create groups, activation stops and asks you to create the group yourself. A group that you create counts for the test, so Provisionr then only confirms that Okta grants the scope for creating groups. Create a group in Okta named exactly `,_jsx(_components.code,{children:`provisionr.connection-test`}),`, leave it with no apps, and run `,_jsx(_components.code,{children:`prv okta-integration:activate`}),` again.`]}),`\n`,_jsx(_components.p,{children:`Each write test adds two entries to your Okta System Log, one when the user is added and one when they’re removed. A passing test proves that Provisionr can change the members of this group. If you use a narrower resource set, make sure that it also includes the groups that your policies manage.`}),`\n`,_jsx(Heading,{level:`3`,id:`testing-again`,children:`Testing Again`}),`\n`,_jsx(_components.p,{children:`You can test your integration at any time with this Provisionr CLI command.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` okta-integration:healthcheck`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The command shows the result of each capability, and a failure doesn’t deactivate anything. Provisionr only uses a capability that’s in your access level and that the last test passed, so if the write test fails, you can’t change a policy to `,_jsx(_components.code,{children:`additive`}),` or `,_jsx(_components.code,{children:`authoritative`}),` until it passes.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Result`}),_jsx(_components.th,{children:`What it means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`verified`})}),_jsx(_components.td,{children:`A real call to Okta worked.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`granted`})}),_jsx(_components.td,{children:`Okta issued the scope, and there’s no safe way to test further.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`denied`})}),_jsx(_components.td,{children:`Okta refused, or the test couldn’t be set up. The details say what to change.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`error`})}),_jsx(_components.td,{children:`The test couldn’t finish, so nothing is known. You can run it again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`skipped`})}),_jsx(_components.td,{children:`It wasn’t tested, because something that it depends on failed first.`})]})]})]}),`\n`,_jsx(_components.p,{children:`To change your access level, first update the admin role and the scopes in Okta, and then run this command. Provisionr tests your Okta app against the new level, and only saves it if the test passes.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` okta-integration:update`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`connecting-okta`,children:`Connecting Okta`}),`\n`,_jsx(_components.p,{children:`Provisionr connects to Okta with a Provisionr-managed key. We generate the key pair for you inside Cloud KMS, and the private key can’t be exported by anyone, including us, so you only need to paste the public key into Okta.`}),`\n`,_jsx(_components.p,{children:`You keep full control of what Provisionr can access through the scopes and admin role that you assign to the app, and you can revoke access at any time from the Okta Admin Console.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Creating the Okta Integration`,children:[_jsx(_components.p,{children:`Start by creating a new Okta integration in your workspace with the Provisionr CLI.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` okta-integration:create`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`The CLI prompts you for your Okta org URL, such as `,_jsx(_components.code,{children:`https://redshirt.okta.com`}),`, the environment type, and your `,_jsx(_components.a,{href:`#access-levels`,children:`access level`}),`. Okta Preview orgs (`,_jsx(_components.code,{children:`*.oktapreview.com`}),`) and custom domains are supported as well.`]}),_jsxs(_components.p,{children:[`Your integration is created in a staged state. Your workspace generates a key pair automatically and displays the public key as a JSON Web Key (JWK). The key ID (`,_jsx(_components.code,{children:`kid`}),`) starts with `,_jsx(_components.code,{children:`provisionr-`}),`, so that you can recognize it in Okta.`]}),_jsx(CodeBlock,{filename:`Provisionr Public Key JWK`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"kty\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"RSA\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"use\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sig\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"alg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"RS256\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"kid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"provisionr-xxxxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"n\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ztw2iIbWGJfojk9L2utsKns5nr_r_Bc0efbphBnRnPVCm_ugT...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"e\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AQAB\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Keep your terminal open. After you create the app in the Okta Admin Console in the steps that follow, you’ll come back to the CLI prompt to enter the app’s Client ID. If you close your terminal, run `,_jsx(_components.code,{children:`prv okta-integration:credentials`}),` to see the public key again and enter the Client ID.`]})]}),_jsxs(Step,{title:`Okta Super Administrator Role`,children:[_jsxs(_components.p,{children:[`The steps in Okta need an account with the `,_jsx(_components.code,{children:`Super Administrator`}),` role, because Okta only allows a Super Administrator to `,_jsx(_components.a,{href:`https://developer.okta.com/docs/guides/implement-oauth-for-okta-serviceapp/main/`,children:`grant API scopes`}),` to an app and to create custom admin roles.`]}),_jsx(_components.p,{children:`If you don’t have that permission, ask your Okta administrator to perform these steps, and share the public key from the previous step with them.`}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Never assign the `,_jsx(_components.code,{children:`Super Administrator`}),` role to the Provisionr app itself. You’ll assign it a least-privilege custom admin role in an upcoming step.`]})})]}),_jsxs(Step,{title:`Creating the Custom Admin Role`,children:[_jsxs(_components.p,{children:[`Okta API scopes control which API endpoints Provisionr can call, and an admin role controls which actions Provisionr can take on those endpoints, so your app needs both. `,_jsx(_components.a,{href:`/integrations/okta/oauth2#scopes-and-admin-roles`,children:`Scopes and Admin Roles`}),` explains how the two work together.`]}),_jsxs(_components.p,{children:[`In the Okta Admin Console, go to `,_jsx(_components.strong,{children:`Security > Administrators`}),`, open the `,_jsx(_components.strong,{children:`Roles`}),` tab, and click `,_jsx(_components.strong,{children:`Create new role`}),`. Fill in the role with these values:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Role name:`}),` `,_jsx(_components.code,{children:`Provisionr Sync`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Role description:`}),` `,_jsx(_components.code,{children:`This is a custom role that allows Provisionr to view apps, users, and manage groups and group members.`})]}),`\n`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-create.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=a74fc1a4918bd1857d4949cba9972128`,alt:`Okta Create new role form with the name Provisionr Sync`,\"data-og-width\":`2762`,width:`2762`,\"data-og-height\":`1036`,height:`1036`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-role-create.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-create.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=587b92d6413493435de42688770ca617 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-create.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=02bb144e159beebcfbd5e0cf612b042b 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-create.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=cb391f4485588f3bb0c9cfddedf1ebf7 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-create.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=cb75f5ca8edeff5f4b685f40026e7258 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-create.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=28535e89ad83a61fcb087ed0740f7621 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-create.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=742c4848daf7c2e45766df79045bb537 2500w`})}),_jsxs(_components.p,{children:[`Select the permissions in the list for your `,_jsx(_components.a,{href:`#access-levels`,children:`access level`}),`, and click `,_jsx(_components.strong,{children:`Save role`}),`. Each list has the same name as the list of Okta API scopes that you’ll grant in an upcoming step.`]}),_jsxs(_components.p,{children:[`If you’re just getting started, you can start with `,_jsx(_components.strong,{children:`Audit (Read-Only)`}),` and edit the role to add permissions when you’re ready for Provisionr to make changes.`]}),_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Groups + App Assignments`,numberOfLines:`16`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Application`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View application and their details`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Edit application's user or group assignments`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Group`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View groups and their details`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Create groups`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Manage group membership`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Edit groups' application assignments`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`User`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View users' profile attributes`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View users and their details`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Edit users' group membership`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Edit users' application assignments`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:`Groups Only (No App Cleanup)`,numberOfLines:`14`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`14`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Application`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View application and their details`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Edit application's user or group assignments`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Group`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View groups and their details`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Create groups`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Manage group membership`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`User`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View users' profile attributes`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View users and their details`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Edit users' group membership`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:`Audit (Read-Only)`,numberOfLines:`10`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Application`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View application and their details`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Group`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View groups and their details`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`User`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View users' profile attributes`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- View users and their details`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(_components.p,{children:[`The screenshots show the `,_jsx(_components.strong,{children:`Groups + App Assignments`}),` permissions, and you can click a screenshot to enlarge it.`]}),_jsxs(Columns,{cols:2,children:[_jsxs(`div`,{className:`mint-flex mint-flex-col mint-gap-4`,children:[_jsx(Frame,{caption:`Application permissions`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-application.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=de38e3235d472b99df255f5728dbb9eb`,alt:`Okta Application permissions with View application and Edit application's user or group assignments selected`,\"data-og-width\":`1724`,width:`1724`,\"data-og-height\":`1192`,height:`1192`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-role-permissions-application.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-application.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=8554ef579fac069986d87471c28ff85e 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-application.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=5e7c9dd93914c9bf558552c801805123 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-application.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=cdef0435804ddb9364dc901c33cee1ec 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-application.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=6346e753fdcc1d7f4592612709c8121a 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-application.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=858c060d7d996403069f30dfb17494fc 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-application.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=3d505f37b165a8be6d9c409b52e5c91a 2500w`})}),_jsx(Frame,{caption:`Selecting Manage groups also works, but we select each permission for least-privilege clarity.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-group-option-2.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=aa8f6266ce308fca2db292412feb1257`,alt:`Okta Group permissions with four individual permissions selected`,\"data-og-width\":`1700`,width:`1700`,\"data-og-height\":`824`,height:`824`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-role-permissions-group-option-2.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-group-option-2.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=f91dc6974034803be6669e66c61b8a80 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-group-option-2.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=52e57170a78bb08a5f4adebf0ffa750c 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-group-option-2.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=2f81455752211bbaffaa7d3209ce1624 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-group-option-2.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=044bc8e84e2a930e75dcd0b28b084ca5 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-group-option-2.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=49f7b0c94f74c692c501923e6f68a5b2 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-group-option-2.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=b901afe750990d0d9410a9ba112a254c 2500w`})})]}),_jsx(Frame,{caption:`User permissions`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-user.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=8946db966d8e15c6252c90049b829004`,alt:`Okta User permissions with four permissions selected`,\"data-og-width\":`1758`,width:`1758`,\"data-og-height\":`2588`,height:`2588`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-role-permissions-user.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-user.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=22b7348a8b690f003fb28626b2e4861d 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-user.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=4ce4268dd1b215480cbb5105334accda 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-user.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=c5f3a7644fc3320fca21d7cdffc030b6 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-user.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=7deed840c4c97ef0f0b03cd8bf20b968 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-user.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=ecbca7ab3232ab8f25f2f129375b9900 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-role-permissions-user.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=f4d64aec31e2126912e048eff2dc7251 2500w`})})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Okta requires `,_jsx(_components.strong,{children:`Edit application’s user or group assignments`}),` before Provisionr can change group members or app assignments, even when the group and user permissions are selected.`]})})]}),_jsxs(Step,{title:`Creating the API Services App`,children:[_jsxs(_components.p,{children:[`In the Okta Admin Console, go to `,_jsx(_components.strong,{children:`Applications and Resources > Applications`}),` and click `,_jsx(_components.strong,{children:`Create App Integration`}),`.`]}),_jsxs(_components.p,{children:[`Select the `,_jsx(_components.strong,{children:`Classic experience`}),` tab. These steps use the Classic experience because the new Okta Integration Wizard is still changing frequently.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-classic-experience.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=aa55d8fba6f41010d7a67b1641c34a36`,alt:`Okta Create App Integration dialog with the Classic experience tab highlighted`,\"data-og-width\":`2246`,width:`2246`,\"data-og-height\":`1696`,height:`1696`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-app-classic-experience.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-classic-experience.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=50b8b9a8c639f525df97a92548b91235 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-classic-experience.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=f0b13812390b4f4bd7268b91f59a70f6 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-classic-experience.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=6e66797f3b117a0ebbcdf38e4e6cb601 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-classic-experience.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=25b6c6941c9040e6a83f1de7babf4102 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-classic-experience.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=7d9a7f7895f46a386839251ed36eb01f 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-classic-experience.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=cde6f044164408ef8cdb9df35eb0c02a 2500w`})}),_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`API Services`}),` as the sign-in method, and click `,_jsx(_components.strong,{children:`Next`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-api-services.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=3b9174088fb6187b628332ca1caca635`,alt:`Okta Classic experience sign-in method options with API Services selected`,\"data-og-width\":`2252`,width:`2252`,\"data-og-height\":`1698`,height:`1698`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-app-api-services.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-api-services.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=870c7eeed71029bc998d146773dff834 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-api-services.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=4ea5e94cdb56ea93cae64e192d537fec 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-api-services.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=bf3f574b22c191eea53a0424f7e0faf3 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-api-services.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=9ee386cab0539be1825f7f65908155aa 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-api-services.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=e06d0fd67490649e5289d4850202ffaf 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-api-services.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=4da5d339923dafa445445633c72e0db0 2500w`})}),_jsx(_components.p,{children:`Fill in the app with these values:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`App integration name:`}),` `,_jsx(_components.code,{children:`Provisionr Sync`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Client definition:`}),` `,_jsx(_components.code,{children:`Use Okta-generated client ID`})]}),`\n`]}),_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-name.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=ef5ddaee00242b063af23b87655d7f58`,alt:`New API Services App Integration form with the name Provisionr Sync`,\"data-og-width\":`1876`,width:`1876`,\"data-og-height\":`902`,height:`902`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-app-name.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-name.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=863b281d7a006566a07cef6b4b2eff4a 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-name.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=9e7e83bd7628e937dc91116c21c8bdc3 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-name.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=7b8643cecd48456c0aae0edd405e5b24 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-name.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=29ceb154cad41f91e73c0c55641a5340 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-name.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=75c4e3614c1eb05c513650ea56719d08 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-app-name.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=0c2c532e4370e05544dbda36980a8d99 2500w`})})]}),_jsxs(Step,{title:`Adding the Public Key`,children:[_jsxs(_components.p,{children:[`On the `,_jsx(_components.strong,{children:`General`}),` tab of your new app, find the `,_jsx(_components.strong,{children:`Public keys`}),` section and click `,_jsx(_components.strong,{children:`Edit`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-edit.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=424a87d2466401147d22ccb9ea0552b0`,alt:`Okta app Client Credentials and Public keys sections with the Public keys Edit link highlighted`,\"data-og-width\":`1462`,width:`1462`,\"data-og-height\":`1461`,height:`1461`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-public-keys-edit.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-edit.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=13d09888e88935bf80898114bd3c6dd1 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-edit.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=b61d607d9af7abf0ab9d36d1849cfb91 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-edit.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=bd1759e164aa46d2951a3de5a3bf6135 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-edit.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=db0d1459009cf087507dfe991554db72 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-edit.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=498bfde7b0d4ef5a2bf20da264872cc1 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-edit.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=0a6bf542cfd5b5bf748a17a8c12ac468 2500w`})}),_jsxs(_components.p,{children:[`Leave `,_jsx(_components.strong,{children:`Configuration`}),` set to `,_jsx(_components.strong,{children:`Save keys in Okta`}),`, and click `,_jsx(_components.strong,{children:`Add key`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-add.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=18dcfde57adb9d552ec0cc17b149335c`,alt:`Okta Public keys section in edit mode with the Add key button highlighted`,\"data-og-width\":`1510`,width:`1510`,\"data-og-height\":`1086`,height:`1086`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-public-keys-add.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-add.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=b23725830d38b8075d95c6e7d2cac7e5 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-add.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=819a195d69f836936738afa00a343c96 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-add.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=8fead108c2f5d273c13351ea3c665f1e 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-add.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=7338a39207315edb3382c8788e4e1f48 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-add.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=32d49c143013977ab67e383ec12884db 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-keys-add.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=3fcf5343c1da5a9f5a68845e08d017ad 2500w`})}),_jsxs(_components.p,{children:[`Paste the entire public key JWK that the Provisionr CLI displayed in the first step, and click `,_jsx(_components.strong,{children:`Done`}),`. Don’t click `,_jsx(_components.strong,{children:`Generate new key`}),`, because Provisionr can only sign with the key pair that it generated. You can ignore the `,_jsx(_components.strong,{children:`Key Size`}),` option, which only applies to keys that Okta generates.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-paste.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=7df8aec8b8ff1a271287253b2dd4d71d`,alt:`Okta Add a public key dialog with the Provisionr public key JWK pasted`,\"data-og-width\":`1376`,width:`1376`,\"data-og-height\":`1046`,height:`1046`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-public-key-paste.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-paste.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=e46f5ccf198221d9e629e3cc5b47ac00 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-paste.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=940dd2d23855ae48f14d26b5be9b9986 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-paste.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=6e5052ef0ca16ebbdab1813bc0710c01 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-paste.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=d0b05bdac5711b1abc1fc6e6332cd5ff 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-paste.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=709e62293d35a7444e89a1b380493ab4 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-paste.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=5f9beae29b05b2f95545fcf2dabdfb1d 2500w`})}),_jsxs(_components.p,{children:[`The key is listed as `,_jsx(_components.code,{children:`Inactive`}),` until you change the client authentication method in the next step. Click `,_jsx(_components.strong,{children:`Save`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-save.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=34073da13fbd844b2f930ebe74f325f2`,alt:`Okta Public keys table with the inactive Provisionr key and the Save button highlighted`,\"data-og-width\":`1500`,width:`1500`,\"data-og-height\":`1000`,height:`1000`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-public-key-save.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-save.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=b85d6ecce2ea14839adef887f4aa3698 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-save.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=74a5f66fe89875e1849b59296f90c2a4 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-save.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=78c26b7add76b1f029c2e1d4b1312e79 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-save.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=f11ac5495656b63861b304ef18cb4501 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-save.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=1648e5bbc520bf60d68e8e3446641634 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-save.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=3dc00a5ad49b6080662ee8120476ba69 2500w`})})]}),_jsxs(Step,{title:`Enabling Public Key Authentication`,children:[_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Client Credentials`}),` section, click `,_jsx(_components.strong,{children:`Edit`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-edit.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=ec2c4de4830e01d0769771186d6fcfb7`,alt:`Okta Client Credentials section with the Edit link highlighted`,\"data-og-width\":`1506`,width:`1506`,\"data-og-height\":`1246`,height:`1246`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-client-credentials-edit.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-edit.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=00436b0e220ac2b284bd41f4471fab94 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-edit.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=6ae889bd5afc8e5170da986aae6d0737 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-edit.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=c91e636e23f11f3d358e80e965ab6686 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-edit.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=16550115b947bf7d8b046ec509d86269 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-edit.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=6650b1f494de535db98df0c60e1053c4 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-edit.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=81435ea516f865dc20a95cd90a35aa62 2500w`})}),_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Public key / Private key`}),` for `,_jsx(_components.strong,{children:`Client authentication`}),`, and click `,_jsx(_components.strong,{children:`Save`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-public-key.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=98b5e821282dbb07fc8bcd22c6b1d99a`,alt:`Okta Client authentication set to Public key / Private key`,\"data-og-width\":`1376`,width:`1376`,\"data-og-height\":`306`,height:`306`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-client-credentials-public-key.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-public-key.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=ae2e66c33d5311bc45038e2ab3e7f371 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-public-key.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=bf3b7121d896038c170333982753a0cc 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-public-key.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=e6bb80df50643e35ac2386cdfd6b4a8b 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-public-key.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=17a10e205bb8d461ccd1db7527a057a8 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-public-key.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=5270f9ac6f1e8ae81541ec7514f561bd 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-client-credentials-public-key.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=bf120c24224ad590071ddd62f428cd5b 2500w`})}),_jsx(Info,{children:_jsx(_components.p,{children:`A client secret can’t be used instead. Okta only supports public key authentication for the Okta API scopes that Provisionr uses, so client secrets can’t be used to access the Okta management API.`})}),_jsxs(_components.p,{children:[`Okta warns that the existing client secrets will be deleted. Provisionr doesn’t use client secrets, so click `,_jsx(_components.strong,{children:`Save`}),`.`]}),_jsxs(_components.p,{children:[`Your public key is now `,_jsx(_components.code,{children:`Active`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-active.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=d58b1e5342e1061e45f96ed9ac70c2b0`,alt:`Okta Public keys table with the Provisionr key in the Active status`,\"data-og-width\":`1500`,width:`1500`,\"data-og-height\":`880`,height:`880`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-public-key-active.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-active.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=02451f0dcbd4adce900e64e1726bceed 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-active.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=4e021a26c4a494ae931667685e06aa25 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-active.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=7e2b3934b7f5ac044e5262db7077c685 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-active.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=45abbb6121e62c1593e28efe6fae4b91 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-active.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=53965f3711c2bd6c5d187f152a86e84f 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-public-key-active.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=414a9d5ca79264c1f23caf2bfa58eaf0 2500w`})})]}),_jsxs(Step,{title:`Requiring DPoP`,children:[_jsxs(_components.p,{children:[`On the `,_jsx(_components.strong,{children:`General`}),` tab, make sure that `,_jsx(_components.strong,{children:`Require Demonstrating Proof of Possession (DPoP) header in token requests`}),` is selected. If it isn’t, click `,_jsx(_components.strong,{children:`Edit`}),` in that section, select it, and click `,_jsx(_components.strong,{children:`Save`}),`.`]}),_jsxs(_components.p,{children:[`With DPoP, Provisionr binds every access token to a key that only Provisionr has, so a leaked access token can’t be replayed by anyone else. `,_jsx(_components.a,{href:`/integrations/okta/oauth2#demonstrating-proof-of-possession`,children:`Demonstrating Proof of Possession`}),` explains how it works.`]})]}),_jsxs(Step,{title:`Saving the Client ID`,children:[_jsxs(_components.p,{children:[`Copy the `,_jsx(_components.strong,{children:`Client ID`}),` from the `,_jsx(_components.strong,{children:`Client Credentials`}),` section and paste it at the Provisionr CLI prompt.`]}),_jsx(_components.p,{children:`Provisionr saves the Client ID with your staged integration. The Client ID is a public identifier, not a secret.`})]}),_jsxs(Step,{title:`Granting Okta API Scopes`,children:[_jsxs(_components.p,{children:[`Provisionr needs Okta API scopes to read Okta users and apps and to manage groups and group members. `,_jsx(_components.a,{href:`/integrations/okta/oauth2#oauth2-scopes`,children:`OAuth2 Scopes`}),` describes what each scope allows.`]}),_jsxs(_components.p,{children:[`Open the `,_jsx(_components.strong,{children:`Okta API Scopes`}),` tab of your app, and click `,_jsx(_components.strong,{children:`Grant`}),` next to each scope in the list that matches the admin role permissions that you selected.`]}),_jsxs(`div`,{className:`mint-grid mint-grid-cols-1 xl:mint-grid-cols-5 mint-gap-4`,children:[_jsx(`div`,{className:`xl:mint-col-span-3`,children:_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Groups + App Assignments`,numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`okta.users.read`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`okta.groups.manage`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`okta.apps.manage`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:`Groups Only (No App Cleanup)`,numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`okta.users.read`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`okta.groups.manage`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`okta.apps.read`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:`Audit (Read-Only)`,numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`okta.users.read`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`okta.groups.read`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`okta.apps.read`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})}),_jsx(`div`,{className:`xl:mint-col-span-2`,children:_jsx(Frame,{caption:`Okta API Scopes tab`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-scopes.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=0c991fff7e5b4694b2d07cf871471ae3`,alt:`Okta API Scopes tab with a Grant button next to each scope`,\"data-og-width\":`1416`,width:`1416`,\"data-og-height\":`1714`,height:`1714`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-scopes.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-scopes.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=78da135f25b810401392fb594132f725 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-scopes.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=dec12af9bb9bbef8fe9dee5102b75f26 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-scopes.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=88994d36698a9c3721120748ac9a9e50 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-scopes.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=03b85b6a3ca332d2bcc76cd98849d999 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-scopes.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=cabafd075631fdac9f806bafb2122a42 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-scopes.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=1b280c775d5ba8441a1630abd4e229f6 2500w`})})})]})]}),_jsxs(Step,{title:`Assigning the Admin Role`,children:[_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Applications > Applications`}),`, open the `,_jsx(_components.strong,{children:`Provisionr Sync`}),` app, open the `,_jsx(_components.strong,{children:`Admin roles`}),` tab, and click `,_jsx(_components.strong,{children:`Edit assignments`}),`.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-tab.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=c82bc2a861ec084a562abe3cf39747ac`,alt:`Okta app Admin roles tab with no admin roles assigned and the Edit assignments button`,\"data-og-width\":`2132`,width:`2132`,\"data-og-height\":`1074`,height:`1074`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-admin-roles-tab.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-tab.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=2c9b27483ac22e34b6acd2be6d1fa588 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-tab.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=ceeb85f4e50432c7b3ef8a1ff26c4d57 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-tab.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=036f9ab8533975881793b761c136226b 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-tab.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=c66f3887de8fd0cb19db3059daaad943 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-tab.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=2bbb7dd1419ab8e1d131c54abc6cacf4 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-tab.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=299107520c7a0f1782977f7f04816e68 2500w`})}),_jsxs(_components.p,{children:[`Select the `,_jsx(_components.strong,{children:`Provisionr Sync`}),` role and the default resource set, such as `,_jsx(_components.code,{children:`All Users`}),`, and click `,_jsx(_components.strong,{children:`Save Changes`}),`. Okta may ask you to authenticate again.`]}),_jsx(_components.p,{children:`You can ignore the warning that the resource set includes resources that aren’t affected by the permissions in the role.`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-assign.png?fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=b3ebe1c0782caebaed0fbe1b046737b9`,alt:`Okta role assignment form with the Provisionr Sync role and a resource set selected`,\"data-og-width\":`1892`,width:`1892`,\"data-og-height\":`711`,height:`711`,\"data-path\":`images/screenshots/integrations/okta/connect/okta-connect-admin-roles-assign.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-assign.png?w=280\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=66a038d0db2d8630dfb291161854f38e 280w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-assign.png?w=560\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=2b8e5c315385f7888fba863b942f1805 560w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-assign.png?w=840\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=b746d6d1f03585456c7467b77895c7e0 840w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-assign.png?w=1100\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=0baee6262f1f3a0522fb26f8d33169f7 1100w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-assign.png?w=1650\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=032dbf59b7d980cbb1197e2089cc7c4f 1650w, https://mintcdn.com/provisionr/DeIMNZpS_IMe5RLN/images/screenshots/integrations/okta/connect/okta-connect-admin-roles-assign.png?w=2500\u0026fit=max\u0026auto=format\u0026n=DeIMNZpS_IMe5RLN\u0026q=85\u0026s=b41bb76d89674af2f74341cec085588c 2500w`})}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`After you save, check that the `,_jsx(_components.strong,{children:`Admin roles`}),` tab lists only the `,_jsx(_components.strong,{children:`Provisionr Sync`}),` role. If it also lists `,_jsx(_components.strong,{children:`Super Administrator`}),`, remove it.`]}),_jsxs(_components.p,{children:[`Okta’s `,_jsx(_components.strong,{children:`Public client app admins`}),` org setting can assign the Super Administrator role to API service apps automatically when scopes are granted. Okta recommends turning off this setting once you assign admin roles to apps yourself.`]})]})]}),_jsxs(Step,{title:`Activating the Integration`,children:[_jsx(_components.p,{children:`Now that you’ve registered the public key, granted the Okta API scopes, and assigned the admin role, activate your Okta integration with the Provisionr CLI.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` okta-integration:activate`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`The command runs the `,_jsx(_components.a,{href:`#connection-test`,children:`connection test`}),` for your access level. If it passes, the integration is activated, and the initial sync of your Okta users, groups, and apps into Provisionr begins. If it doesn’t, the command shows the reason, and you can run it again after you fix the app in Okta.`]}),_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/integrations/okta/sync`,children:`How the Okta Sync Works`}),` walks through what each sync does, and `,_jsx(_components.a,{href:`/integrations/okta/oauth2`,children:`Okta OAuth2 Architecture`}),` explains how Provisionr authenticates with Okta along the way.`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(_components.p,{children:`Once your integration is active, the first sync reads your Okta users, groups, and apps into Provisionr. The next page looks more closely at how Provisionr authenticates with Okta, and at what each scope and admin role permission allows.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.a,{href:`/integrations/okta/oauth2`,children:`Continue reading: Okta OAuth2 Architecture →`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connect to Okta","description":"Connect your Okta organization to Provisionr with an OAuth 2.0 API service app that syncs users and manages group membership and app assignments by policy.","icon":"link","mode":"wide","href":"/integrations/okta/connect"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Primary Integration","slug":"primary-integration","depth":2,"children":[]},{"title":"Security Architecture","slug":"security-architecture","depth":2,"children":[]},{"title":"Access Levels","slug":"access-levels","depth":2,"children":[]},{"title":"Connection Test","slug":"connection-test","depth":2,"children":[{"title":"The Test Group","slug":"the-test-group","depth":3,"children":[]},{"title":"Testing Again","slug":"testing-again","depth":3,"children":[]}]},{"title":"Connecting Okta","slug":"connecting-okta","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/provisionr/68f8bc905a4b045e/scripts/lint-frontmatter.js"],"dynamicCss":".mint-flex {\n display: flex\n}\n.mint-grid {\n display: grid\n}\n.mint-grid-cols-1 {\n grid-template-columns: repeat(1, minmax(0, 1fr))\n}\n.mint-flex-col {\n flex-direction: column\n}\n.mint-gap-4 {\n gap: 1rem\n}\n@media (min-width: 1280px) {\n .xl\\:mint-col-span-2 {\n grid-column: span 2 / span 2\n }\n .xl\\:mint-col-span-3 {\n grid-column: span 3 / span 3\n }\n .xl\\:mint-grid-cols-5 {\n grid-template-columns: repeat(5, minmax(0, 1fr))\n }\n}","subdomain":"provisionr","siteName":"Provisionr","title":"Connect to Okta - Provisionr","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T02:47:36.203Z","originalFileLocation":"integrations/okta/connect.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect your Okta organization to Provisionr with an OAuth 2.0 API service app that syncs users and manages group membership and app assignments by policy.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Provisionr\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect to Okta - Provisionr\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect your Okta organization to Provisionr with an OAuth 2.0 API service app that syncs users and manages group membership and app assignments by policy.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Provisionr\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.provisionr.io/integrations/okta/connect\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://provisionr.mintlify.site/_mintlify/api/og/v2?division=Okta\u0026amp;title=Connect+to+Okta\u0026amp;description=Connect+your+Okta+organization+to+Provisionr+with+an+OAuth+2.0+API+service+app+that+syncs+users+and+manages+group+membership+and+app+assignments+by+policy.\u0026amp;theme=f6bc4ae197310e5c36fffed9\u0026amp;signature=ec94ff9c50dd594265ff0e44a6a68ed6d33d1d692b4c0e6209ec4d60859b5259\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connect to Okta - Provisionr\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect your Okta organization to Provisionr with an OAuth 2.0 API service app that syncs users and manages group membership and app assignments by policy.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://provisionr.mintlify.site/_mintlify/api/og/v2?division=Okta\u0026amp;title=Connect+to+Okta\u0026amp;description=Connect+your+Okta+organization+to+Provisionr+with+an+OAuth+2.0+API+service+app+that+syncs+users+and+manages+group+membership+and+app+assignments+by+policy.\u0026amp;theme=f6bc4ae197310e5c36fffed9\u0026amp;signature=ec94ff9c50dd594265ff0e44a6a68ed6d33d1d692b4c0e6209ec4d60859b5259\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Provisionr\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#d946ef\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.provisionr.io/integrations/okta/connect\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/okta/connect.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.provisionr.io/#organization\",\"name\":\"Provisionr\",\"url\":\"https://docs.provisionr.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/provisionr/5ukSD9JI1H_kpmU4/logo/light.svg?fit=max\u0026auto=format\u0026n=5ukSD9JI1H_kpmU4\u0026q=85\u0026s=6dc390c4a465580ff27f8fe8d49a11fc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.provisionr.io#website\",\"name\":\"Provisionr\",\"url\":\"https://docs.provisionr.io\",\"publisher\":{\"@id\":\"https://docs.provisionr.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.provisionr.io/integrations/okta/connect#webpage\",\"url\":\"https://docs.provisionr.io/integrations/okta/connect\",\"name\":\"Connect to Okta\",\"description\":\"Connect your Okta organization to Provisionr with an OAuth 2.0 API service app that syncs users and manages group membership and app assignments by policy.\",\"dateModified\":\"2026-11-10T02:47:36.203Z\",\"isPartOf\":{\"@id\":\"https://docs.provisionr.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.provisionr.io/integrations/okta/connect#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.provisionr.io/integrations/okta/connect#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Provisionr\",\"item\":\"https://docs.provisionr.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect to Okta\",\"item\":\"https://docs.provisionr.io/integrations/okta/connect\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.provisionr.io/integrations/okta/connect#article\",\"headline\":\"Connect to Okta\",\"name\":\"Connect to Okta\",\"description\":\"Connect your Okta organization to Provisionr with an OAuth 2.0 API service app that syncs users and manages group membership and app assignments by policy.\",\"url\":\"https://docs.provisionr.io/integrations/okta/connect\",\"mainEntityOfPage\":{\"@id\":\"https://docs.provisionr.io/integrations/okta/connect#webpage\"},\"dateModified\":\"2026-11-10T02:47:36.203Z\",\"publisher\":{\"@id\":\"https://docs.provisionr.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.provisionr.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Provisionr\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Provisionr\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/integrations/okta/connect.md","siteName":"Provisionr","nav":{"global":{"anchors":[{"anchor":"Documentation","icon":"file-lines","href":"https://docs.provisionr.io"},{"anchor":"Workspace HQ","icon":"server","href":"https://hq.provisionr.io"},{"anchor":"Slack Community","icon":"slack","href":"https://community.provisionr.io"},{"anchor":"Support Ticket","icon":"comments","href":"https://docs.provisionr.io/support/help"}]},"tabs":[{"tab":"Why Provisionr","pages":[{"title":"Why Provisionr","href":"/why/intro/mission"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/concepts/control/users"}]},{"tab":"Runbooks","pages":[{"title":"Runbooks","href":"/runbooks/orientation/attributes"}]},{"tab":"Integrations","groups":[{"group":"Architecture","icon":"puzzle-piece","expanded":true,"pages":[{"title":"Integrations Overview","sidebarTitle":"Overview","icon":"book","href":"/integrations/overview"},{"title":"Credential Security Architecture","sidebarTitle":"Credential Security","icon":"shield-halved","href":"/integrations/credential-security"}]},{"group":"Google","icon":"google","expanded":false,"pages":[{"title":"Connect to Google Workspace","icon":"link","mode":"wide","href":"/integrations/google/connect"},{"title":"Google OAuth2 Architecture","sidebarTitle":"OAuth2 Security","icon":"key","href":"/integrations/google/oauth2"},{"title":"Google Workspace Groups","sidebarTitle":"Workspace Groups","description":"Automate Google Workspace group membership so new hires, movers, and leavers stay current across mailing lists, Drive permissions, and Cloud IAM roles.","icon":"users","href":"/integrations/google/workspace/groups"}]},{"group":"Okta","icon":"https://mintlify.s3.us-west-1.amazonaws.com/provisionr/icons/okta.svg","expanded":false,"pages":[{"title":"Connect to Okta","icon":"link","mode":"wide","href":"/integrations/okta/connect"},{"title":"Okta OAuth2 Architecture","sidebarTitle":"OAuth2 Security","description":"See how Provisionr authenticates to the Okta API with an OAuth 2.0 service app, private key JWT, DPoP-bound tokens, least-privilege scopes, and a custom admin role.","icon":"key","href":"/integrations/okta/oauth2"},{"title":"How the Okta Sync Works","sidebarTitle":"Sync Pipeline","icon":"arrows-rotate","href":"/integrations/okta/sync"},{"title":"Okta Users","sidebarTitle":"Users","icon":"user","href":"/integrations/okta/users"},{"title":"Okta Groups","sidebarTitle":"Groups","icon":"users","href":"/integrations/okta/groups"},{"title":"Okta Applications","sidebarTitle":"Applications","icon":"grid-2","href":"/integrations/okta/apps"}]}]},{"tab":"API Endpoints","pages":[{"title":"API Endpoints","href":"/api/workspace/v1/overview"}]},{"tab":"CLI Commands","pages":[{"title":"CLI Commands","href":"/cli/workspace/v1/intro/install"}]},{"tab":"Release Notes and Roadmap","pages":[{"title":"Release Notes and Roadmap","href":"/roadmap/features"}]},{"tab":"Support","pages":[{"title":"Support","href":"/support/help"}]},{"tab":"Billing","pages":[{"title":"Billing","href":"/plans/evaluator"}]}]},"basePath":"","title":"Connect to Okta - Provisionr","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-RDXR0lmt.js","DynamicMarkdown-Z_y464fM.js","zoom-image-lightbox-D5uLWhtj.js","lightbox-handle-r17bVUz3.js"]}