diff options
author | Netdata bot <43409846+netdatabot@users.noreply.github.com> | 2024-04-30 19:53:27 +0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-04-30 19:53:27 +0300 |
commit | c7f08e6c31b6e585b5c127fa80a37ec68e468000 (patch) | |
tree | aa7f6b0518ea52320df20aa5a52d3ab1241da629 /integrations | |
parent | 9f0820aa66b99220d3465966a44143d450d2f7e5 (diff) |
Regenerate integrations.js (#17561)
Co-authored-by: ilyam8 <22274335+ilyam8@users.noreply.github.com>
Diffstat (limited to 'integrations')
-rw-r--r-- | integrations/cloud-authentication/integrations/oidc.md | 63 | ||||
-rw-r--r-- | integrations/integrations.js | 20 | ||||
-rw-r--r-- | integrations/integrations.json | 20 |
3 files changed, 103 insertions, 0 deletions
diff --git a/integrations/cloud-authentication/integrations/oidc.md b/integrations/cloud-authentication/integrations/oidc.md new file mode 100644 index 0000000000..c653513a3b --- /dev/null +++ b/integrations/cloud-authentication/integrations/oidc.md @@ -0,0 +1,63 @@ +<!--startmeta +custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cloud-authentication/integrations/oidc.md" +meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-authentication/metadata.yaml" +sidebar_label: "OIDC" +learn_status: "Published" +learn_rel_path: "Netdata Cloud/Authentication & Authorization/Cloud Authentication & Authorization Integrations" +message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE AUTHENTICATION'S metadata.yaml FILE" +endmeta--> + +# OIDC + + +<img src="https://netdata.cloud/img/openid.svg" width="150"/> + + +Integrate your organization's Authorization Servers 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 +- Authorization Server with OIDC protocol supported +- A Netdata Cloud account +- Access to the Space as an administrator +- Space needs to be on the Business plan or higher + +### Setting up Authorization Server +Your server should follow the [full specification for OIDC](https://openid.net/specs/openid-connect-core-1_0.html). +In order to integrate your Authorization Server with Netdata the creation of a client is required. Clients are applications and services that can request authentication of a user. +The access settings for your client are the following: +| field | value | +| :-- | :-- | +| Root URL | https://app.netdata.cloud/ | +| Home/Initiate login URL | https://app.netdata.cloud/api/v2/auth/account/auth-server?iss={your-server-issuer-url}&redirect_uri=https://app.netdata.cloud/sign-in®ister_uri=https://app.netdata.cloud/sign-up/verify | +| Redirect URL | https://app.netdata.cloud/api/v2/auth/account/auth-server/callback | + +### Netdata Configuration Steps +1. Click on the Space settings cog (located above your profile icon) +2. Click on the **Authentication** tab +3. On the OIDC card, click on **Configure** +4. Fill in the required credentials: + - **Issuer URL** the Authorization Server Issuer URL, e.g. `https://my-auth-server.com/` + - **Client ID** the Client ID from the created client + - **Client Secret** the Client Secret from the created client + - **Authorization URL** the Authorization Server authorization URL, e.g. `https://my-auth-server.com/openid-connect/auth` + - **Token URL** the Authorization Server token URL, e.g. `https://my-auth-server.com/openid-connect/token` + - **User URL** the Authorization Server user info URL, e.g. `https://my-auth-server.com/openid-connect/userinfo` + +### Supported features +* SP-initiated SSO (Single Sign-On) +* IdP-initiated SSO + +### SP-initiated SSO + +If you start your authentication flow from Netdata sign-in page please check [these steps](https://github.com/netdata/netdata/blob/master/docs/netdata-cloud/enterprise-sso-authentication.md#from-netdata-sign-up-page). + + +### Reference +https://openid.net/developers/how-connect-works/ + + diff --git a/integrations/integrations.js b/integrations/integrations.js index 1c0f38d1ed..07cdd51708 100644 --- a/integrations/integrations.js +++ b/integrations/integrations.js @@ -22304,6 +22304,26 @@ export const integrations = [ "edit_link": "https://github.com/netdata/netdata/blob/master/src/health/notifications/twilio/metadata.yaml" }, { + "id": "oidc-authentication", + "meta": { + "name": "OIDC", + "link": "https://netdata.cloud", + "categories": [ + "auth" + ], + "icon_filename": "openid.svg" + }, + "keywords": [ + "sso", + "oidc" + ], + "overview": "# OIDC\n\nIntegrate your organization's Authorization Servers with Netdata to better manage your team's access controls to Netdata Cloud.\n", + "setup": "## Setup\n\n### Prerequisites\n- Authorization Server with OIDC protocol supported\n- A Netdata Cloud account\n- Access to the Space as an administrator\n- Space needs to be on the Business plan or higher\n\n### Setting up Authorization Server\nYour server should follow the [full specification for OIDC](https://openid.net/specs/openid-connect-core-1_0.html).\nIn order to integrate your Authorization Server with Netdata the creation of a client is required. Clients are applications and services that can request authentication of a user.\nThe access settings for your client are the following:\n| field | value |\n| :-- | :-- |\n| Root URL | https://app.netdata.cloud/ |\n| Home/Initiate login URL | https://app.netdata.cloud/api/v2/auth/account/auth-server?iss={your-server-issuer-url}&redirect_uri=https://app.netdata.cloud/sign-in®ister_uri=https://app.netdata.cloud/sign-up/verify |\n| Redirect URL | https://app.netdata.cloud/api/v2/auth/account/auth-server/callback |\n\n### Netdata Configuration Steps\n1. Click on the Space settings cog (located above your profile icon)\n2. Click on the **Authentication** tab\n3. On the OIDC card, click on **Configure**\n4. Fill in the required credentials:\n - **Issuer URL** the Authorization Server Issuer URL, e.g. `https://my-auth-server.com/`\n - **Client ID** the Client ID from the created client\n - **Client Secret** the Client Secret from the created client\n - **Authorization URL** the Authorization Server authorization URL, e.g. `https://my-auth-server.com/openid-connect/auth`\n - **Token URL** the Authorization Server token URL, e.g. `https://my-auth-server.com/openid-connect/token`\n - **User URL** the Authorization Server user info URL, e.g. `https://my-auth-server.com/openid-connect/userinfo`\n\n### Supported features\n* SP-initiated SSO (Single Sign-On)\n* IdP-initiated SSO\n\n### SP-initiated SSO\n\nIf you start your authentication flow from Netdata sign-in page please check [these steps](https://github.com/netdata/netdata/blob/master/docs/netdata-cloud/enterprise-sso-authentication.md#from-netdata-sign-up-page).\n\n\n### Reference\nhttps://openid.net/developers/how-connect-works/\n\n", + "integration_type": "authentication", + "edit_link": "https://github.com/netdata/netdata/blob/master/integrations/cloud-authentication/metadata.yaml", + "troubleshooting": "" + }, + { "id": "okta-authentication", "meta": { "name": "Okta SSO", diff --git a/integrations/integrations.json b/integrations/integrations.json index a38fa9a459..31832c184e 100644 --- a/integrations/integrations.json +++ b/integrations/integrations.json @@ -22302,6 +22302,26 @@ "edit_link": "https://github.com/netdata/netdata/blob/master/src/health/notifications/twilio/metadata.yaml" }, { + "id": "oidc-authentication", + "meta": { + "name": "OIDC", + "link": "https://netdata.cloud", + "categories": [ + "auth" + ], + "icon_filename": "openid.svg" + }, + "keywords": [ + "sso", + "oidc" + ], + "overview": "# OIDC\n\nIntegrate your organization's Authorization Servers with Netdata to better manage your team's access controls to Netdata Cloud.\n", + "setup": "## Setup\n\n### Prerequisites\n- Authorization Server with OIDC protocol supported\n- A Netdata Cloud account\n- Access to the Space as an administrator\n- Space needs to be on the Business plan or higher\n\n### Setting up Authorization Server\nYour server should follow the [full specification for OIDC](https://openid.net/specs/openid-connect-core-1_0.html).\nIn order to integrate your Authorization Server with Netdata the creation of a client is required. Clients are applications and services that can request authentication of a user.\nThe access settings for your client are the following:\n| field | value |\n| :-- | :-- |\n| Root URL | https://app.netdata.cloud/ |\n| Home/Initiate login URL | https://app.netdata.cloud/api/v2/auth/account/auth-server?iss={your-server-issuer-url}&redirect_uri=https://app.netdata.cloud/sign-in®ister_uri=https://app.netdata.cloud/sign-up/verify |\n| Redirect URL | https://app.netdata.cloud/api/v2/auth/account/auth-server/callback |\n\n### Netdata Configuration Steps\n1. Click on the Space settings cog (located above your profile icon)\n2. Click on the **Authentication** tab\n3. On the OIDC card, click on **Configure**\n4. Fill in the required credentials:\n - **Issuer URL** the Authorization Server Issuer URL, e.g. `https://my-auth-server.com/`\n - **Client ID** the Client ID from the created client\n - **Client Secret** the Client Secret from the created client\n - **Authorization URL** the Authorization Server authorization URL, e.g. `https://my-auth-server.com/openid-connect/auth`\n - **Token URL** the Authorization Server token URL, e.g. `https://my-auth-server.com/openid-connect/token`\n - **User URL** the Authorization Server user info URL, e.g. `https://my-auth-server.com/openid-connect/userinfo`\n\n### Supported features\n* SP-initiated SSO (Single Sign-On)\n* IdP-initiated SSO\n\n### SP-initiated SSO\n\nIf you start your authentication flow from Netdata sign-in page please check [these steps](https://github.com/netdata/netdata/blob/master/docs/netdata-cloud/enterprise-sso-authentication.md#from-netdata-sign-up-page).\n\n\n### Reference\nhttps://openid.net/developers/how-connect-works/\n\n", + "integration_type": "authentication", + "edit_link": "https://github.com/netdata/netdata/blob/master/integrations/cloud-authentication/metadata.yaml", + "troubleshooting": "" + }, + { "id": "okta-authentication", "meta": { "name": "Okta SSO", |