The Report Creation Utility provides three custom report definition dialog boxes. You can use these dialog boxes not only to create new reports but also to edit or delete existing reports.
To create, edit, or delete custom reports:
1. In the RSA Authentication Manager Reports dialog box, click Create Report.
The Select Report Type dialog box opens.
2. Select one of three types: Log Entry, Histogram, or Token Statistics.
Depending on your selection, one of the following dialog boxes opens:
• Log Messages Report Builder
• Log Messages Histogram Builder
• Token Statistics Report Builder
RSA Authentication Manager 6.1 Administrator’s Guide
178 9: Reports
One feature common to all of these dialog boxes is the Custom Reports list, which lists by name any custom reports of the type you selected that are currently defined. For example, see the right side of the Log Messages Report Builder dialog box.
3. One way to create a new report is to select an existing report and change the definition. When you select any report, the settings that define it are displayed on the screen. (In the Log Messages Report Builder dialog box, for example, the log messages specified as the report contents are highlighted in the Select Message list.) You can change these settings and click Replace to save the new report definition in place of the old one.
4. To create a new report without using an existing one, click Create. New reports are added to the Custom Reports list. (Full procedures for creating the three types of report are provided in the next three sections.)
5. To delete a report from the Custom Reports list, select it and click Delete.
6. To save editable 4GL code for a report you create, select Save generated source code.
When this box is not selected, only compiled 4GL code is generated. When this box is selected, readable and editable 4GL source code is generated in addition to the compiled code.
Creating Log Entry Reports
The Log Messages Report Builder dialog box enables you to create reports that include all log records of one or more event types by selecting the corresponding log messages from the Select Message box. For example, you could define a report showing every instance of the RSA Authentication Manager disabling a token.
Another report might include all log records that represent changes to a user record or a token record.
9: Reports 179 Log reports include the detailed information available from the Authentication Manager audit trail. Entries show the time and date of the event, the current and affected users (as appropriate), and a one-line description of the event.
To define a custom log entry report:
1. In the RSA Authentication Manager Reports dialog box, click Create Report to open the Select Report Type dialog box.
2. Click Log Entry > OK.
The Log Messages Report Builder dialog box opens.
3. Select one or more messages by highlighting them in the Select Message list. (If you change your mind about a message, put the cursor on it and click Deselect.) Each occurrence of an event indicated by one of the selected messages is reported (for the dates you specify) when this report is run.
4. Click Create.
The Create a New Report dialog box opens and prompts you for a description and a filename for the new report.
5. Enter a short, descriptive name (up to 25 characters) by which users of the Report Generation Utility can identify the new report. This name will appear in the Custom Reports list or Run List.
In addition to the descriptive name, enter a filename (up to eight characters) to be used for the report output files (and for the report source code file if you requested one).
Note: Do not use a description or a filename that is already used for another report, even if the report type is different.
6. Click OK.
The new report appears in the Custom Reports list in the Log Messages Report Builder dialog box.
7. Click OK in the Log Messages Report Builder dialog box.
The new report appears on the Custom Reports list in the RSA Authentication Manager Reports dialog box.
Creating a Histogram of Log Activity
A histogram is a count of activity by the hour. This report does not show any event details, such as user name or Agent Host name.
The Log Messages Histogram Builder dialog box resembles the Log Messages Report Builder dialog box exactly except for its title. You define a report in the same way—
by selecting the log messages that correspond to the events you want reported. The only difference between these two report types is in the output: complete, detailed log entries in one report, statistics without details in the other.
RSA Authentication Manager 6.1 Administrator’s Guide
180 9: Reports
To create a histogram of log activity:
1. In the RSA Authentication Manager Reports dialog box, click Create Report to open the Select Report Type dialog box.
2. Select Histogram, and click OK.
The Log Messages Histogram Builder dialog box opens.
3. Select one or more messages by highlighting them in the Select Message list. (If you change your mind about a message, put the cursor on it and click Deselect.) The number of occurrences of each event indicated by one of the selected messages is reported (for the dates you specify) when this report is run.
4. Click Create to add the new report and open the Create a New Report dialog box.
5. Enter a short, descriptive name (up to 25 characters) by which users of the Report Generation Utility can identify this new report. This name will appear in the Custom Reports list or Run List.
Also, enter a filename (up to eight characters) to be used for the report output files (and for the report source code file if you requested one).
Note: Do not use a description or a filename that is already used for another report, even if the report type is different.
6. Click OK.
The new report appears in the Custom Reports list in the Log Messages Histogram Builder dialog box.
7. Click OK in the Log Messages Histogram Report Builder dialog box.
The new report appears on the Custom Reports list in the main Report dialog box.
Creating Token Statistics Reports
Token statistics reports display the number of tokens in each category that you specify in the report definition. In addition to these numbers, the output data lists the token serial number, the user’s first name, and the user’s last name for each token included.
The default settings in the Token Statistics dialog box define the report so that it includes every token in your realm. Your selections and entries modify these settings and restrict the report to a more closely defined set of tokens.
To create a token statistics report:
1. In the RSA Authentication Manager Reports dialog box, click Create Report to open the Select Report Type dialog box.
2. Select Token Statistics, and click OK.
The Token Statistics Report Builder dialog box opens.
9: Reports 181 3. Select criteria to specify the tokens you want to include in the custom report.
Make sure that criteria you do not want to include are cleared.
Tokens which shut down before. All tokens that will shut down (expire) before this date are included in the report.
Logins which occurred after. All logins made after this date are included in the report.
Bad tokencode counts greater than. When the number of incorrect tokencodes entered in a single login attempt exceeds the number you enter in this field, the event is included in the report.
Bad PIN counts greater than. When the number of incorrect PINs entered in a single login attempt exceeds the number you enter in this field, the event is included in the report.
Token type. Select one or more token types that you want to include in this report.
Token Enabled, New PIN Mode, Token Lost, and Next Tokencode Status.
Click the selections you want to include in the report.
4. Click Create.
Enter a description and a filename for the new report.
5. Enter a short, descriptive name (up to 25 characters) by which users of the Report Generation Utility can identify this new report. This name will appear in the Custom Reports list or Run List.
Also, enter a filename (up to eight characters) to be used for the report output files (and for the report source code file if you requested one).
Note: Do not use a description or a filename that is already used for another report, even if the report type is different.
6. Click OK.
The new report appears in the Custom Reports list in the Token Statistics Report Builder dialog box.
7. Click OK in the Token Statistics Report Builder dialog box.
The new report appears on the Custom Reports list in the main Report dialog box.