Creation date: 03/01/2011 Last Review: 12/12/2012 Revision number: 3

Transcription

1 KB How to define custom reports in IDENTIKEY Server? Creation date: 03/01/2011 Last Review: 12/12/2012 Revision number: 3 Document type: How To Security status: EXTERNAL Summary IDENTIKEY Authentication Server reporting allows the user to extract useful information from the IDENTIKEY Authentication Server database and view it in an organized form. Various standard reports are provided with IDENTIKEY Authentication Server that will cover the common tasks such as Succeeded Operations, DIGIPASS Assignment or Authentication Trends. If the standard reports do not fit your needs you may edit the existing reports or define a new one. Details Reading the Reporting section of the IDENTIKEY Authentication Server Administration Reference guide is advisable due to the wide range of values that can be reported on. This Howto guide will show the basics for defining a custom report by creating a report to show what users have been created. 1. Using the IDENTIKEY Authentication Server Audit Viewer is a good way to discover which values can be used to define the report query. The following is an audit message from a successful user creation. Notice that IDENTIKEY Authentication Server issues a command type of Create with an object type User and within the Category of Administration. We can use these values to build a query. Date: 1/3/2011 Time: 11:07:34 AM Type: Success Source: Identikey Server Category: Administration Code: S Description: A command of type [User] [Create] was successful. AMID: 0x28A55045E93D77108ABC905438BD9E48 Details: Source Location : Client Location : User ID : admin Domain : vasco.local Input Details : ;{User ID : Test};{Password : ******};{Domain Name : vasco.local};{organizational Unit : };{Local Authentication : Default};{Back-end Authentication : Default};{Disabled : no};{locked : no};{confirm New Password : ******} Output Details : ;{User ID : test};{password : ******};{Created Time : 2011/01/03 11:07:34};{Modified Time : 2011/01/03 11:07:34};{Has Digipass : Unassigned};{Status : 0};{Domain Name : vasco.local};{organizational Unit : };{Local Authentication : Default};{Backend Authentication : Default};{Disabled : no};{locked : no};{confirm New Password : ******} Object : User Command : Create Page 1 of 5

2 Client Type : Administration Program 2. From the IDENTIKEY Authentication Server Web Admin hover your mouse over the Reports tab and select Define report. 3. From the Describe Report tab enter a report name in the Report Name field. Select the type of report from the drop down list, in this example the Detailed Analysis type will give us the amount of detail we need. Click the Next button to continue. Page 2 of 5

3 4. From the Options tab select the Grouping level and the Data Source. Grouping the data by User will group all of the created objects that user created. The Users + audit source is used because we are pulling data from the audit database and we are looking for information related to users. 5. The audit database can contain a large amount of data so it is best to narrow your query by using the filters from the Define Query tab. The following filters will give us data we are interested in and will speed up the reporting process. Audit:Category equals Administration Audit:Command equals Create Audit:Object equals User Page 3 of 5

4 6. The Query Overview tab shows the queries associated with this report and allows you to add additional queries. Click the Next button to continue. 7. The Report Permissions tab allows you to define what IDENTIKEY Authentication Server users are able to run or update the report. Select the appropriate settings and click the Next button. Page 4 of 5

5 8. Report data is always generated into XML and then a XSLT transformation is applied to give the output. The XSLT transformation requires a formatting template. Each report definition requires at least one template so that it can be produced in the format required. In this example I used the XSLT template that was created for the Detailed Activity Report. C:\Program Files (x86)\vasco\identikey 3.2\reports\xslt\ detailed_activ_report.xlst. Since these templates were created for specific reports you may need to create a XLST template. 9. Click the Finish button. Page 5 of 5