Skip to content

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

docs(folder-access): refresh Manage Permissions screenshots (#8844)

Andrew Huange7bee99ac87a
diff --git a/docs/documentation/platform/access-controls/folder-rbac.mdx b/docs/documentation/platform/access-controls/folder-rbac.mdx
index 645a6c0de7..3f4cd843c2 100644
--- a/docs/documentation/platform/access-controls/folder-rbac.mdx
+++ b/docs/documentation/platform/access-controls/folder-rbac.mdx
@@ -17,9 +17,9 @@ If you're self-hosting Infisical, contact [email protected] to purchase a lice
When you give a single user or machine identity a role on a folder, that role takes precedence over their [project role](./role-based-access-controls). You can use folder access to:
-- Give someone access to a single folder their project role doesn't reach.
-- Hold someone to a lower role inside a sensitive folder.
-- Hand out short-lived access for an incident or a one-off task.
+- Give someone access to a single folder their project role doesn't reach
+- Hold someone to a lower role inside a sensitive folder
+- Hand out short-lived access for an incident or a one-off task
A folder role only applies to the exact folder you set it on.
@@ -47,7 +47,7 @@ There are five different folder access roles, listed here from least to most pri
## Granting folder access
<Steps>
- <Step title="Open the folder access sheet" titleSize="h3">
+ <Step>
Navigate to your project's **Secrets** page and select an environment. You can set access on the folder you're currently viewing, or on any folder in the list. To set access on the current folder, select **Manage Access** at the right end of the folder path, above the secrets table.
![Open folder access from the environment view](/images/platform/access-controls/folder-rbac/open-folder-access-from-environment.png)
@@ -57,40 +57,37 @@ There are five different folder access roles, listed here from least to most pri
![Open folder access from a folder row](/images/platform/access-controls/folder-rbac/open-folder-access-from-folder-row.png)
</Step>
- <Step title="Review and set access for current members" titleSize="h3">
- The **Manage Permissions** sheet lists everyone who can already reach this folder through their project roles. Anyone whose access comes from a project role rather than a grant shows an **Access from project role** selector, and hovering over it names their roles.
+ <Step>
+ Review the **Manage Permissions** sheet. The list shows users and machine identities with folder grants or access through their project roles. To override project access in this folder, open the role menu with the **Project** badge and choose a folder role.
![Manage Permissions sheet](/images/platform/access-controls/folder-rbac/manage-permissions-sheet.png)
- Use the dropdown on any row to set their folder role. The same menu lets you add temporary access or remove access. Project admins appear as having full access on all folders and cannot be given a folder grant.
+ To change an existing grant, open the row's role menu, then open the current role's submenu and choose a new role. Project admins have full access on all folders and can't receive a folder grant.
![Folder role dropdown](/images/platform/access-controls/folder-rbac/folder-role-dropdown.png)
</Step>
- <Step title="Add access" titleSize="h3">
- Select **Add Access** and pick the user or machine identity you want to assign a role to. This list includes project identities who have no access to this folder at all. Choose a role, optionally set a duration under **Temporary access**, then select **Add Access** to save.
+ <Step>
+ Search for a user or machine identity, or expand **No Access**. Select **Grant Access** beside the member, then choose a role. Changes save automatically.
- ![Add Access sheet](/images/platform/access-controls/folder-rbac/add-folder-access-sheet.png)
+ ![Grant folder access from search results](/images/platform/access-controls/folder-rbac/grant-folder-access.png)
- </Step>
- <Step title="Check the result" titleSize="h3">
-
- If a user/identity's usual project permissions would change after being granted the folder access role, that user/identity is marked with **Overrides project role**:
-
- ![Overrides project role badge](/images/platform/access-controls/folder-rbac/overrides-project-role-badge.png)
+ If you can add project members, the **In Organization, Not in Project** subsection also lists organization members outside the project. Granting access from this subsection adds the member to the project with the **No Access** project role before granting folder access.
- Each row now shows their role in a dropdown, which you can use to change or remove it later.
-
- ![Folder access list](/images/platform/access-controls/folder-rbac/folder-access-list.png)
+ </Step>
+ <Step>
+ Confirm that the member appears in the access list with the role you chose. If the grant replaces access from a project role, the row shows an **Override** badge.
</Step>
</Steps>
## Setting temporary access
-Access can be time-bound so you can choose a duration when you add it, or open the role dropdown on an existing row and set one there. The row then shows how long is left, and once the window elapses the access stops applying immediately and the user or identity falls back to their project roles.
+To set an expiration, open an existing folder grant's role menu and select **Add Temporary Access** or **Edit Temporary Access**. Enter a duration, such as `4h`, then select **Apply**.
+
+![Set a duration in the Temporary Access dialog](/images/platform/access-controls/folder-rbac/temporary-access-dialog.png)
-![Remaining time on a temporary grant](/images/platform/access-controls/folder-rbac/temporary-access-remaining-time.png)
+The row shows the time remaining. Once the grant expires, the user or machine identity falls back to their project roles.
<Note>
Full Access can't be temporary. A Full Access holder can grant folder
diff --git a/docs/images/platform/access-controls/folder-rbac/add-folder-access-sheet.png b/docs/images/platform/access-controls/folder-rbac/add-folder-access-sheet.png
deleted file mode 100644
index c1bd64419d..0000000000
Binary files a/docs/images/platform/access-controls/folder-rbac/add-folder-access-sheet.png and /dev/null differ
diff --git a/docs/images/platform/access-controls/folder-rbac/folder-access-list.png b/docs/images/platform/access-controls/folder-rbac/folder-access-list.png
deleted file mode 100644
index 6307898fe7..0000000000
Binary files a/docs/images/platform/access-controls/folder-rbac/folder-access-list.png and /dev/null differ
diff --git a/docs/images/platform/access-controls/folder-rbac/folder-role-dropdown.png b/docs/images/platform/access-controls/folder-rbac/folder-role-dropdown.png
index cadaa0d2f5..7804fe43aa 100644
Binary files a/docs/images/platform/access-controls/folder-rbac/folder-role-dropdown.png and b/docs/images/platform/access-controls/folder-rbac/folder-role-dropdown.png differ
diff --git a/docs/images/platform/access-controls/folder-rbac/grant-folder-access.png b/docs/images/platform/access-controls/folder-rbac/grant-folder-access.png
new file mode 100644
index 0000000000..3a22f01c49
Binary files /dev/null and b/docs/images/platform/access-controls/folder-rbac/grant-folder-access.png differ
diff --git a/docs/images/platform/access-controls/folder-rbac/manage-permissions-sheet.png b/docs/images/platform/access-controls/folder-rbac/manage-permissions-sheet.png
index 1915e15509..9f449c2054 100644
Binary files a/docs/images/platform/access-controls/folder-rbac/manage-permissions-sheet.png and b/docs/images/platform/access-controls/folder-rbac/manage-permissions-sheet.png differ
diff --git a/docs/images/platform/access-controls/folder-rbac/overrides-project-role-badge.png b/docs/images/platform/access-controls/folder-rbac/overrides-project-role-badge.png
deleted file mode 100644
index 21b4afa91f..0000000000
Binary files a/docs/images/platform/access-controls/folder-rbac/overrides-project-role-badge.png and /dev/null differ
diff --git a/docs/images/platform/access-controls/folder-rbac/temporary-access-dialog.png b/docs/images/platform/access-controls/folder-rbac/temporary-access-dialog.png
new file mode 100644
index 0000000000..1188fc863d
Binary files /dev/null and b/docs/images/platform/access-controls/folder-rbac/temporary-access-dialog.png differ
diff --git a/docs/images/platform/access-controls/folder-rbac/temporary-access-remaining-time.png b/docs/images/platform/access-controls/folder-rbac/temporary-access-remaining-time.png
deleted file mode 100644
index 0a6eeb1c55..0000000000
Binary files a/docs/images/platform/access-controls/folder-rbac/temporary-access-remaining-time.png and /dev/null differ