Working With Reports

Basic reporting tasks are done using the Report Definition wizard in the Administration Web Interface.

Select REPORTS > List. A full list of available reports appears. If you want to search for a particular report in the list, you can filter or sort the list by report name, report type, description, or owner.

To view details of a single report, click the respective report name. This opens the Report Definition page that shows details such as:

• Domain name
• Report type
• Grouping level
• Data source
• Time frequency

To view additional report details, use the Fields tab, Queries tab, Permissions tab, and Templates tab. For more information, see  Reporting features and settings.

Viewing finished reports

If you choose to run a report immediately, you can view the finished PDF or HTML report via Open Report in the Summary page. If you have scheduled a report to run at a later time, you can view the finished report by navigating to REPORTS > Retrieve report.

To run an existing report

1. Select the report to run:

   1. Select REPORTS > Run report.
   2. Select the report to run from the list.

   3. Click NEXT if you want to configure the report before creating it. Continue with the next step.

      -OR-

      Click RUN WITH DEFAULTS to run the report automatically with default settings. The subsequent wizard pages are not displayed and you are redirected directly to the Summary page.

      The RUN and RUN WITH DEFAULTS buttons are also available in the User Properties page and allow you to generate user-specific reports from within the User Dashboard of the OneSpan Authentication Server Administration Web Interface (see USERS – Reports (tab)).

   4. -OR-
   
   

   1. Select REPORTS > List.

   2. Click the report name of the respective report in the list.

   3. Click RUN.

   4. -OR-
   
   
   • Click Quick Report in the User Dashboard of the selected user. By default, OneSpan Authentication Server generates a Detailed Activity Summary report, but the type of report can be changed. The report settings can be specified in the Administration Web Interface properties configuration during the initial OneSpan Authentication Server setup.

   • When you configure a different report type to be generated by clicking QUICK REPORT, its usage must be allowed in all domains by all administrators by adjusting the settings and permissions as follows:

     • Report location: Master Domain
     • Report usage permission: Public - All administrators in the different domains can run this report
   
   

2. Specify the report settings.

   Select the report template via Template to use, either HTML, PDF, or XML.

   Specify the time period to include in the report. This option is available only if the query definition for this report does not contain an Audit:Timestamp condition.

3. (OPTIONAL) Define any run-time query required.

4. Specify at which time to run the report:

   • Select Run immediately to run the report at once when you click RUN. The Administration Web Interface is blocked as long as the report is being created.
   • Select Run in background to schedule the report generation. The report is being created in the background and you can continue working with Administration Web Interface. This option is available for PDF reports only!

5. Click RUN.

   The Finish page appears displaying any confirmation or error messages.

6. If you chose to run the report immediately, you can open it now via OPEN REPORT.
7. Click FINISH to complete the wizard.

Editing existing report definitions

By default, the report owner is the user who created that report, but you can assign a report to another owner.

To change the report owner

1. Log on to the OneSpan Authentication Server Administration Web Interface (see Accessing OneSpan Authentication Server Appliance Configuration Tool and OneSpan Authentication Server Administration Web Interface).
2. Select REPORTS > List. A full list of available reports appears.
3. Click the report name of the desired report in the list.

4. Switch to the Permissions tab and click CHANGE OWNER.

   The Change Report Owner wizard appears.

5. Enter available information to specify the new owner, e.g. organizational unit, account status, etc. and click SEARCH.

   The Select User page appears showing a list of users whose data matches the search criteria.

6. Select the desired user and click CHANGE OWNER.

To change the owner of multiple reports at once, you can select the relevant reports in the list and click CHANGE OWNER.

To edit a report

1. Log on to the OneSpan Authentication Server Administration Web Interface (see Accessing OneSpan Authentication Server Appliance Configuration Tool and OneSpan Authentication Server Administration Web Interface).
2. Select REPORTS > List. A full list of available reports appears.
3. Click the report name of the desired report in the list.

4. Switch to the appropriate tab and click EDIT to edit the information in the respective tab.

   Alternatively, if you wish to edit field or query definitions use ADD NEW.

5. After editing the report settings as required, click SAVE.

   For more information, see Reporting features and settings.

When you change an existing report that you want to run in HTML format, you also need to adapt the corresponding report template (see Customizing reports).

To delete a report

1. Log on to the OneSpan Authentication Server Administration Web Interface (see  Accessing OneSpan Authentication Server Appliance Configuration Tool and OneSpan Authentication Server Administration Web Interface).
2. Select REPORTS > List. A full list of available reports appears.
3. Click the report name of the desired report in the list.

4. Click DELETE.

   A confirmation message appears.

5. Click OK to delete the report.