Access

The Access page enables administrators to manage user roles by creating Access Groups and access group role assignments for users. The Viewer, Preparer, and Approver roles can be configured to give the user access to certain administrative functions, enabling administrators to provide partial access to specific areas of the solution without granting full access.

Users and Platform Security Groups are created in the OneStream System Administration tab. Administrators can leverage existing application security by adding Users and pre-existing Platform Security Groups to Access Groups on this page. Administrators can also mix and match based on their existing security model.

Manage Access Groups

  1. Select the Insert Row icon.

  2. Enter an Access Group name and description. The Name field is required, and the name must be unique for the Access Group to save.

    The Insert Row button is lines with a plus sign with an orange outline

  3. Select the Save icon.

IMPORTANT: You cannot delete an Access Group if it is actively assigned to a Site. The Access Group must first be removed from all assigned Sites. See Sites.

Manage Roles

The Roles button is a black pencil

Select the Roles button to assign role permissions. In the Viewer, Preparer, and Approver tabs, select the specific solution areas each role will have access to.

The following optional permissions can be assigned to each role:

Role Description
Viewer

Viewers can only view data on the Home page. This role has the following permissions:

  • View ESG Report: run a report on the Reports page

  • View Carbon Calculator: use the Calculate button to view carbon calculations on the Home page

Preparer

Preparers can enter data on the Home page. This role has the following permissions:

  • View ESG Report: run a report on the Reports page

  • View Carbon Calculator: use the Calculate button to view carbon calculations on the Home page

  • Allow User to Reject Submitted Profiles: displays the Reject button on the Home page

Approver

Approvers manage profile statuses. This role has the following permissions:

  • View ESG Report: run a report on the Reports page

  • View Carbon Calculator: use the Calculate button to view carbon calculations on the Home page

  • Allow User to Revert Approved Profiles: displays the Revert button on the Home page

Manage Access Group Members

To add users to an Access Group, complete the following steps:

  1. Select the Access Group from the Access Group grid to display the User and Platform Security Group grids in the pane.

  2. From the Users grid, select the Insert Row icon.

    1. From the User drop-down menu, select a user from the list.

    2. From the Role drop-down menu, select a role for that user.

    3. Select the Save icon.

NOTE: Multiple roles cannot be added to the same user.

To add user groups to an Access Group, complete the following steps:

  1. Select an Access Group from the Access Group grid to display the User and Platform Security Group grids in the pane.

  2. From the Platform Security Groups grid, select the Insert Row icon.

    1. From the Group drop-down menu, select a group from the list.

    2. From the Role drop-down menu, select a role for that user group.

    3. Select the Save icon.

NOTE: Multiple roles cannot be added to the same user group.

The Users grid has a sample user assigned to the Viewer role. The Platform Security Groups field has a sample user group assigned to the Approver role.

The Remove Row icon is lines with an X, flat design style.Select the Remove Row icon to remove a user or user group.

Import Access Groups

The download icon is a down arrow and the import icon is a grid with a plus sign

Use the Download and Import buttons to download a template and import Access Groups and group members.

To import Access Groups and group members, complete the following steps:

  1. Select the Download button to display the Template Options slide-out panel.

  2. From the Select Template drop-down menu, select either Access Groups or Group Members.

  3. Select the Download button. Fill in all required template columns.

    Column Description
    Access Groups Template
    Name Enter a name for the access group.
    Description (Optional) Enter a description for the access group.
    Group Members Template
    Access Group From column drop-down menu, select an access group.
    Member Type From the column drop-down menu, select either Security User or Security Group.
    User or Group Name Enter a user or group name.
    Role

    From the column drop-down menu, select either Preparer, Approver, or Viewer.

  4. To import the template, select the Import button.

  5. In the File Upload window, select the BROWSE button to open File Explorer.

  6. Select the template and select the Open button.

  7. Select the Upload button.