add-okta-docs

_data/navigation.yml

@@ -249,6 +249,9 @@ items:
               - url: /components/extractors/other/google-search-console/
                 title: Google Search Console
 
+              - url: /components/extractors/other/okta/
+                title: Okta
+
               - url: /components/extractors/other/papertrail/
                 title: Papertrail
 

components/extractors/other/index.md

@@ -20,12 +20,13 @@ extractors that do not fall into any of the above mentioned categories:
 provides detailed data for locations specified by their names, address or coordinates.
 - [GitHub](/components/extractors/other/github/) --- imports data from GitHub, a software development platform.
 - [Google Search Console](/components/extractors/other/google-search-console/) --- imports data from Google Search Console, a web service by Google which allows webmasters to check indexing status and optimize visibility of their websites.
+- [Okta](/components/extractors/other/okta/) --- imports data from Okta platform.
 - [Papertrail](/components/extractors/other/papertrail/) --- imports data from Papertrail (log management).
 - [Pingdom](/components/extractors/other/pingdom/) --- imports data from Pingdom, a service for monitoring the uptime and performance of your websites and web applications.
 - [ServiceNow](/components/extractors/other/servicenow/) --- imports data from ServiceNow tables.
 - [Stripe](/components/extractors/other/stripe/) --- imports almost all data from Stripe, a service that enables online payments.
 - [Telemetry Data](/components/extractors/other/telemetry-data/) --- retrieves data about your project or the whole organization; helps Keboola calculate your project consumption.
-- [Time Doctor 2](/components/extractors/other/time-doctor-2/) --- imports data from Time Doctor 2
+- [Time Doctor 2](/components/extractors/other/time-doctor-2/) --- imports data from Time Doctor 2.
 - [What3words](/components/extractors/other/what3words/) --- converts What3words addresses to coordinates and vice versa.
 - [YourPass](/components/extractors/other/yourpass/) --- imports data about passes from YourPass.
 - And [more](https://components.keboola.com/components)

components/extractors/other/okta/index.md

@@ -0,0 +1,37 @@
+---
+title: Okta Extractor
+permalink: /components/extractors/other/okta/
+redirect_from:
+    - /extractors/other/okta/
+---
+
+* TOC
+{:toc}
+
+This extractor fetches data from [Okta](https://www.okta.com/). It supports backfill mode and also incremental fetching.
+
+## Prerequisites
+
+- Okta API token
+
+You can find out how to obtain the API token in [Okta docs](https://developer.okta.com/docs/guides/create-an-api-token/main).
+
+## Supported endpoints
+
+ - users
+ - user_types
+ - devices
+
+## General Configuration
+ - **Organization url** (org_url) - [REQ] Example: keboola.okta.com
+ - **API Token** (#api_token) - [REQ] API Key to Authenticate the connection with Octa.
+
+
+## Row Configuration
+ - **Endpoint** (endpoint) - [REQ] Endpoint of Octa from which data will be fetched.
+ - **Search** (search) - [OPT] Refer to [Okta docs](https://developer.okta.com/docs/reference/api/users/#list-users-with-search) for query syntax.
+ - **Sync Mode** (sync_mode) - [OPT] Full Sync downloads all data from the source every run, Incremental Sync downloads data updated since the last run time.
+ - **Storage Table Name** (output_table_name) - [REQ] Name of the table stored in Storage.
+ - **Load Type** (load_type) - [REQ] If Full load is used, the destination table will be overwritten every run. If incremental load is used, data will be upserted into the destination table. Tables with a primary key will have rows updated, tables without a primary key will have rows appended.
+
+When done, **save** the configuration.