Home
Reports
Cognos Reports Installation and Configuration Guide
User authorization for Cognos folders and reports
A Custom Java Authentication Provider (CJAP) provides authorization for users who access Cognos report folders and reports. You can implement this feature after you implement the Unica Authentication Provider, which provides single sign-on authentication between Unica applications and Cognos.
How to implement CJAP security
To implement CJAP security, complete the tasks in this section in the order shown.
Verifying synchronization
Verify that groups, users, and roles exist as expected in the Cognos namespace.

Reports
- Unica Insights Reports Installation and Configuration Guide
- Cognos Reports Installation and Configuration Guide
  - Installation overview
    An installation of the Unica reports is complete when you install IBM Cognos® BI or Unica Insights reports and configure it for Unica applications. This guide provides detailed information about configuring IBM Cognos BI, and integrating IBM Cognos BI with Unica.
  - Plan the Unica reports installation
    When you plan your Unica reports installation, you must ensure that you correctly set up your system and configure your environment.
  - Install reporting components
    To install Unica reporting for your products, you must install the reporting components.
  - Install and test IBM® Cognos® BI
    Your license agreement with must grant you an Cognos® BI license so you can download the Cognos BI installation files. IBM Cognos BI is a collection of applications, servers, and services that is organized in a multi-tiered architecture.
  - Integration roadmap for Unica and IBM Cognos®
    After you install IBM Cognos®, you must integrate the Unica suite with IBM Cognos.
  - How to configure reporting
    After you install or upgrade your reporting packages, you must configure your reporting installation.
  - User authorization for Cognos folders and reports
    A Custom Java Authentication Provider (CJAP) provides authorization for users who access Cognos report folders and reports. You can implement this feature after you implement the Unica Authentication Provider, which provides single sign-on authentication between Unica applications and Cognos.
    - How to implement CJAP security
      To implement CJAP security, complete the tasks in this section in the order shown.
      - Backing up the Cognos environment for CJAP
        Before you implement CJAP, back up your Cognos environment.
      - Editing and synchronizing the property file
        The property file determines which groups in Unica are duplicated in Cognos. Edit the property file to specify the Unica Platform groups that you want to synchronize into Cognos.
      - Configuring the new namespace provider in Cognos
        Configure a new namespace provider in Cognos for CJAP.
      - Verifying synchronization
        Verify that groups, users, and roles exist as expected in the Cognos namespace.
      - Assigning Cognos permissions to the new roles
        Assign permissions to the Cognos Reports_System_Role and Report_ User_Role roles in Cognos that are equivalent to the Unica Platform ReportSystem role and ReportUser role, respectively.
      - Removing the Everyone group from the Cognos System Administrators role
        By default all authenticated users are members of the Everyone group in Cognos. Members of this group have the System Administrators role in Cognos. This grants all users administrator rights in Cognos by default.
      - Giving reports users read-only permissions in public folders
        Make users with the Unica Platform ReportSystem and ReportUser roles members of the EMM_Report_Access_All_Users group. Give members of this group read-only access for the public folders in Cognos.
      - Securing public folders
        To ensure that you control access to public folders in Cognos, complete this task on all public folders, including the folders created for each Unica product reports pack.
      - Verifying user permissions in Cognos
        Verify that your implementation of CJAP is working as expected.
    - Removing the CJAP implementation from your environment
      Complete this task only if you implemented CJAP security and decided to roll back your environment to use the Unica Authentication Provider.
  - How to configure the Cognos® Reports for multiple partitions
    If you use Unica Campaign, Unica Deliver, or Unica Interact with more than one partition, you must configure the Cognos® reports packages for each partition. You can set up reporting on multiple partitions after you configure the partitions in Unica Campaign and Unica Deliver.
  - How to upgrade reports
    You can upgrade your current version of Unica reports to bring it up-to-date with the latest features.
  - Upgrading the 8.x or 9.x model and installing new reports
    Upgrading the 8.x or 9.x model and installing the new reports are the first steps that you must complete to upgrade your reports.
  - Report configuration properties
    The report configuration properties for Unica are available at Settings > Configuration > Reports.
  - Formats for the Cognos® reports
    The Cognos® reporting integration components include a global report style sheet, GlobalReportStyles.css.
  - Formats for the Unica Campaign, Unica Deliver, and Unica Interact Cognos reports
    Additional styling is required for Unica Campaign, Unica Deliver, and Unica Interact Cognos reports. The global report styles are modified to add classes to override the styling of existing classes to improve the look and feel of Unica Campaign, Unica Deliver, and Unica Interact reports.
  - Unica Campaign reports and reporting schemas
    You can customize the reporting schemas in the Unica Campaign Report Package by adding contact or response metrics, attributes, or response types.
  - Unica Deliver Reports and Reporting Schemas
    Several reports, such as Message Overview report, Detailed Link report, Deliver Reports Processing Overview, and SMS Message Summary Report are available in the Unica Deliver Reports Package.
  - Unica Interact Reports and Reporting Schemas
    The Unica Interact Report Package reports are supported by reporting schemas. You can customize the schemas to specify time periods, configure audience levels, and create extra performance reporting schemas.

Verifying synchronization

Verify that groups, users, and roles exist as expected in the Cognos namespace.

About this task

To verify synchronization, complete the following steps.

Procedure

In Cognos Connection, select Launch > Cognos Administration.
On the Security tab, click Users, Groups, and Roles.
Select the namespace you created.
Click the Groups folder and verify that groups have synchronized correctly, as follows:
- Verify that the following three default groups are present and that they have the expected members:
  - EMM_Report_System_Admin_User
    Users with the ReportsSystem role in Unica are members of this group.
  - EMM_Report_User_Role_Users
    Users with the ReportsUser role in Unica are members of this group.
  - EMM_Report_Access_All_Users
    Users with the ReportsUser role in Unica are members of this group.
- Verify that the groups you specified in the ReportSecurityConfig.properties file are present and that they have the expected members.
Click the Users folder and verify that all users with the ReportsSystem or ReportsUser role in Unica Platform are listed in this folder.

Attention: Users who are granted report permissions through group membership appear in Cognos after they access reports in Unica. Also, new users are listed after Cognos is restarted or after the user accesses reports in Unica.
Click the Roles folder and verify that the expected role members are present, as follows:
- All users with the ReportsSystem role in Unica Platform have the Reports_System_Role in Cognos.
- All users with the ReportsUser role in Unica Platform have the Reports_User_Role in Cognos.

Have feedback?
Google Analytics is used to store comments and ratings. To provide a comment or rating for a topic, click Accept All Cookies or Allow All in Cookie Preferences in the footer of this page.