To use Cognos product documentation, you must enable JavaScript in your browser.

Groups and Roles

Groups  and roles represent collections of users that perform similar functions, or have a similar status in an organization. Examples of groups are Employees, Developers, or Sales Personnel. Members of groups can be users and other groups. When users log on, they cannot select a group they want to use for a session. They always log on with all the permissions associated with the groups to which they belong.

Roles  in Cognos 8 have a similar function as groups. Members of roles can be users, groups, and other roles.

The following diagram shows the structure of groups and roles.

Users can become members of groups and roles defined in third-party authentication providers, and groups and roles defined in Cognos 8. A user can belong to one or more groups or roles. If users are members of more than one group, their access permissions are merged.

You create Cognos groups and roles when

Series 7 Roles

If you have configured the Cognos Series 7 authentication provider , user collections known as user classes in Series 7 appear as roles in Cognos 8. You can access Series 7 and Cognos 8 using a single logon. If you start your session by logging on to Series 7, and then access Cognos 8, you automatically assume the roles that were in effect for you in Series 7 when you first logged on. You cannot assume different Series 7 roles.

Users can assume different roles in Series 7 after they access Cognos 8.

Roles Used to Run Reports and Jobs

The roles used to run reports and jobs are associated with the users who run the reports interactively , who are the report owners, and whose credentials are used to run scheduled reports and jobs . Depending on the options selected to run reports, different roles can be assumed by the process.

Distribution Lists as Members of Groups and Roles

In some namespaces, such as Microsoft Active Directory, a distribution list may appear on the Members tab of the Set properties page for a group or role. However, you cannot add distribution lists to a group or role membership, and you cannot use them to set access permissions for entries in the Cognos 8 user interface.

You can add a Cognos distribution list to a Cognos group or role membership using the Software Development Kit (SDK). However, the SDK cannot be used to add an Active Directory distribution list to an Active Directory group. The Active Directory management tools must be used to do this.

Cognos Controller Groups and Roles

If you are configuring security for Cognos 8 Cognos Controller, you use Cognos Controller groups and Cognos Controller roles. For information about using these groups and roles to configure security, see the Cognos Controller Installation and Configuration Guide.

Create a Cognos Group or Role

The members of Cognos groups can be users or other groups. The members of Cognos roles can be users, groups, or other roles. You can add entries from multiple namespaces, created both in the authentication providers and in Cognos 8, as members of Cognos groups. You can also create empty groups that do not have any members.

If you plan to create groups or roles that reference entries from multiple namespaces, you must log on to each of those namespaces before you start your task. Otherwise, you will not have full administrative rights for the entries you want to reference.

To access the directory administration tool, you must have execute permissions for the directory secured feature and traverse permission for the administration secured function .

We recommend that you use the Cognos groups and roles when you set up access permissions to entries in Cognos 8 because it simplifies the process of deployment .

When you delete a Cognos group or role, users’ access permissions based on it are no longer active. You cannot restore access permissions by creating a group or role with the same name.

Steps
  1. In Cognos Connection, in the upper-right corner, click Launch, Cognos Administration.

  2. On the Security tab, click Users, Groups, and Roles.

  3. Click the Cognos namespace.

    Tip: If you want to delete a Cognos group or role, select the check box next to it and click the delete button.

  4. On the toolbar, click the new group  or new role  button.

  5. In the Specify a name and description page, type a name and, if you want, a description for the new group or role, and then select a destination folder and click Next.

  6. If you want to create a group without members, click Finish.

  7. If you want to add members to the new group or role, click Add and choose how to select the users, groups, or roles:

  8. Click the right-arrow button and when the entries you want appear in the Selected entries box, click OK.

    Tips: To remove entries from the Selected entries list, select them and click Remove. To select all entries in a list, click the check box in the upper-left corner of the list. To make the user entries visible, click Show users in the list.

  9. Click Finish.

Add or Remove Members of a Cognos Group or Role

You can modify the membership of a Cognos group or role by adding or removing members.

When you remove users, groups, or roles from a Cognos group or role, you do not delete them from the authentication provider or from Cognos 8.

If you plan to modify groups or roles that reference entries from multiple namespaces, you must log on to each of those namespaces before you start your task. Otherwise, you will not have full administrative rights for the entries you want to modify.

To access the directory administration tool, you must have execute permissions for the directory secured feature and traverse permission for the Administration secured function .

Steps
  1. In Cognos Connection, in the upper-right corner, click Launch, Cognos Administration.

  2. On the Security tab, click Users, Groups, and Roles.

  3. Click the Cognos namespace.

  4. In the Actions column, click the properties button for the group or role whose membership you want to modify.

  5. Click the Members tab.

  6. If you want to add members, click Add and choose how to select members:

  7. Click the right-arrow button and when the entries you want appear in the Selected entries box, click OK.

    Tips: To remove entries from the Selected entries list, select them and click Remove. To select all entries in a list, click the check box in the upper-left corner of the list. To make the user entries visible, click Show users in the list.

  8. To remove members from a Cognos group or role, in the Set Properties page, specify which users, groups, or roles to remove, and click Remove.

  9. Click OK.