mirror of
https://github.com/awatertrevi/infisical.git
synced 2026-09-22 13:39:35 +00:00
125 lines
4.5 KiB
Plaintext
125 lines
4.5 KiB
Plaintext
---
|
|
title: "Northflank Connection"
|
|
description: "Learn how to configure a Northflank Connection for Infisical."
|
|
---
|
|
|
|
Infisical supports the use of [API Tokens](https://northflank.com/docs/v1/api/use-the-api) to connect with Northflank.
|
|
|
|
<Tip>
|
|
Infisical recommends creating a specific API role for the app connection and only giving access to projects that will use the integration.
|
|
</Tip>
|
|
|
|
## Create a Northflank API Token
|
|
|
|
<Steps>
|
|
<Step title="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.
|
|
</Step>
|
|
<Step title="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.
|
|
|
|
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Create a Northflank Connection in Infisical
|
|
|
|
<Tabs>
|
|
<Tab title="Infisical UI">
|
|
<Steps>
|
|
<Step title="Navigate to App Connections">
|
|
In your Infisical dashboard, navigate to the **App Connections** page in the desired project.
|
|
|
|
|
|
</Step>
|
|
<Step title="Select Northflank Connection">
|
|
Click **+ Add Connection** and choose **Northflank Connection** from the list of integrations.
|
|
|
|
|
|
</Step>
|
|
<Step title="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
|
|
|
|
|
|
</Step>
|
|
<Step title="Connection created">
|
|
After submitting the form, your **Northflank Connection** will be successfully created and ready to use with your Infisical project.
|
|
|
|
|
|
</Step>
|
|
</Steps>
|
|
</Tab>
|
|
|
|
<Tab title="API">
|
|
To create a Northflank Connection via API, send a request to the [Create Northflank Connection](/api-reference/endpoints/app-connections/northflank/create) endpoint.
|
|
|
|
### Sample request
|
|
|
|
```bash 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
|
|
|
|
```bash 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": {}
|
|
}
|
|
}
|
|
```
|
|
</Tab>
|
|
</Tabs> |