Skip to content

Commit

Permalink
Add okta-preview
Browse files Browse the repository at this point in the history
  • Loading branch information
nalanj committed Jan 30, 2025
1 parent a3c35d4 commit 2c85121
Show file tree
Hide file tree
Showing 3 changed files with 118 additions and 0 deletions.
46 changes: 46 additions & 0 deletions docs-v2/integrations/all/okta-preview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
---
title: Okta Preview
sidebarTitle: Okta Preview
provider: okta-preview
---

import Overview from "/snippets/overview.mdx";
import PreBuiltTooling from "/snippets/generated/okta-preview/PreBuiltTooling.mdx";
import PreBuiltUseCases from "/snippets/generated/okta-preview/PreBuiltUseCases.mdx"

<Overview />
<PreBuiltTooling />
<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account || |
| Paid test account || |
| Partnership || |
| App review || |
| Security audit || |


## Setup guide

_No setup guide yet._

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/okta-preview.mdx)</Note>


## Useful links

- [How to register an Application](https://developer.okta.com/docs/guides/implement-oauth-for-okta/main/#create-an-oauth-2-0-app-in-okta)
- [OAuth-related docs](https://developer.okta.com/docs/reference/api/oidc)
- [List of OAuth scopes](https://developer.okta.com/docs/api/oauth2/#oauth-20-scopes)
- [API rate limiting](https://developer.okta.com/docs/reference/rate-limits/)
<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/okta-preview.mdx)</Note>

## API gotchas

- To get refresh_token, you will need to add **`offline_access`** to the list of your scopes.

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/okta-preview.mdx)</Note>
41 changes: 41 additions & 0 deletions docs-v2/snippets/generated/okta-preview/PreBuiltTooling.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
## Pre-built tooling
<AccordionGroup>
<Accordion title="✅ Authorization">
| Tools | Status |
| - | - |
| Pre-built authorization (OAuth) ||
| Credentials auto-refresh ||
| Auth parameters validation ||
| Pre-built authorization UI ||
| Custom authorization UI ||
| Expired credentials detection ||
</Accordion>
<Accordion title="✅ Read & write data">
| Tools | Status |
| - | - |
| Pre-built integrations ||
| API unification ||
| 2-way sync ||
| Webhooks from Nango on data modifications ||
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: &lt;48h) |
| Proxy requests ||
</Accordion>
<Accordion title="✅ Observability & data quality">
| Tools | Status |
| - | - |
| HTTP request logging ||
| End-to-type type safety ||
| Data runtime validation ||
| OpenTelemetry export ||
| Slack alerts on errors ||
| Integration status API ||
</Accordion>
<Accordion title="✅ Customization">
| Tools | Status |
| - | - |
| Create or customize use-cases ||
| Pre-configured pagination ||
| Pre-configured rate-limit handling ||
| Per-customer configurations ||
</Accordion>
</AccordionGroup>
31 changes: 31 additions & 0 deletions docs-v2/snippets/generated/okta-preview/PreBuiltUseCases.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@

## Pre-built integrations

<AccordionGroup>


<Accordion title="User Groups">
| Endpoint | Description | Readme |
| - | - | - |
| `PUT /user-groups` | Assigns a user to a group with the OKTA_GROUP type | [🔗](https://github.com/NangoHQ/integration-templates/blob/main/integrations/okta-preview/actions/add-user-group.md) |
| `DELETE /user-groups` | Unassigns a user from a group with the OKTA_GROUP type | [🔗](https://github.com/NangoHQ/integration-templates/blob/main/integrations/okta-preview/actions/remove-user-group.md) |
</Accordion>


<Accordion title="Users">
| Endpoint | Description | Readme |
| - | - | - |
| `POST /users` | Creates a new user in your Okta org without credentials. | [🔗](https://github.com/NangoHQ/integration-templates/blob/main/integrations/okta-preview/actions/create-user.md) |
| `GET /users` | Fetches lists users in your org | [🔗](https://github.com/NangoHQ/integration-templates/blob/main/integrations/okta-preview/syncs/users.md) |
</Accordion>


<Accordion title="Others">
| Endpoint | Description | Readme |
| - | - | - |
| `POST /group` | Adds a new group with the OKTA_GROUP type to your org | [🔗](https://github.com/NangoHQ/integration-templates/blob/main/integrations/okta-preview/actions/add-group.md) |
</Accordion>

</AccordionGroup>

<Tip>Not seeing the integration you need? [Build your own](https://docs.nango.dev/guides/custom-integrations/overview) independently.</Tip>

0 comments on commit 2c85121

Please sign in to comment.