netbird-docs/docs/integrations/identity-providers/self-hosted/auth0.md

id, title, sidebar_position, tags

id	title	sidebar_position	tags
using-netbird-with-auth0	Using NetBird with Auth0	1	integrations idp auth0 oidc how-to

This guide is a part of the NetBird Self-hosting Guide and explains how to integrate self-hosted NetBird with Auth0.

Auth0 is a flexible, drop-in solution to add authentication and authorization services to your applications. It is a 3rd party managed service and can't be self-hosted. Auth0 is the right choice if you don't want to manage an Identity Provider (IDP) instance on your own.

:::tip self-hosted idp If you prefer to have full control over authentication and authorization of your NetBird network, there are good self-hosted alternatives to the managed Auth0 service like Keycloak. :::

Step 1: Create Auth0 account

To create an Auth0 account, sign up at https://auth0.com.

Step 2: Configure Auth0 properties in the setup.env file

1. Configure NETBIRD_AUTH0_DOMAIN and NETBIRD_AUTH0_CLIENT_ID properties.

   • To obtain these, please use Auth0 React SDK Guide up until "Install the Auth0 React SDK".

     Use https://YOUR DOMAIN as Allowed Callback URLs, Allowed Logout URLs, Allowed Web Origins and Allowed Origins (CORS)

   • set the variables in the setup.env

   • ⚠️ Make sure that Token Endpoint Authentication Method is set to None in your Auth0 Default Application

2. Configure NETBIRD_AUTH0_AUDIENCE property.

   • Check Auth0 Create An API section to obtain AuthAudience.
   • set the property in the setup.env file.

Step 3: Continue with the self-hosting guide

You can now continue with the NetBird Self-hosting Guide.