docs

2026-10-05 18:26:42 +00:00 · 2025-05-22 19:57:15 -04:00
parent a64f8ac776
commit 6648397a64
34 changed files with 386 additions and 0 deletions
@@ -0,0 +1,123 @@
+---
+title: "1Password Connection"
+description: "Learn how to configure a 1Password Connection for Infisical."
+---
+
+Infisical supports the use of [Service Accounts](https://developer.1password.com/docs/service-accounts) to connect with 1Password.
+
+## Setup 1Password Connect Server
+
+<Note>
+    If you already have a Connect Server for your vault you may skip this step.
+</Note>
+
+<Steps>
+    <Step title="Navigate to 'Developer' and click 'Other'">
+        ![Developer Page](/images/app-connections/1password/developer-page.png)
+    </Step>
+    <Step title="Select 'Connect Server'">
+        ![Click Connect Server](/images/app-connections/1password/click-connect-server.png)
+    </Step>
+    <Step title="Configure Connect Server">
+        1. Input a name for you Connect Server
+        2. Click "Choose Vaults" and select the vaults you want to connect
+        3. For each selected vault, click **Edit Access** and **Enable All**
+        4. Click "Add Environment"
+
+        ![Configure Connect Server](/images/app-connections/1password/configure-connect-server.png)
+    </Step>
+    <Step title="Configure Access Token">
+        1. Input a name and expiration for the token
+        2. Click "Choose Vaults" and select the vaults you want to connect
+        3. For each selected vault, click **Edit Access** and **Enable All**
+        4. Click "Issue Token"
+
+        ![Set Up Access Token](/images/app-connections/1password/set-up-access-token.png)
+    </Step>
+    <Step title="Deploy Connect Server">
+        Download the Credentials File and set up your Connect Server.
+
+        <Note>
+            Follow [this guide](https://developer.1password.com/docs/connect/get-started#step-2-deploy-1password-connect-server) to deploy a Connect Server.
+        </Note>
+
+        Make sure to save the **Access Token** for later use.
+
+        ![Deploy Server](/images/app-connections/1password/deploy-server.png)
+    </Step>
+</Steps>
+
+## Create 1Password Connection in Infisical
+
+<Tabs>
+    <Tab title="Infisical UI">
+        <Steps>
+            <Step title="Navigate to App Connections">
+                In your Infisical dashboard, go to **Organization Settings** and select the [**App Connections**](https://app.infisical.com/organization/app-connections) tab.
+
+                ![App Connections Tab](/images/app-connections/general/add-connection.png)
+            </Step>
+            <Step title="Select 1Password Connection">
+                Click the **+ Add Connection** button and select the **1Password Connection** option from the available integrations.
+
+                ![Select 1Password Connection](/images/app-connections/1password/app-connection-option.png)
+            </Step>
+            <Step title="Fill out the 1Password Connection Modal">
+                Complete the 1Password Connection form by entering:
+                - A descriptive name for the connection
+                - An optional description for future reference
+                - The URL at which your 1Password Connect Server instance is hosted
+                - The Access Token from earlier steps
+
+                ![1Password Connection Modal](/images/app-connections/1password/app-connection-modal.png)
+            </Step>
+            <Step title="Connection Created">
+                After clicking Create, your **1Password Connection** is established and ready to use with your Infisical projects.
+
+                ![1Password Connection Created](/images/app-connections/1password/app-connection-created.png)
+            </Step>
+        </Steps>
+    </Tab>
+    <Tab title="API">
+        To create an 1Password Connection, make an API request to the [Create 1Password Connection](/api-reference/endpoints/app-connections/1password/create) API endpoint.
+
+        ### Sample request
+
+        ```bash Request
+        curl    --request POST \
+                --url https://app.infisical.com/api/v1/app-connections/1password \
+                --header 'Content-Type: application/json' \
+                --data '{
+                    "name": "my-1password-connection",
+                    "method": "access-key",
+                    "credentials": {
+                        "instanceUrl": "https://1pass.example.com",
+                        "apiToken": "[PRIVATE TOKEN]"
+                    }
+                }'
+        ```
+
+        ### Sample response
+
+        ```bash Response
+        {
+          "appConnection": {
+              "id": "e5d18aca-86f7-4026-a95e-efb8aeb0d8e6",
+              "name": "my-1password-connection",
+              "description": null,
+              "version": 1,
+              "orgId": "6f03caa1-a5de-43ce-b127-95a145d3464c",
+              "createdAt": "2025-04-23T19:46:34.831Z",
+              "updatedAt": "2025-04-23T19:46:34.831Z",
+              "isPlatformManagedCredentials": false,
+              "credentialsHash": "7c2d371dec195f82a6a0d5b41c970a229cfcaf88e894a5b6395e2dbd0280661f",
+              "app": "1password",
+              "method": "api-token",
+              "credentials": {
+                "instanceUrl": "https://1pass.example.com"
+              }
+          }
+        }
+        ```
+    </Tab>
+</Tabs>