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

# Connect Grafana with Basic Authentication – StackOne Hub

> Link a Grafana account in the StackOne Hub using Basic Authentication. End-user guide to authorize the integration and start using Grafana actions.

> [!WARNING]
>
> Basic Authentication works only with self-hosted Grafana that has basic authentication enabled, which is the default. Grafana Cloud accepts service account tokens only.

## Create a Grafana user

Basic Authentication signs in as a Grafana user, so access follows that user's organization role. Use a dedicated user rather than a personal account.

**1. Create the user**

Sign in to your Grafana server as a Grafana server administrator, then go to **Administration** > **Users and access** > **Users**.

<ul>
  <li>Click **New user**.</li>
  <li>**Name**: `StackOne Integration`</li>
  <li>**Username**: `stackone`</li>
  <li>**Password**: A strong password for this user</li>
  <li>Click **Create user**.</li>
</ul>

![The New user form with the Name, Username and Password fields and the Create user button highlighted](https://mintcdn.com/stackone-60/oDou4sZIUapFakyE/connectors/grafana/images/basic-config-create-user.png?fit=max\&auto=format\&n=oDou4sZIUapFakyE\&q=85\&s=3a198458d9703c111a89e6a52c93dc4a)

**2. Set the organization role**

On the user's page, find your organization in the **Organizations** section.

<ul>
  <li>Click **Change role**.</li>
  <li>Select **Admin** for full access, or **Editor** or **Viewer** to limit access.</li>
  <li>Click **Save**.</li>
</ul>

![The Organizations section with the role dropdown open and Admin highlighted](https://mintcdn.com/stackone-60/oDou4sZIUapFakyE/connectors/grafana/images/basic-config-set-role.png?fit=max\&auto=format\&n=oDou4sZIUapFakyE\&q=85\&s=43636b2b7a8fa025c553020f724e1190)

**3. Copy the credentials**

Copy the **Username** and **Password** across.

## Find your instance URL

Your instance URL is the base address of your Grafana server, including the trailing slash.

<ul>
  <li>Format: `https://{your-grafana-host}/`</li>
  <li>Example: if your URL is `https://grafana.yourcompany.com/dashboards`, your **Instance URL** is `https://grafana.yourcompany.com/`</li>
</ul>

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/connect/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Next Steps

> [card] [Webhooks setup](https://docs.stackone.com/connectors/grafana/guides/webhook-setup.md)
>
> Configure receiving Events for Grafana into StackOne.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.