# Okta Okta is the complete identity solution for all your apps and people that’s universal, reliable, and easy ## Prerequisites * Created Okta account with added application on [Add Application Page](https://okta-domain.okta.com/enduser/catalog) page. (change okta-domain to you'r domain received after complete registration) ## Airbyte Open Source * Name * Okta-Domain * Start Date * Personal Api Token (look [here](https://developer.okta.com/docs/guides/find-your-domain/-/main/) to find it) ## Airbyte Cloud * Name * Start Date * Client ID (received when application was added). * Client Secret (received when application was added). * Refresh Token (received when application was added) ## Setup guide ### Step 1: Set up Okta 1. Create account on Okta by following link [signup](https://www.okta.com/free-trial/) 2. Confirm your Email 3. Choose authorization method (Application or SMS) 4. Add application in your [Dashboard](https://okta-domain.okta.com/app/UserHome) ### For Airbyte Cloud: 1. [Log into your Airbyte Cloud](https://cloud.airbyte.com/workspaces) account. 2. In the left navigation bar, click **Sources**. In the top-right corner, click **+ new source**. 3. On the source setup page, select **Okta** from the Source type dropdown and enter a name for this connector. 4. Add **Name** 5. Add **Okta-Domain** 6. Add **Start date** (defaults to 7 days if no date is included) 7. Choose the method of authentication 8. If you select Token authentication - fill the field **Personal Api Token** 9. If you select OAuth2.0 authorization - fill the fields **Client ID**, **Client Secret**, **Refresh Token** 10. Click `Set up source`. ### For Airbyte Open Source: 1. Go to local Airbyte page. 2. Use API token from requirements and Okta [domain](https://developer.okta.com/docs/guides/find-your-domain/-/main/). 3. Go to local Airbyte page. 4. In the left navigation bar, click **Sources**. In the top-right corner, click **+ new source**. 5. On the Set up the source page select **Okta** from the Source type dropdown. 6. Add **Name** 7. Add **Okta-Domain** 8. Add **Start date** 9. Paste all data to required fields fill the fields **Client ID**, **Client Secret**, **Refresh Token** 10. Click `Set up source`. ## Supported sync modes The Okta source connector supports the following [sync modes](https://docs.airbyte.com/cloud/core-concepts#connection-sync-modes): - Full Refresh - Incremental ## Supported Streams - [Users](https://developer.okta.com/docs/reference/api/users/#list-users) - [User Role Assignments](https://developer.okta.com/docs/reference/api/roles/#list-roles-assigned-to-a-user) - [Groups](https://developer.okta.com/docs/reference/api/groups/#list-groups) - [Group Members](https://developer.okta.com/docs/reference/api/groups/#list-group-members) - [Group Role Assignments](https://developer.okta.com/docs/reference/api/roles/#list-roles-assigned-to-a-group) - [System Log](https://developer.okta.com/docs/reference/api/system-log/#get-started) - [Custom Roles](https://developer.okta.com/docs/reference/api/roles/#list-roles) - [Permissions](https://developer.okta.com/docs/reference/api/roles/#list-permissions) - [Resource Sets](https://developer.okta.com/docs/reference/api/roles/#list-resource-sets) ## Performance considerations The connector is restricted by normal Okta [requests limitation](https://developer.okta.com/docs/reference/rate-limits/). ## Changelog | Version | Date | Pull Request | Subject | |:--------|:-----------|:---------------------------------------------------------|:-------------------------------------------------------------------------------| | 0.1.16 | 2023-07-07 | [20833](https://github.com/airbytehq/airbyte/pull/20833) | Fix infinite loop for GroupMembers stream | | 0.1.15 | 2023-06-20 | [27533](https://github.com/airbytehq/airbyte/pull/27533) | Fixed group member stream and resource sets stream pagination | | 0.1.14 | 2022-12-24 | [20877](https://github.com/airbytehq/airbyte/pull/20877) | Disabled OAuth2.0 authorization method | | 0.1.13 | 2022-08-12 | [14700](https://github.com/airbytehq/airbyte/pull/14700) | Add resource sets | | 0.1.12 | 2022-08-05 | [15050](https://github.com/airbytehq/airbyte/pull/15050) | Add parameter `start_date` for Logs stream | | 0.1.11 | 2022-08-03 | [14739](https://github.com/airbytehq/airbyte/pull/14739) | Add permissions for custom roles | | 0.1.10 | 2022-08-01 | [15179](https://github.com/airbytehq/airbyte/pull/15179) | Fix broken schemas for all streams | | 0.1.9 | 2022-07-25 | [15001](https://github.com/airbytehq/airbyte/pull/15001) | Return deprovisioned users | | 0.1.8 | 2022-07-19 | [14710](https://github.com/airbytehq/airbyte/pull/14710) | Implement OAuth2.0 authorization method | | 0.1.7 | 2022-07-13 | [14556](https://github.com/airbytehq/airbyte/pull/14556) | Add User_Role_Assignments and Group_Role_Assignments streams (full fetch only) | | 0.1.6 | 2022-07-11 | [14610](https://github.com/airbytehq/airbyte/pull/14610) | Add custom roles stream | | 0.1.5 | 2022-07-04 | [14380](https://github.com/airbytehq/airbyte/pull/14380) | Add Group_Members stream to okta source | | 0.1.4 | 2021-11-02 | [7584](https://github.com/airbytehq/airbyte/pull/7584) | Fix incremental params for log stream | | 0.1.3 | 2021-09-08 | [5905](https://github.com/airbytehq/airbyte/pull/5905) | Fix incremental stream defect | | 0.1.2 | 2021-07-01 | [4456](https://github.com/airbytehq/airbyte/pull/4456) | Fix infinite pagination in logs stream | | 0.1.1 | 2021-06-09 | [3937](https://github.com/airbytehq/airbyte/pull/3973) | Add `AIRBYTE_ENTRYPOINT` env variable for kubernetes support | | 0.1.0 | 2021-05-30 | [3563](https://github.com/airbytehq/airbyte/pull/3563) | Initial Release |