Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

update keeper password setup images

adilson0751a5da01f7
diff --git a/docs/images/secret-syncs/keeper-password-manager/add-users.png b/docs/images/secret-syncs/keeper-password-manager/add-users.png
new file mode 100644
index 0000000000..31e97c9a96
Binary files /dev/null and b/docs/images/secret-syncs/keeper-password-manager/add-users.png differ
diff --git a/docs/images/secret-syncs/keeper-password-manager/change-settings.png b/docs/images/secret-syncs/keeper-password-manager/change-settings.png
new file mode 100644
index 0000000000..47738ddd7c
Binary files /dev/null and b/docs/images/secret-syncs/keeper-password-manager/change-settings.png differ
diff --git a/docs/images/secret-syncs/keeper-password-manager/click-on-edit.png b/docs/images/secret-syncs/keeper-password-manager/click-on-edit.png
new file mode 100644
index 0000000000..b5617027ea
Binary files /dev/null and b/docs/images/secret-syncs/keeper-password-manager/click-on-edit.png differ
diff --git a/docs/images/secret-syncs/keeper-password-manager/click-on-settings.png b/docs/images/secret-syncs/keeper-password-manager/click-on-settings.png
new file mode 100644
index 0000000000..b5192b222d
Binary files /dev/null and b/docs/images/secret-syncs/keeper-password-manager/click-on-settings.png differ
diff --git a/docs/images/secret-syncs/keeper-password-manager/create-shared-folder.png b/docs/images/secret-syncs/keeper-password-manager/create-shared-folder.png
new file mode 100644
index 0000000000..a580e72b32
Binary files /dev/null and b/docs/images/secret-syncs/keeper-password-manager/create-shared-folder.png differ
diff --git a/docs/images/secret-syncs/keeper-password-manager/folder-exists.png b/docs/images/secret-syncs/keeper-password-manager/folder-exists.png
new file mode 100644
index 0000000000..50fe5984b0
Binary files /dev/null and b/docs/images/secret-syncs/keeper-password-manager/folder-exists.png differ
diff --git a/docs/integrations/secret-syncs/keeper-password-manager.mdx b/docs/integrations/secret-syncs/keeper-password-manager.mdx
index 3b407a91fd..8bf8314b56 100644
--- a/docs/integrations/secret-syncs/keeper-password-manager.mdx
+++ b/docs/integrations/secret-syncs/keeper-password-manager.mdx
@@ -9,7 +9,9 @@ import ConnectionFormFields from "/snippets/app-connections/keeper/form-fields.m
A Keeper Password Manager Secret Sync pushes secrets from Infisical into a Keeper shared folder, where the users and teams you share the folder with can read them. Each Infisical secret becomes a login record whose title is the secret's name and whose password field holds the secret's value. The title matches the secret's name unless you customize key names to add a prefix or suffix.
<Note>
- The Keeper Password Manager Secret Sync requires a [Keeper app connection](/integrations/app-connections/keeper). This guide walks you through creating a project-scoped app connection.
+ The Keeper Password Manager Secret Sync requires a [Keeper app
+ connection](/integrations/app-connections/keeper). This guide walks you
+ through creating a project-scoped app connection.
</Note>
## Prerequisites
@@ -23,32 +25,59 @@ The sync writes secrets to a Keeper shared folder that the Infisical user can ma
<Steps>
<Step>
- In your Keeper vault, choose the shared folder Infisical syncs secrets to. You can use an existing shared folder or create a new one.
+ In your Keeper vault, choose the shared folder Infisical syncs secrets to. To create a new shared folder, select **Create New**, then select **Shared Folder**.
+
+ ![Create a shared folder](/images/secret-syncs/keeper-password-manager/create-shared-folder.png)
+ </Step>
+ <Step>
+ In **My Vault**, select the three dot menu next to the shared folder.
+
+ ![Open the folder menu](/images/secret-syncs/keeper-password-manager/folder-exists.png)
+
+ In the folder panel, select the **Settings** tab.
+
+ ![Open the Settings tab](/images/secret-syncs/keeper-password-manager/click-on-settings.png)
+ </Step>
+ <Step>
+ Select **Edit Folder** (the pencil icon).
+
+ ![Edit the folder](/images/secret-syncs/keeper-password-manager/click-on-edit.png)
+
+ On the **Settings** tab, set these permissions:
+
+ - **User Permissions**: **Can Manage Records**, so Infisical can create and delete records
+ - **Record Permissions**: **Can Edit**, so Infisical can update record values
+
+ If the folder already has records, select **Apply permissions to existing records** so the sync can update them. Then select **Save**.
+
+ ![Set the folder permissions](/images/secret-syncs/keeper-password-manager/change-settings.png)
+
+ Keeper gives these permissions only to the users and records you add to the folder after you save the settings.
</Step>
<Step>
- Share the folder with the Infisical user, with these permissions:
+ Share the folder with the Infisical user. Select **Edit Folder** again, then select the **Users** tab. In **Email or Team Name**, enter the Infisical user's email address, select **Add**, then select **Save**.
- - **Manage Records**: On, so Infisical can create and delete records
- - **Can Edit**: On, so Infisical can update record values
- - **Can Share**: Off
- - **Manage Users**: Off
+ ![Add the Infisical user](/images/secret-syncs/keeper-password-manager/add-users.png)
- With **Can Share** and **Manage Users** off, the Infisical user can't give anyone else access to the synced secrets.
+ The Infisical user gets the permissions you set in the previous step. In the **Permissions** column, check that the Infisical user has **Can Manage Records**.
To share the folder from Commander instead, run this command as a user who manages the folder:
```bash
- share-folder -e [email protected] -a grant -p on -o off -d on -s off <folder-uid>
+ share-folder -e [email protected] -a grant -p on -o off -d on -s off <folder-uid>
```
If you'll create the sync through the API, note the folder's UID. The API identifies the folder by its UID, not its name.
</Step>
+
</Steps>
## Step 2: Set up the sync in Infisical
<Tip>
- To create the sync using the API, use the [Create Keeper Password Manager Sync](/api-reference/endpoints/secret-syncs/keeper-password-manager/create) endpoint.
+ To create the sync using the API, use the [Create Keeper Password Manager
+ Sync](/api-reference/endpoints/secret-syncs/keeper-password-manager/create)
+ endpoint.
</Tip>
<Steps>
@@ -159,32 +188,51 @@ The sync writes secrets to a Keeper shared folder that the Infisical user can ma
![Sync Created](/images/secret-syncs/keeper-password-manager/sync-created.png)
</Step>
+
</Steps>
## FAQ
<AccordionGroup>
- <Accordion title="Which records in the shared folder does the sync change?">
- The sync only reads and changes login records directly inside the shared folder. It never reads, changes, or deletes other record types or records in subfolders. If two or more login records have the same title, the sync updates the first one and, unless **Prevent secret deletion** is on, deletes the others.
- </Accordion>
- <Accordion title="Why does a sync fail with rate limit errors?">
- Every sync reads the whole shared folder: one request to list the folder, one request per record in the folder, and one more request for each secret that changed. With `-rl 120/minute`, a folder with about 100 records or more can go over the limit. Start the container with a higher `-rl` value, or split your secrets across several shared folders.
- </Accordion>
- <Accordion title="What happens when the Commander session expires?">
- Commander rejects every command, and the sync shows Commander's error. Sign in to Commander on the host again, as in [Set up Keeper Commander](/integrations/app-connections/keeper#step-1-set-up-keeper-commander), then restart the container with `docker restart keeper-service`.
- </Accordion>
- <Accordion title="Why is a shared folder rejected when I save the sync?">
- Commander Service Mode can't run commands on a folder whose UID starts with `-`, so Infisical rejects that folder. [Configure a different shared folder](#step-1-configure-a-shared-folder) for the sync.
- </Accordion>
+ <Accordion title="Which records in the shared folder does the sync change?">
+ The sync only reads and changes login records directly inside the shared
+ folder. It never reads, changes, or deletes other record types or records in
+ subfolders. If two or more login records have the same title, the sync
+ updates the first one and, unless **Prevent secret deletion** is on, deletes
+ the others.
+ </Accordion>
+ <Accordion title="Why does a sync fail with rate limit errors?">
+ Every sync reads the whole shared folder: one request to list the folder,
+ one request per record in the folder, and one more request for each secret
+ that changed. With `-rl 120/minute`, a folder with about 100 records or more
+ can go over the limit. Start the container with a higher `-rl` value, or
+ split your secrets across several shared folders.
+ </Accordion>
+ <Accordion title="What happens when the Commander session expires?">
+ Commander rejects every command, and the sync shows Commander's error. Sign
+ in to Commander on the host again, as in [Set up Keeper
+ Commander](/integrations/app-connections/keeper#step-1-set-up-keeper-commander),
+ then restart the container with `docker restart keeper-service`.
+ </Accordion>
+ <Accordion title="Why is a shared folder rejected when I save the sync?">
+ Commander Service Mode can't run commands on a folder whose UID starts with
+ `-`, so Infisical rejects that folder. [Configure a different shared
+ folder](#step-1-configure-a-shared-folder) for the sync.
+ </Accordion>
</AccordionGroup>
## Next steps
<CardGroup cols={2}>
- <Card title="Keeper" icon="plug" href="/integrations/app-connections/keeper">
- Create a Keeper connection at the organization level to share it across projects.
- </Card>
- <Card title="Overview" icon="refresh-cw" href="/integrations/secret-syncs/overview">
- See every destination you can sync secrets to.
- </Card>
+ <Card title="Keeper" icon="plug" href="/integrations/app-connections/keeper">
+ Create a Keeper connection at the organization level to share it across
+ projects.
+ </Card>
+ <Card
+ title="Overview"
+ icon="refresh-cw"
+ href="/integrations/secret-syncs/overview"
+ >
+ See every destination you can sync secrets to.
+ </Card>
</CardGroup>