--- title: "Roles & permissions | Darwinium" slug: "configuring-roles-access" description: "Configure Darwinium roles and permissions to control access to portal features, administration, and data workflows." updated: 2026-10-16T02:27:18Z published: 2026-06-23T07:23:48Z canonical: "docs.darwinium.com/configuring-roles-access" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.darwinium.com/llms.txt > Use this file to discover all available pages before exploring further. # Roles & permissions ## Quick Guide: Adding User & Role **Add User** 1. Navigate to: **Your Name (top right)** **> Users** 2. Select +**Add User** 3. Fill out Email, First Name Last Name 4. **Save User** 5. Email will be sent activation link and they will be able to log in. But user won't see any nodes or data until given a **role** ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/image-1715591132104.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A16%3A49Z&se=2026-11-23T00%3A16%3A49Z&sr=b&sp=r&sig=jX5s0NWUeCbUxyrSkFea1Q8u52hs7OSLiKOlHlOb800%3D) **Assign User a Role** 1. Navigate to: **Your Name (top right)** **> Roles** 2. On an existing appropriate role row, click: **Actions> Edit** 1. If an appropriate Role does not exist yet, can **Add Role** (see below) 3. In Edit Existing Role, click Users 4. Tick the User(s) in left hand box ('Available') and move them to right hand box ('Active') with the arrows 5. Click **Save Role** 6. User should now have appropriate role after logging out/in. ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/image-1715591286171.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A16%3A49Z&se=2026-11-23T00%3A16%3A49Z&sr=b&sp=r&sig=6xzHaVZYLXUy2wEOe%2FGeLzMwjmeT%2FqE1NxIVHWAyDw0%3D) Note: A User and Role is needed to access Darwinium Portal even when SSO is being used. ## Roles **Users** are granted access to various permissions in Darwinium through the use of **Roles.** A role consists of one or more priveleges assigned to a given set of consituent users. A user may be assigned to multiple roles. The roles section of Darwinium is accessed via **Your Name (top right)** **> Roles** You may not see this section depending on your accessOnly users with permission to view or edit roles are able to see this menu item With the exception of the **Administrator** **role**, roles may be added or removed at will. The **Administrator role**, by default, has access to all resources on the system. It is best practice to avoid adding users who do not absolutely require access to this role. ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/image-1715590684409.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A16%3A49Z&se=2026-11-23T00%3A16%3A49Z&sr=b&sp=r&sig=ySfyXi%2BvkPDk0TgCvdhUChEFWZ98Uvw8%2F3Xh%2FWZva30%3D) ## Permissions explained When creating or editing roles, you are required to define permissions. Find in: **Your Name (top right) >Roles > Edit (box in role row) >** **Permissions tab***.***** ***![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/Screenshot%202025-11-10%20at%2011.23.45.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A16%3A49Z&se=2026-11-23T00%3A16%3A49Z&sr=b&sp=r&sig=eRQMVP5KRYKh5OOyq33ZBslEseBp5wN8loqE1t59Hls%3D)![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/Screenshot%202025-11-10%20at%2011.21.54.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A16%3A49Z&se=2026-11-23T00%3A16%3A49Z&sr=b&sp=r&sig=gWldggdmqFOew2bwP3Oy0VYRUnNOH7zrB%2Fq1BSVEqqk%3D)*** Darwinium has 2 types of permission: - Org permissions - These apply across the organization and across all Darwinium node instances - Node Permissions - These are permissions applied to a specific node (you may have several nodes in the system eg: Production vs Staging vs Development) ### Org Permissions ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/Screenshot%202026-06-23%20at%2008.14.25.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A16%3A49Z&se=2026-11-23T00%3A16%3A49Z&sr=b&sp=r&sig=atqHqk3eXBHk1ud5wN0v8faPtn11CYNdnUuBBbQRncM%3D) - **APIs:** - **Administrate**: legacy permission retained for backward compatibility; it no longer governs access to certificate management and only affects minor conveniences (cert-expiry notifications). - **Audit:** - **read:** Can see internal Darwinium Portal user activity like logins, searches, user creation (Your Name > Audit Logs) - **Certs:** - **manage:** permission gives users ability to navigate to API Access screen, where they can issue/upload MTLS certificates, set each certificate’s per-node capabilities, and revoke certificates. - **Nodes:** - **Read:** Users may list nodes in the system and view node deployment logs, but may not edit a nodes settings or delete a node - **Delete :** Users may delete nodes in the organizations node list - **Roles** - **Create**: users may create new roles, and define their permissions, but may not update existing roles if they are not also granted the **update** role. - **Delete:** Users may delete existing roles - **Read**: Users may view the permissions and assigned users for an existing role, but may not make any updates or delete roles. - **Update:** Users have the permission to view and update changes to existing roles, but may not delete existing roles. - **Templates** - **administrate:** can add or delete Portal Investigations templates - **Users** - **Create**: users may create new users, but may not update the details of existing users other than themselves if they are not also granted the **update** role. - **Delete:** Users may delete existing users other than themselves - **Read**: Users may view the users that exist within their organization, but may not make any updates or delete existing users. - **Update:** Users have the permission to view and update users, but may not delete users. ### Node Permissions These Workflow permissions exist for each node. eg. A role may allow someone to deploy in test, but not in production ![](https://cdn.document360.io/db6f7316-640d-4099-b5a1-b01b4dbd17fc/Images/Documentation/Screenshot%202025-11-10%20at%2011.15.28.png?sv=2026-02-06&spr=https&st=2026-11-22T23%3A16%3A49Z&se=2026-11-23T00%3A16%3A49Z&sr=b&sp=r&sig=elcF%2BRG%2F8qjOueQD9Gk%2Bh5l9h92WBwrexvVzcK5qwXI%3D) **Permission Level:** [No Access | Read Only | Write | Write and Approve Changes ] Denotes the level of access that the role has to Author updates to workflows (i.e. Journeys, Rules, Features that are published to a given site): - **No Access:** User cannot see the workflows view at alll - **Read only:** User may view the contents of the journey git repository, but may not submit any changes to it - **Write:** User has permission to push changes back to any branch other than the master branch. Changes to the master branch are used to deploy changes to infrastructure, and thus they must be approved by a role that has Write and Approve Changes Permission - **Write and Approve changes**: User may update the git repo on all branches, and their account has the ability to deploy changes to edge workers **Allowed to create/edit .journey.yaml files:** Allows user to create completely new journey files **PII: [true | false]** - Denotes whether users of this role have permission to decrypt Personally Identifiable Information (PII). If this value is unchecked, the user will see an elliptic-curve-hash representation of PII attributes. For more information on which attributes are PII, see [Attribute Reference](/v1/docs/attribute-reference). **SPII: [true | false]** - Denotes whether users of this role have permission to decrypt Special Personally Identifiable Information (SPII). If this value is unchecked, the user will see an elliptic-curve-hash representation of PII attributes. For more information on which attributes are SPII, see [Attribute Reference](/v1/docs/attribute-reference). **Deployments::** - **Allowed to view/edit deployment settings:** Gives access to Node Settings pane. This is where Edge deployment target information exists, so usually restrict to DevOps / Engineering resources - **Allowed to deploy builds:** Gives permission to initiate the deployment process, which pushes journey and decisioning changes to their targets (API endpoint or Edge workers).