> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Nerdio - How do I link my account?

# Overview

To authenticate with Nerdio, you need:

1. **Nerdio Instance URL** - The hostname of your Nerdio Manager instance
2. **Azure Tenant ID** - Your Azure Active Directory Tenant ID
3. **Client ID** - The Application (client) ID from your Azure App Registration
4. **Client Secret** - The client secret from your Azure App Registration
5. **API Scope** - The Application ID URI scope for the Nerdio API

This guide walks you through enabling the REST API in Nerdio Manager and obtaining the required credentials.

### Prerequisites:

* Admin access to your Nerdio Manager installation (Premium edition required)
* Access to your Azure Portal with permissions to manage App Registrations

### Instructions:

#### Step 1: Finding your Nerdio Instance URL

1. Log in to your Nerdio Manager portal.
2. Copy the hostname from your browser's address bar (e.g., `web-admin-portal-xxxxx.azurewebsites.net`).

#### Step 2: Getting your Azure Credentials

1. In Nerdio Manager, navigate to **Settings** > **Integrations**.
2. In the **REST API** tile, if the Current status is Disabled, select **Disabled** to enable it.
3. In Step #1, select **Run**. This creates a new Azure application under the nerdio-nmw-app app registration in your Azure tenant.
4. In Step #2, select **Grant** to navigate to your Azure portal and grant Admin consent.

<img src="https://mintcdn.com/nango/LSypgjgcflTctxoT/api-integrations/nerdio/nerdio_rest_api_settings.png?fit=max&auto=format&n=LSypgjgcflTctxoT&q=85&s=445fdf74484ada7d6b0fe7a3cb492205" alt="Nerdio REST API Settings" width="423" height="162" data-path="api-integrations/nerdio/nerdio_rest_api_settings.png" />

5. Once enabled, copy the following values from the **REST API Credentials** section:
   * **Client ID** - The Application (client) ID
   * **Tenant ID** - Your Azure AD Tenant ID

<img src="https://mintcdn.com/nango/LSypgjgcflTctxoT/api-integrations/nerdio/nerdio_credentials.png?fit=max&auto=format&n=LSypgjgcflTctxoT&q=85&s=9a4a447d5ea672f94c7288ea26c8c470" alt="Nerdio REST API Credentials" width="1224" height="373" data-path="api-integrations/nerdio/nerdio_credentials.png" />

6. To generate a Client Secret:
   * Navigate to your Azure Portal > **App Registrations** > select the Nerdio app
   * Go to **Certificates & secrets** > **New client secret**
   * Copy the secret value immediately (it will only be shown once)

<Note>
  Store the Client Secret securely immediately. It cannot be retrieved later. If you lose it, you will need to generate a new one.
</Note>

#### Step 3: Configuring the API Scope

1. In the Azure Portal, navigate to your Nerdio App Registration.
2. Go to **Expose an API** and copy the **Application ID URI**.
3. Append `/.default` to the URI to form the complete scope (e.g., `api://your-app-id/.default`).

<Note>
  If the Application ID URI is not set, you need to add it first. An example format is `api://g0cb288e-ff16-1861-9393-50219a19453c`.
</Note>

#### Step 4: Enter credentials in the Connect UI

Once you have gathered all credentials:

1. Open the form where you need to authenticate with Nerdio.
2. Enter your **Nerdio Instance URL** (hostname only, without https\://).
3. Enter your **Azure Tenant ID**.
4. Enter your **API Scope**.
5. Enter your **Client ID** and **Client Secret**.
6. Submit the form to authenticate.

<img src="https://mintcdn.com/nango/LSypgjgcflTctxoT/api-integrations/nerdio/form.png?fit=max&auto=format&n=LSypgjgcflTctxoT&q=85&s=fdb2a060a0d14bb9c4181275f354b793" style={{maxWidth: "450px" }} width="758" height="1058" data-path="api-integrations/nerdio/form.png" />

You are now connected to Nerdio.