PhenixID DocumentationPhenixID Authentication ServicesSolutionsReportingAdd custom report in PhenixID Authentication Services

Add custom report in PhenixID Authentication Services

This document is written for PhenixID Server.

The reader should have some basic knowledge about PhenixID Server.

This document describes how to create a custom report in PhenixID Server.

Overview

PhenixID Server has several predefined reports that comes with the product.

This document will describe how to create custom reports if needed.

NOTE: Be aware that customizations like this will not qualify as normal support.

Also consider the fact that a misconfigured query against the database can have an impact on the service.

Please make sure to have a recent backup of the configuration before proceeding.

Location of the reports

The predefined reports are located in:
<PhenixIDServerinstallationdir>/mods/com.phenixidentity~phenix-prism-report~<version>/js/reports

Each report is a .json file.

So to create a custom report just copy the one that suits the needs best.

And then modify the query according to the requirements, see example below.

Examples

A simple query can look like this:


select from event where  eventID ='EVT_001022' order by date desc limit 1000

This will return all columns in the table if they have values.

The search will be limited to 1000 rows.

 

Query for more than one event:

select from event where  eventID ='EVT_001022' or eventID ='EVT_001008' order by date desc limit 1000

Use “or” to add more than one criteria to the query.

 

The example below will add dates to the query:

{
    "displayName": "Between dates",
    "category": "System",
    "description": "Shows events between selected dates",
    "query": "select from event where date >='{{after}}' and date <='{{before}}' order by date desc limit 1000",
    "params": [{
            "name": "after",
            "displayName": "After",
            "type": "date"
        }, {
            "name": "before",
            "displayName": "Before",
            "type": "date"
        }]
}

 

Example using multiple events and search between dates:

{
    "displayName": "My own report UID, Pwd & OTP between dates",
    "category":"My new category",
    "description": "Shows events between dates with username, password & OTP",
    "query": "select from event where eventID = 'EVT_001008' or eventID = 'EVT_001022' and date >='{{after}}' and date <='{{before}}' order by date desc limit 1000",
    "params":[{
            "name": "after",
            "displayName": "After",
            "type": "date"
        }, {
            "name": "before",
            "displayName": "Before",
            "type": "date"
        }]
}

Example using a selection in addition to between dates:

{
    "displayName": "My own report authMethod between dates",
    "category":"My new category",
    "description": "Shows events between dates and selects method",
    "query": "select from event where eventID = 'EVT_000052' and date >='{{after}}' and date <='{{before}}' and requestMethod = '{{method}}' order by date",
    "params":[{
            "name": "after",
            "displayName": "After",
            "type": "date"
        }, {
            "name": "before",
            "displayName": "Before",
            "type": "date"
        },{
            "name": "method",
            "displayName": "Authentication Method",
            "type": "select",
            "options": [{
                    "value": "Google IDP",
                    "name": "Google IDP"
                }, {
                    "value": "BankID",
                    "name": "BankID"
                }]
        }]
}

 

To get your own reports into separate category, change:

"category":"Myowncategory"

 

Information about the different events can be found here:

http://document.phenixid.net/searches?utf8=%E2%9C%93&text=events+AND+EVT_000000&commit=Search

Information about creating events per authentication method

http://document.phenixid.net/m/90910/l/1138905-create-report-to-audit-authentications-per-service-and-authentication-method