summaryrefslogtreecommitdiffstats
path: root/integrations/cloud-authentication/integrations/okta_sso.md
diff options
context:
space:
mode:
Diffstat (limited to 'integrations/cloud-authentication/integrations/okta_sso.md')
-rw-r--r--integrations/cloud-authentication/integrations/okta_sso.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/integrations/cloud-authentication/integrations/okta_sso.md b/integrations/cloud-authentication/integrations/okta_sso.md
new file mode 100644
index 0000000000..3f6dd15a0b
--- /dev/null
+++ b/integrations/cloud-authentication/integrations/okta_sso.md
@@ -0,0 +1,49 @@
+<!--startmeta
+custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cloud-authentication/integrations/okta_sso.md"
+meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-authentication/metadata.yaml"
+sidebar_label: "Okta SSO"
+learn_status: "Published"
+learn_rel_path: "Authentication"
+message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE AUTHENTICATION'S metadata.yaml FILE"
+endmeta-->
+
+# Okta SSO
+
+
+<img src="https://netdata.cloud/img/okta.png" width="150"/>
+
+
+Integrate your organization's Okta account with Netdata to better manage your team's access controls to Netdata Cloud.
+
+
+<img src="https://img.shields.io/badge/maintained%20by-Netdata-%2300ab44" />
+
+## Setup
+
+### Prerequisites
+- An Okta account
+- A Netdata Cloud account
+- Access to the Space as an administrator
+- Space needs to be on Business plan or higher
+
+### Setting up Okta
+Steps needed to be done on Okta Admin Portal:
+1. Click on **Applications** tab and choose to **Browse App Catalogue**
+2. Find Netdata's preconfigured app for easy setup and click **Add Integration**
+3. Give the app the preferred **Application label**, for when it is displayed in your apps dashboard,
+and click Next to move to the Sign-On options tab
+5. In the **Sign-On Options** all the values we expect are already filled and no additional data is required
+6. Click **Done**. You are be able to go back and edit any fields later if need be
+7. Go to the **Assignments** tab and enter the People or Group assignments as per your organization’s policies
+
+### Netdata Configuration Steps
+1. Click on the Space settings cog (located above your profile icon)
+2. Click on the **Authentication** tab
+3. On the Okta SSO card, click on **Configure**
+4. Fill in the required credentials, you get them from **Okta Admin Portal**:
+ - **Issuer URL** you can get it from your profile icon on top, e.g. `https://company-name.okta.com`
+ - **Client ID** you can get it from **General** tab on application you configured on Okta
+ - **Client Secret** you can get it from **General** tab on application you configured on Okta
+ Note: [Okta - Find your application credentials](https://developer.okta.com/docs/guides/find-your-app-credentials/main/)
+
+