Roles

Last Updated: November 10, 2026

Roles are a key element of D3's access control system. A role decides which modules and actions its users can use, which keeps responsibilities and visibility separate. Unlike groups, which are collections of users, each user has exactly one role.

READER NOTE

Organization Management, where roles are managed, is an administrator area: a role's Administrator switch gives additional access to Tenant Management, Organization Management and Application Settings.

Adding a Role

  1. Go to Global Settings > Organization Management > Roles.

    The Global Settings sidebar with Organization Management expanded and Roles selected
  2. Select Add Role.

    The top of the Roles page with the search box, Default Role and the Add Role button
  3. Fill in the New Role panel:

    The New Role panel with the Morpheus AI section, and its Enable All, above Configuration Modules
    • Enter a Role Name (up to 50 characters).

    • (Optional) Enter a Description.

    • (Optional) Switch on Two-Factor Authentication to require a verification code by email at sign-in for everyone with this role.

    • Choose the Access Type. Switch on Administrator only for roles that need Tenant Management, Organization Management and Application Settings. Switching on Administrator also selects the Morpheus AI privileges, except Run Apps.

  4. Under Morpheus AI, Configuration Modules and Operational Modules, select the modules and actions the role needs. Enable All selects every option in its own section only. The Enable All of Configuration Modules does not select the Morpheus AI privileges, so a role that needs both uses Enable All in each section (see Morpheus AI Privileges below). For example, Playbook Configuration has View Playbooks, Edit Playbooks and Publish Playbooks, which apply to both preprocessing and investigation playbooks; and Incident, under Operational Modules, holds the incident actions, among them Create New Tag and Delete Tag. Create New Tag lets the role add a tag to an incident. Delete Tag lets it remove a tag from the site's suggested tag list, which affects every user (see Incident Workspace).

    05-operational.png
  5. Select Save. The role is listed on the Roles page.

Morpheus AI Privileges

The Morpheus AI section of a role holds the privileges for Morpheus AI features, so that you can grant AI access in one place. It sits directly above Configuration Modules when you add or edit a role.

Privilege

Description in the panel

Adaptive Tasking (formerly AI Chat)

Use Adaptive Tasking on incidents

Create Adaptive Playbook

Generate new Adaptive Playbooks from chat directives

Edit APD Disposition Rules (APD is Attack Path Discovery)

Save drafts, publish, and apply feedback to APD disposition rules

Playground, with Create App and Edit App

View published apps. Without Create App or Edit App, view only

Run Apps

Run published apps in incident widgets, without Playground access

  • Enable All at the right of the section title selects every privilege the section shows, Run Apps included. Once all are selected, it reads Disable All.

  • Switching on Administrator selects every privilege in the section except Run Apps. Select Run Apps yourself if the role needs it.

  • Upgrading D3 does not change any existing role's privileges.

READER NOTE

The Morpheus AI section appears only when the role's Access Type is General. If you change a role to ReadOnly or Clients, its Morpheus AI privileges are removed when you save the role. An existing App Only role always keeps Playground, which its apps need.

READER NOTE

Some privileges appear only when their feature is turned on for the site. Adaptive Tasking needs Adaptive Tasking. Create Adaptive Playbook needs both Adaptive Tasking and Adaptive Playbooks. Playground, Create App, Edit App and Run Apps need App Playground. Edit APD Disposition Rules always appears. These features are off by default; contact D3 Support to turn them on. A privilege that does not appear cannot be granted.

Adding Users to a Role

NOTE

A user has only one role at a time. A user's role is also set in the user's own panel (see Creating Users).

  1. Select the role, open its Users tab and select Edit Users.

    A role's Users tab with no users yet and the Edit Users button
  2. In Add or Remove Users, select users under Available and move them to Assigned with the arrow button, then select Save.

    07-edit-users.png

For every option of a role, see Organization Management.