Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
92 changes: 92 additions & 0 deletions src/pages/manage/team/single-sign-on/cidaas.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
import {Note} from "@/components/mdx";

# cidaas on NetBird Cloud

You can use [cidaas](https://www.cidaas.com/) as your Identity Provider with NetBird, but it will require some additional configuration steps. cidaas is a cloud-native Identity and Access Management platform that provides single sign-on, multi-factor authentication, user self-service, and fine-grained authorization.

<Note>
Support for OIDC-compliant IdPs is available on the Team plan and higher.
The Free plan supports Google, Microsoft, and social logins.
</Note>

## Step 1: Create a New Application

Log in to your cidaas tenant's admin console (e.g., `https://<your-tenant>.cidaas.eu`). Click **Apps** in the left-hand sidebar, select **App Settings**, then click **+ Create New App**.

This opens the **Create App** form, which is divided into three sections: **App Details**, **App Settings**, and **Company Details**.

## Step 2: Fill in App Details

Configure the App Details section with the following settings:
- **App Name**: `NetBird`
- **App Display Name**: `NetBird`
- **App Logo URL**: `https://netbird.io/_next/static/media/netbird-logo.46570303.svg`
- **App Type**: `Regular`

<p>
<img src="/docs-static/img/manage/team/single-sign-on/cidaas-idp/app-details.png" alt="cidaas-app-details" className="imagewrapper-big"/>
</p>

Click **Next** to proceed to App Settings.

## Step 3: Configure App Settings

Configure the App Settings section with the following settings:
- **Scopes**: `openid`, `email`, `profile`
- **Hosted Page Group**: `default`
- **OAuth Standard**: `OAuth2.1`
- **Redirect URLs**: `https://login.netbird.io/login/callback`
- **Allow Logout URLs**: `https://login.netbird.io/oauth/revoke`

<p>
<img src="/docs-static/img/manage/team/single-sign-on/cidaas-idp/app-settings.png" alt="cidaas-app-settings" className="imagewrapper-big"/>
</p>

Click **Next** to proceed to Company Settings.

## Step 4: Configure Company Settings

Configure the App Settings section with the following settings:
- **Company Name**: `NetBird GmbH`
- **Company Address**: `Brunnenstraße 196 10119 Berlin`
- **Website URL**: `https://netbird.io`
- **Terms and Conditions URL**: `https://netbird.io/terms`
- **Privacy Policy URL**: `https://netbird.io/privacy`
- **Imprint URL**: `https://netbird.io/imprint`

<p>
<img src="/docs-static/img/manage/team/single-sign-on/cidaas-idp/company-settings.png" alt="cidaas-company-settings" className="imagewrapper-big"/>
</p>

Click **Submit** to create the application. You should see an **App created successfully** confirmation.

<p>
<img src="/docs-static/img/manage/team/single-sign-on/cidaas-idp/app-created.png" alt="cidaas-app-created" className="imagewrapper-big"/>
</p>

## Step 5: Verify the Application Status

Ensure the application status is set to **Active**. If it is not active, select **Active** from the status dropdown.

<p>
<img src="/docs-static/img/manage/team/single-sign-on/cidaas-idp/app-status.png" alt="cidaas-app-status" className="imagewrapper-big"/>
</p>

## Step 6: Copy the Client Credentials

From the application's **App Settings** tab, copy the **Client ID** and **Client Secret**.

## Step 7: Share Configuration with NetBird

Send the following information to the NetBird support team at support@netbird.io:

- **Client ID**
- **Client Secret**
- **cidaas Tenant URL** (e.g., `https://your-tenant.cidaas.eu`)
- **Email domains for your users**

<Note>
We recommend using a secure channel to share the Client Secret. You can send a separate email and use a secret sharing service like: <br/>
- https://onetimesecret.com/en/ <br/>
- https://password.link/en <br/>
</Note>
8 changes: 7 additions & 1 deletion src/pages/manage/team/single-sign-on/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -74,4 +74,10 @@ to integrate with NetBird. Below are the steps to set up different OIDC-complian

[Duo Security](https://duo.com/) is a cloud-based security platform that provides secure access through single sign-on (SSO), multi-factor authentication (MFA), and device trust. Duo offers comprehensive identity verification and access policies to protect applications and data, with a focus on zero-trust security architecture.

<Button href="/manage/team/single-sign-on/duo-security" variant="outline">Setup Duo Security</Button>
<Button href="/manage/team/single-sign-on/duo-security" variant="outline">Setup Duo Security</Button>

### cidaas

[cidaas](https://www.cidaas.com/) is a cloud-native Identity and Access Management platform that supports OpenID Connect, OAuth 2.0, and SAML 2.0. It provides single sign-on, multi-factor authentication, user self-service, and fine-grained authorization.

<Button href="/manage/team/single-sign-on/cidaas" variant="outline">Setup cidaas</Button>