Northflank Connection

Learn how to configure a Northflank Connection for Infisical.

Infisical supports the use of API Tokens to connect with Northflank.

Infisical recommends creating a specific API role for the app connection and only giving access to projects that will use the integration.

Create a Northflank API Token

1. Create an API Role

   Navigate to your team page and click Create token.

   

   Click on Create API role.

   

   Select all the projects you want this role to have access to, or leave this unchecked if you want to give access to all projects.

   

   Add the Projects -> Manage -> Read permission.

   

   Add the Config & Secrets -> Secret Groups -> List, Update and Read Values permissions.

   

   Scroll to the bottom and save the API role.

2. Create an API Token

   Click on the API -> Tokens menu on the left and then click the Create API token button.

   

   Give a name to the API token and click the Use role button for the new API role you just created.

   

   Click the View API token icon to view and copy your token.

   

Create a Northflank Connection in Infisical

Infisical UI

1. Navigate to App Connections

   In your Infisical dashboard, navigate to the App Connections page in the desired project.

   
2. Select Northflank Connection

   Click + Add Connection and choose Northflank Connection from the list of integrations.

   
3. Fill out the Northflank Connection form

   Complete the form by providing:

   • A descriptive name for the connection

   • An optional description

   • The API Token from the previous step

     
4. Connection created

   After submitting the form, your Northflank Connection will be successfully created and ready to use with your Infisical project.

   

API

To create a Northflank Connection via API, send a request to the Create Northflank Connection endpoint.

Sample request

Request

curl    --request POST \
        --url https://app.infisical.com/api/v1/app-connections/northflank \
        --header 'Content-Type: application/json' \
        --data '{
            "name": "my-northflank-connection",
            "method": "api-token",
            "projectId": "abcdef12-3456-7890-abcd-ef1234567890",
            "credentials": {
                "apiToken": "[API TOKEN]"
            }
        }'

Sample response

Response

{
  "appConnection": {
      "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "name": "my-northflank-connection",
      "description": null,
      "projectId": "abcdef12-3456-7890-abcd-ef1234567890",
      "version": 1,
      "orgId": "abcdef12-3456-7890-abcd-ef1234567890",
      "createdAt": "2025-01-23T10:15:00.000Z",
      "updatedAt": "2025-01-23T10:15:00.000Z",
      "isPlatformManagedCredentials": false,
      "credentialsHash": "d41d8cd98f00b204e9800998ecf8427e",
      "app": "northflank",
      "method": "api-token",
      "credentials": {}
  }
}