About Visual Permissions

This applies to: Visual Data Discovery

Visual permissions allow you to permit your entire account, groups within your account, or users within your account to read, write, or delete a visual. This allows you to share a visual with other users.

If a user belongs to a group that has the Administer Visuals privilege enabled, the user can read, add, modify, or remove any visual in the Symphony account. However, if the user does not belong to a group with this privilege enabled, the user can still be granted permission to read, write, or delete specific visuals in the account using visual permissions. Visual permissions allow users in an account or group to read, write, or delete a visual, regardless of any group privilege settings that ordinarily limit their ability to do so.

To manage permissions of a visual, your Symphony user definition must meet one of the following criteria:

  • It must be an administrator, belonging to the Administrators group

  • It must belong to a group with the Administer Visuals (ROLE_ADMINISTER_VISUALS) privilege enabled.

  • It must belong to a group with the Manage Visual Permissions (ROLE_PERMISSION_VISUALS) privilege enabled. If your user definition has only this privilege (and not the Administer Visuals privilege), you will only be able to manage permissions for the visuals you can read.

    In addition, you may be restricted in which permissions you can assign. You can only assign permissions equivalent to your own. For example, if your user account has read permission for a visual, you can grant and revoke the read option available on the Visual Permissions panel. If you have write permission for a visual, you can grant and revoke the write option on the Visual Permissions panel.

    If your user definition does not have read permission for a visual, you cannot view the visual in the Visual Gallery. If your user definition does not have write permission for a visual, you cannot save the visual.

Visual permissions are determined using a most permissive model. For more information, see How Visual Permissions Are Determined.

Visual permission specifications can also be made using the API endpoints GET api/visuals?includePermissions=true, PATCH /api/visuals/<visualId>/acls/bulk, GET /api/visuals/<visualId>/acls, and /api/user/permissions/visuals/<visualId>.

API documentation is provided with your Symphony installation at this link: <symphony-URL>/discovery/swagger-ui.html.

For more information, see the following topics: