3 Manage Users, Groups, and Application Roles
As the service administrator or security administrator, you manage users and their access to subject areas and objects.
About Managing Users, Groups, and Application Roles
As the service administrator or security administrator, one of your initial tasks is to ensure that users have appropriate access to use Oracle NetSuite Analytics Warehouse.
Users need access to objects and data. Access to objects include subject areas or elements of subject areas such as folders and attributes, key metrics, workbooks, and the legacy Oracle BI Enterprise Edition dashboards and answers. You grant access to the users by assigning groups to them. The groups inherit the permissions from the application roles including the licensed roles (from release Platform 23.R4) mapped to them.You set up your security components on the production environment.
The enhanced security capabilities available from release Platform 23.R4 enable you to use the licensed application roles corresponding to the existing licensed groups made available in this release onwards. You can assign the licensed application roles to your custom groups. These licensed application roles are mapped by default to the existing ready-to-use licensed groups and are associated with the system roles. When you assign these ready-to-use licensed groups and custom groups to users, then the applicable users get the system privileges such as consumer, author, and administrator. You can continue to use the existing security capabilities till Oracle NetSuite Analytics Warehouse automatically applies them as part of the release 24.R2. These changes are mandatory and you can schedule the update sooner to enhance the security of your application.
About Users
Users accessing Oracle NetSuite Analytics Warehouse must exist in Oracle Identity Cloud Service.
You can create the users or synchronize them with the Oracle Identity Cloud Service instance associated with your Oracle NetSuite Analytics Warehouse instance from different sources:
- You can synchronize the Netsuite users with the Oracle Identity Cloud Service instance using the Configuration page for Oracle NetSuite Analytics Warehouse in NetSuite.
- You can manually create users in the Oracle Identity Cloud Service instance using the Oracle NetSuite Analytics Warehouse user interface.
- You can synchronize the users from other 3rd-party systems with the Oracle Identity Cloud Service instance.
Users gain their access to Oracle NetSuite Analytics Warehouse based on the NetSuite Analytics Warehouse-specific system groups assigned to them. They gain access to different functionality, objects, and data in Oracle NetSuite Analytics Warehouse based on the job-specific groups assigned to them.
You can assign the predefined system groups, groups available in the Oracle Identity Cloud Service instance associated with your Oracle NetSuite Analytics Warehouse instance, and custom groups that you create in Oracle NetSuite Analytics Warehouse. See Associate Users and Groups.
About Groups
Oracle NetSuite Analytics Warehouse uses groups to provide users access to subject areas, objects, and data.
- System groups created in Oracle Identity Cloud Service specifically for Oracle NetSuite Analytics Warehouse. These system groups are associated with system roles that provide a set of privileges to the users to perform system tasks after signing into Oracle NetSuite Analytics Warehouse, such as administering system settings, performing functional setup, managing security, and modeling data.
- Other groups that are generic groups created in Oracle Identity Cloud Service not specifically for Oracle NetSuite Analytics Warehouse, such as IDCS_Administrators and All_Tenant_Users.
System Groups
Oracle NetSuite Analytics Warehouse creates the system groups in Oracle Identity Cloud Service while provisioning your Oracle NetSuite Analytics Warehouse instance.
- Authenticate a user for Oracle NetSuite Analytics Warehouse.
- License a user to use Oracle NetSuite Analytics Warehouse based on the system group they are assigned.
See System Roles and Licensed Roles.
System Group Code | System Group Name | Description | Associated System Role* | Associated Licensed Application Role from release Platform 23.R4 Onwards |
---|---|---|---|---|
NAW_Licensed_Authors | NAW Licensed Authors | NetSuite Analytics Warehouse Licensed Users | Author | NAW Licensed Authors Role |
NAW_Licensed_Users | NAW Licensed Users | NetSuite Analytics Warehouse Licensed Users | Author | NAW Licensed Authors Role |
NAW_Licensed_Viewers | NAW Licensed Viewers | NetSuite Analytics Warehouse Licensed Viewers | Consumer | NAW Licensed Viewers Role |
NAW_Service_Admin | NAW Service Admin | NetSuite Analytics Warehouse Service Administrators | ServiceAdmin | NAW Service Admin Role |
Other Groups
The Other Groups category refers to groups created in Oracle Identity Cloud Service for purposes such as administrating Oracle Cloud Infrastructure and Oracle Identity Cloud Service.
These groups aren't necessarily Oracle NetSuite Analytics Warehouse-specific but you can use them in Oracle NetSuite Analytics Warehouse. Examples of this category are the "IDCS_Administrators" and "All_Tenant_Users" groups.
About Application Roles
Application roles in Oracle NetSuite Analytics Warehouse consist of duty roles.
Duty roles define the duties of a job as an entitlement to perform a particular action; for example, access to a Sales functional area-related subject areas.
Duty Roles
The predefined duty roles to secure the predefined subject areas and the predefined front-end objects are:
Duty Role Name | Duty Role Description | Functional Area | Gets access to Subject Area Display Name OR Associated Role |
---|---|---|---|
NetSuite Analytics Warehouse Sales Duty | Object security role to control presentation catalog access to Sales functional area. | Sales | All subject areas under the Sales functional area. |
NetSuite Analytics Warehouse Purchases Duty | Object security role to control presentation catalog access to Purchases functional area. | Purchases | All subject areas under the Purchases functional area. |
NetSuite Analytics Warehouse Inventory Duty | Object security role to control presentation catalog access to Inventory functional area. | Inventory | All subject areas under the Inventory functional area. |
Data Warehouse Refresh and Usage Tracking Analysis Duty | Object security role to control presentation catalog access to Warehouse Refresh and Usage Tracking subject areas. | Not applicable | Warehouse Refresh and Usage Tracking subject areas. |
NetSuite Analytics Warehouse Financials Duty | Object security role to control presentation catalog access to Financials functional area. | Financials | All subject areas under the Financials functional area. |
NetSuite Analytics Warehouse Manufacturing Duty | Object security role to control presentation catalog access to Manufacturing functional area. | Manufacturing | All subject areas under the Manufacturing functional area. |
NetSuite Analytics Warehouse Payroll Duty | Object security role to control presentation catalog access to Payroll functional area. | Payroll | All subject areas under the Payroll functional area. |
Licensed Roles
The licensed application roles corresponding to the existing licensed groups made available in release Platform 23.R4 onwards are as follows.
The licensed application roles are by default associated with the applicable system roles described in System Roles.
Licensed Role | Associated System Role | Mapped to Licensed Group |
---|---|---|
NAW Service Admin Role | Service Administrator | NAW Service Admin |
NAW Licensed Authors Role | Author | NAW Licensed Author |
NAW Licensed Viewers Role | Consumer | NAW Licensed Viewer |
System Roles
The system roles for Oracle NetSuite Analytics Warehouse available in Oracle Identity Cloud Service through provisioning of Oracle NetSuite Analytics Warehouse are:
Role Name | Role Description | Purpose | Permissions |
---|---|---|---|
Service Administrator | Oracle NetSuite Analytics Warehouse service administrator | Customer facing (Snapshots, Connections, System Settings) administrator access to Oracle NetSuite Analytics Warehouse. |
|
Author | Oracle NetSuite Analytics Warehouse author | Create and edit KPIs, cards, decks, visualization projects, reports, and dashboards. |
|
Consumer | Oracle NetSuite Analytics Warehouse consumer | Read access to Oracle Analytics Cloud content and can create cards and decks. |
|
About Data Access through Security Assignments
You grant the data security assignments at the user-level.
Data security assignments apply data filters to display only the data corresponding to the security assignment values assigned to the users. For example, John Smith and Marie Pierce are both Accounts Payable Manager in an organization, but John Smith needs to see only the US business unit-specific data and Marie needs to see only the UK business unit-specific data. Even though both have the same functional role, their data security assignments differ. John is assigned all the US business units and Marie is assigned all the UK business units only.
You ensure data-level security with a combination of data roles, security context, and security assignments assigned to the user. Oracle NetSuite Analytics Warehouse maps a security context 1:1 onto a data role. You grant the data security assignments within a security context. The user must have the data role through the group assigned to them in order to have access to the security context and its corresponding list of values to pick from. You assign a user one or more job-specific groups. The groups have data roles mapped to them, and when querying data, the semantic layer applies the data filters.
Manage Users
As a service or security administrator, you must ensure that you add users with applicable permissions to work with Oracle NetSuite Analytics Warehouse.
Topics:
- Create Users in Oracle Identity Cloud Service
- Create Users in Oracle NetSuite Analytics Warehouse
- License the Users to Access Oracle NetSuite Analytics Warehouse
- Update the User Details
- Remove a User’s Access to Oracle NetSuite Analytics Warehouse
- Copy Data Security Assignments
- Assign Groups to Users
- Remove Groups Assigned to a User
About Password Policy for Users Created in Oracle NetSuite Analytics Warehouse
The password policy for the users created in Oracle NetSuite Analytics Warehouse is as follows:
- The enforced password requirements are:
- Passwords must not contain the user's first name, last name, or username.
- Oracle NetSuite Analytics Warehouse remembers the 4 previous passwords.
- Password length (minimum) must be 12.
- Password length (maximum) must not cross 40.
- The complexity required in the password is:
- Minimum 1 numeric character.
- Minimum 1 lowercase character.
- Minimum 1 uppercase character.
- The account is locked after 5 unsuccessful attempts for a duration of 30 minutes.
- The passwords don’t expire.
- Any user can reset passwords and a user can reset their own passwords.
Create Users in Oracle Identity Cloud Service
Create users in the Oracle Identity Cloud Service instance associated with your Oracle NetSuite Analytics Warehouse instance.
Create Users in Oracle NetSuite Analytics Warehouse
Manually create users in the Oracle Identity Cloud Service instance using the Oracle NetSuite Analytics Warehouse user interface.
When you add a user using the Oracle NetSuite Analytics Warehouse user interface, the user is available in the Oracle Identity Cloud Service instance associated with your Oracle NetSuite Analytics Warehouse instance. You later assign the applicable licensed groups to the user that enable the user to perform certain tasks in Oracle NetSuite Analytics Warehouse.
See System Groups.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Users tab, and then click Add User.
- In Add User, click Create a New User.
- In Add User, provide the user details and click Next.
- Select the check box for each of the licensed groups that you want to assign to the user and click Finish.
License the Users to Access Oracle NetSuite Analytics Warehouse
You must assign at least one system group to users to enable them to perform relevant tasks in Oracle NetSuite Analytics Warehouse. System groups provide a set of privileges to perform tasks in Oracle NetSuite Analytics Warehouse.
See System Groups.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Users tab, and then click Add User.
- In Add User, search for a user and select the user or select a user from the displayed list of users.
- Click Next.
- Select the check box for each of the licensed groups that you want to assign to the user and click Finish.
Update the User Details
You can update the user details such as first name, last name, and email but the user name is non-editable after specifying it initially.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, select a user from the users listed under the Users tab or use the Search option and then click User Profile.
- In User Details, update the applicable information and click Save.
Remove a User’s Access to Oracle NetSuite Analytics Warehouse
Remove a user's access to Oracle NetSuite Analytics Warehouse by removing their assignment to a system group.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, select a user from the displayed users or use the Search option to search for and select a user.
- Click Remove User.
Copy Data Security Assignments
As a service or security administrator, you can copy data security assignments from one user to another user.
Assign Groups to Users
You can assign one or more users to one or more groups.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, select a user from the displayed users or use the Search option to search for and select a user.
- In the user details region, click Assign Groups.
- In Assign Groups, search for a group or select from the list of groups displayed in this dialog.
- Select the check box for one or more groups and click Assign.
Remove Groups Assigned to a User
Remove groups assigned to a user if the user no longer requires the authorization to access Oracle NetSuite Analytics Warehouse, specific permissions for tasks, and functional access.
Manage Groups
You must ensure to map application roles to groups and add user memberships to groups. This enables users to access the applicable objects in Oracle NetSuite Analytics Warehouse and perform various tasks.
Create a Group
As a security administrator, you can create custom groups to meet your business requirements.
You can create them manually in the Oracle Identity Cloud Service instance associated with your Oracle NetSuite Analytics Warehouse instance using the Security pages in Oracle NetSuite Analytics Warehouse.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Groups tab, and then click New Group.
- In Create a New Group , enter a group name and description.
- Click Save.
Remove a Group
You can remove only the custom groups. When you remove a custom group, Oracle NetSuite Analytics Warehouse removes the associated mappings of the application roles.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Groups tab.
- In the Groups region, search for a group and select it or select a group from the displayed list of groups.
- Click Remove Group.
Add Application Roles to a Group
As a security administrator, you can map the application roles available for Oracle NetSuite Analytics Warehouse with the predefined and custom groups. This enables the groups to inherit the security setup at each application role level.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Groups tab.
- In the Groups region, search for a group and select it or select a group from the displayed list of groups.
- In the group details region, click the Application Roles tab, and then click Add Mapping.
- In Add Application Role Mappings, search for an application role and select it or select from the displayed list of application roles.
- Click Save.
Copy Application Roles to a Group
As a security administrator, you can copy the application roles available from an existing group to another group.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Groups tab.
- In the Groups list, select the group to which you want to apply the application roles
- On the Groups tab, click Copy Role Mappings.
- In Copy Role Mappings From Another Group, search for a group that you want to copy roles from.
- Click the roles in the Copy Roles area to select or deselect them, and then click Copy.
- Click Save.
Remove Application Roles from a Group
You can remove capabilities inherited by a group from the application roles mapped to it.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, under the Groups tab, select a group from the displayed list of groups or search for a group.
- In the group details region, click the Application Roles tab.
- Select one or more roles from the displayed list or search for application roles and select the applicable role.
- Click Remove Mapping.
- In Remove Role Mapping, click Remove Mapping.
Assign Users to a Group
When you assign users to a group, you create user memberships for the group. You can assign one or more users to one or more groups.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Groups tab.
- Search for a group or select from the list of groups displayed under the Groups tab.
- Click Assign Users.
- In Assign Users, search for a user or select from the list of users displayed in this dialog.
- Select the check box for one or more users and click Assign.
Remove Users from a Group
You can remove one or more users from a group.
Copy User Mappings to a Group
As a security administrator, you can copy the users mapped to an existing group to a custom group to quickly add users to the new custom group.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Groups tab.
- In the Groups list, search for a group or select the group to which you want to copy the users.
- On the Groups tab, click Copy User Mappings.
- In Copy User Mappings From Another Group, search for a group that you want to copy users from.
- Under Copy Users, verify all the users who'll be copied to the custom group, and then click Copy.
- Click Save.
Manage Application Roles
Application roles in Oracle NetSuite Analytics Warehouse consist of duty roles for objects security. You can map the ready-to use application roles to groups to define the permissions associated with the group. You can add or remove groups mapped to an application role.
Create an Application Role
You can create custom duty and data roles to secure subject areas, front-end objects, and row-level data respectively when the predefined application roles don't meet your business needs.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Application Roles tab and then click New Application Role.
- In Create a New Application Role, enter the application role name and specify the role type as data or duty.
- Click Save.
Assign Groups to Application Roles
Use these instructions to map application roles to groups.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Application Roles tab.
- Search for an application role or select from the displayed list of application roles.
- In the application role details region, click Assign Groups.
- In Add Group Mappings, search for a group and select it or select from the displayed list of groups.
- Click Save.
Remove a Group Mapped to an Application Role
Use these instructions to remove a group mapped to an application role.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Application Roles tab.
- Search for an application role or select from the displayed list of application roles.
- In the application role details region, select the check box for a displayed group or search for a group and select it, and then click Remove Group.
- In the Remove Group Mapping? dialog, click Remove Group.
Delete an Application Role
You can delete the custom application roles. Upon deletion of the custom application roles, Oracle NetSuite Analytics Warehouse deletes the mappings to the groups.
- Sign in to your service.
- In Oracle NetSuite Analytics Warehouse Console, click Security under Service Administration.
- On the Security page, click the Application Roles tab.
- Search for an application role or select from the displayed list of application roles.
- Click Delete Application Role.
- In the Delete Application Role? dialog, click Delete Role.
Manage Data Access through Security Assignments
As a security administrator, you need to map data security assignments to users to enable data level access.
Use the Security Assignments tab on the Security page to search for the currently set up data security assignments. You may either search for all records or narrow your search to a specific security context, security value, or user. You can remove a security assignment that you had set up or add new security assignments to a user.
Create a Security Assignment
Use these instructions to create a security assignment in a specific security context.
Delete a Security Assignment
Use these instructions to delete a security assignment. When you delete a security assignment, Oracle NetSuite Analytics Warehouse removes all users associated with the security assignment.
Remove Users from a Security Assignment
You can revoke the security assignment granted to one or more users.
Manage Users for a Security Assignment
As a security administrator, you can manage users for existing data security assignments. In the Manage Users dialog, you can revoke users for an existing assignment or add new users for that assignment.
Set Exclusion Rules for Security Assignments
You can set up data security to exclude access for specific users within a security context for specific security assignments.
For example, you can grant access to all security assignments but the business unit ABC. This enables you to have a single rule for a single user within a security context. You can also remove the indirectly derived security assignments of the specific user. Ensure that the users for whom you want to exclude assignments are members of a group related to the security context. You can automate the application of the security exclusion rules by downloading the DataSecurityExclusionAssignments_csv.zip, making changes, and then uploading it; see Download and Upload Data Security Exclusion Rules.
View Activity History
View all the security-related activities or filter them by object type and by date for security audit purposes.