Server

Security

Updated: December 17, 2024

A permission is a rule to grant access to a user or set of users to a Nuxeo document. User has a view in the dashboard where he can see the documents on which a permission is set. Managing permissions means granting or denying access permissions in a document or folder.

Some permissions are granted automatically, for example when you create a workflow and grant access to a user on a document for the entire workflow or a particular task.

Permissions Overview

Permission Actions in Workspaces Actions in Sections
Read
  • Consult content
  • Comment documents
  • Collect content
  • Follow content
  • Consult content
  • Comment documents
  • Follow content
ReadWrite
  • Create documents
  • Edit documents
  • Tag documents
  • Add / remove relations
  • Start a workflow
  • Delete documents
  • + Read actions
  • Create sections
  • Tag documents
  • Unpublish documents
  • Delete sub-sections
  • + Read actions
Everything
  • Manage permissions
  • Set alerts to other users
  • Apply a preset look on documents
  • Manage deleted documents
  • Define publication targets
  • + Edit actions
  • + Read actions
  • Manage permissions
  • Set alerts to other users
  • Apply a preset look on documents
  • Manage deleted documents
  • + Edit actions
  • + Read actions
Can ask for publishing   Submit documents for publishing

Granting Permissions to the Application Users and Groups

To add a permission, at the root of a workspace, a folder or a document, click on the Permission tab New Permission and fill in the popup form.

The new permission is displayed in the Permissions defined locally part of the screen.

Granting Permissions to External Users (Instant Share)

Granting permissions via Instant Share makes it possible to share content with external users who do not have access to the platform.

An existing user can give permissions to external users on a workspace, folder, document, etc. Therefore, external users receive an email with a link to access a specific document or space. When users click the link and access the content that was shared with them, they can act on it depending on the permissions set for them.

External users can also access the Search menu, which can be useful when navigating through lots of documents in a whole workspace, for example.

To grant permissions to external users via Instant Share:

  1. Open the workspace, folder or document you want to share.
  2. Open the Permissions tab.
    Managing Permissions - Permissions tab.png
    Managing Permissions - Permissions tab.png
  3. From the Permissions assigned to external users section, click on the New button.


    Permissions already set to external users display in this area.

  4. Fill in the following information:

    • Email of the external user (directly type it over the example)
    • Right granted (Read, ReadWrite or Everything: see Permissions for more information)
    • From/To: start and end dates of the granting
    • Notification email: you can leave the message by default or customize it here. (optional)

You can share documents and folders with people that don't usually have access to the application, using their email.

In the Permissions Assigned to External Users part of the screen, click New and fill in the popup form. The external user receives an email notification that contains the link to the document or space. They can access the application only by clicking that link.

Notes:

  • You can only grant a temporary access to external users.
  • External users have not created a user account on the application. They do not have login / password credentials. They can only use the link that is sent to them to access the application.
  • External users have access to the content that was shared with them (either documents or workspaces and their content) and the Search tab.
  • External users do not benefit from the personal workspace, the Home tab and their features (dashboard, alerts, users / groups search, etc.).
  1. Click on the:
    • Cancel icon to cancel the granting of the access
    • Create icon to grant access to the external user
    • Create and add another icon to grant access to the user and directly re-open the popup for granting access to another user

When created, the granted access is saved and displayed in the Permissions assigned to external users section. The external user you granted permissions to receives an email with a link to access the desired document(s).


At this stage, you can click on the:


  • Edit icon to display the Update Permission popup and update the needed information
.
  • Send again icon to send the permission again to the external user
.
  • Delete icon to remove the already recorded permission of the external user.

Managing Permissions - Actions.png
Managing Permissions - Actions.png

To access the Nuxeo Platform as an external user:

  1. Open your mailbox.
    There you can find an email sent by a Nuxeo user granting you access to a specific document/space.

  2. Click on the hyperlink to access the platform and the content.

    At this stage, your web browser opens on the Nuxeo Platform and directly places you on the content you have permission on. Depending on the set permissions, you can now view and/or act on the content and use the Search menu to navigate through the documents you have access to.

You do not benefit from the Home menu and its features (dashboard, alerts, users/groups search, etc.).

Editing Permissions

To edit a permission click on next to it, from there you can modify the permission and/or the date frame.

Deleting Permissions

To delete a permission click on next to the permission you want to delete, click Ok on the confirmation popup.

Blocking Rights Inheritance

The rights that are granted or denied in a space are applied to the space's content, including its sub-spaces. You thus have the same rights in the sub-spaces as in the parent space. That is called rights inheritance.

You can block this inheritance. It enables you to block the access of a sub-workspace to the workspace's users, for instance, or to deeply modify the access rights in the sub-workspace.

To block rights inheritance:

  1. Click on the Permissions tab of the space of which you want to the access rights. The Access Rights sub-tab is displayed.
  2. Click on the Block button located under the PERMISSIONS INHERITED FROM UPPER LEVELS table.

    Now that only local permissions are applied, any change made on parent document won't affect the access conditions to this document. You and the administrators will be added to local permissions.

  3. You can now grant access rights to specific users.