> ## Documentation Index
> Fetch the complete documentation index at: https://statsig-4b2ff144-mintlify-add-local-eval-country-note-96362.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Okta SCIM User and Project/Role Management

## Import Existing Statsig Users and Groups

<Note>
  Users not assigned to the integration cannot be pushed into groups.
</Note>

* In Okta, go to the Statsig app's "Import" tab
* Click "Import Now" to fetch existing Statsig users and groups
* Process the imported users as needed

<Frame>
  <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/ahYmxJnFD3AOogdM/images/okta_scim_steps/step6-import-existing-users.png?fit=max&auto=format&n=ahYmxJnFD3AOogdM&q=85&s=2764601ef1223c30d6bef4e6b1945739" alt="Okta Import tab listing Statsig users ready to be brought into Okta" width="2040" height="1440" data-path="images/okta_scim_steps/step6-import-existing-users.png" />
</Frame>

## Manage User Assignments

* Use the "Assignments" tab in Okta to add or remove users from Statsig
* Adding a user assignment in Okta will create the user in Statsig, while removing the assignment will deactivate the user's Statsig account

<Frame>
  <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/ahYmxJnFD3AOogdM/images/okta_scim_steps/step7-manage-user-assignments.png?fit=max&auto=format&n=ahYmxJnFD3AOogdM&q=85&s=1c8af2c92e95876edd6600749957a4d3" alt="Okta Assignments tab showing Statsig app user assignment controls" width="2084" height="1366" data-path="images/okta_scim_steps/step7-manage-user-assignments.png" />
</Frame>

## Push Groups to Statsig

1. In Okta, go to the Statsig Integration's "Push Groups" tab
   <Frame>
     <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/ahYmxJnFD3AOogdM/images/okta_scim_steps/step8-push-groups-1.png?fit=max&auto=format&n=ahYmxJnFD3AOogdM&q=85&s=5a1e3007e8085b803fe2f690793d71cc" alt="Push Groups tab in Okta Statsig integration" width="2042" height="1428" data-path="images/okta_scim_steps/step8-push-groups-1.png" />
   </Frame>

2. Click the settings button and disable "Rename Groups"
   <Frame>
     <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/ahYmxJnFD3AOogdM/images/okta_scim_steps/step8-push-groups-2.png?fit=max&auto=format&n=ahYmxJnFD3AOogdM&q=85&s=7fbded933ae1f714e7244d440386da2a" alt="Push group settings dialog with Rename Groups toggle" width="2066" height="1336" data-path="images/okta_scim_steps/step8-push-groups-2.png" />
   </Frame>

3. Click "Push Groups" and select the method for finding groups in Okta.
   <Frame>
     <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/ahYmxJnFD3AOogdM/images/okta_scim_steps/step8-push-groups-3.png?fit=max&auto=format&n=ahYmxJnFD3AOogdM&q=85&s=6193b78b3346fe50139387aa788ca37b" alt="Okta modal prompting to find groups by name for push" width="2034" height="1436" data-path="images/okta_scim_steps/step8-push-groups-3.png" />
   </Frame>

4. Type in and select the Okta group that will push to a Statsig Project x Role Group.

* You can find Groups in left nav of Okta: `Directory > Groups`. In there, you will see the groups created from Okta and groups created by Statsig.
* The required groups are groups you created from Okta. You can filter by choosing `Group source type` and set to `Okta groups`. If you don't have any, go ahead and create it with members as well.
  <Frame>
    <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/ahYmxJnFD3AOogdM/images/okta_scim_steps/step8-push-groups-4.png?fit=max&auto=format&n=ahYmxJnFD3AOogdM&q=85&s=36d07763e4648af95d3ee043326d0897" alt="Directory listing of Okta groups filtered to Okta source" width="2038" height="1054" data-path="images/okta_scim_steps/step8-push-groups-4.png" />
  </Frame>

5. Now let's link/assign Okta group you created from Okta to the Statsig groups with role you want.

* Change `Match Result & Push Action` to `Link Group`
  <Frame>
    <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/ahYmxJnFD3AOogdM/images/okta_scim_steps/step8-push-groups-5.png?fit=max&auto=format&n=ahYmxJnFD3AOogdM&q=85&s=46a8946b35afffef996adc34947a4c78" alt="Push group configuration selecting Link group action" width="2054" height="1616" data-path="images/okta_scim_steps/step8-push-groups-5.png" />
  </Frame>

6. Select the Statsig Project x Role Group that the Okta group will push to.

* We display the Statsig Project x Role Group with the format `Statsig-<Project Name>-<Role Name>` on Okta.
* By default Okta only allows you to map 1 Okta Group to 1 Statsig Group.
  <Frame>
    <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/ahYmxJnFD3AOogdM/images/okta_scim_steps/step8-push-groups-6.png?fit=max&auto=format&n=ahYmxJnFD3AOogdM&q=85&s=6410ad3381d13bfcf58573bb44552d2a" alt="Statsig project role group dropdown showing Statsig-Project-Role format" width="2052" height="1596" data-path="images/okta_scim_steps/step8-push-groups-6.png" />
  </Frame>

7. Then link the Okta group to a Statsig Project x Role Group. On save the group should push to Statsig. All future group changes on Okta will be pushed to Statsig.
   <Frame>
     <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/ahYmxJnFD3AOogdM/images/okta_scim_steps/step8-push-groups-7.png?fit=max&auto=format&n=ahYmxJnFD3AOogdM&q=85&s=d8010fd28dcf8164c867398ed480663c" alt="Summary screen confirming Okta group linked to Statsig project role" width="2062" height="1612" data-path="images/okta_scim_steps/step8-push-groups-7.png" />
   </Frame>
