KB 110096 How-to configure Auditing for IDENTIKEY Authentication Server 3.2 to a remote Oracle Database on a standalone Microsoft machine. Creation date: 30/09/2011 Last Review: 06/12/2012 Revision number: 3 Document type: How To Security status: EXTERNAL Summary The IDENTIKEY Authentication Server Audit Viewer can be used to view the audit information from several sources, one possible source is to connect to database containing the audit information. This document describes the necessary steps to connect to an Oracle database from a standalone Windows machine. Details The Audit viewer can connect to any DSN configured in Windows Data Source (ODBC). To connect to an Oracle database the Windows Data Source must have access to the necessary Oracle client drivers. To be able to connect to an Oracle Database from the IDENTIKEY Authentication Server audit viewer on a Windows machine the following steps are necessary: 1. Download and install Oracle client software and Oracle ODBC drivers 2. Configure the Oracle client to connect to the Oracle database 3. Configure the DSN in Windows Data Source (ODBC) 4. Install and configure the IDENTIKEY Audit viewer 1. Download and install Oracle client software and Oracle ODBC drivers. The Oracle drivers are not present on a Windows system by default and must be downloaded and installed from the Oracle website. The following packages are necessary: Instant Client for Microsoft Windows Instant Client Package- ODBC: Additional libraries for enabling ODBC application Both packages are zip files. Both packages must be unzipped and copied in the same directory (for example: C:\inst-client-11.2.0.2). Once this is done start odbc_install.exe. This will install the ODBC drivers so that Page 1 of 6
they are available in the ODBC Data Source Administrator 2. Configure the Oracle client to connect to the Oracle database Create a file tnsnames.ora containing database connection information: AUDITDB = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST =192.168.20.4 )(PORT = 1521)) ) (CONNECT_DATA = (SERVICE_NAME = AUDITDB ) ) Create an environment variable TNS_ADMIN containing the path to the location of the tnsnames.ora file. Open the System Properties and select the Advanced tab. Click on Environment Variables. In the System variables part, click on New Page 2 of 6
Specify the location of the tnsnames.ora file. 3. Configure the DSN in Windows Data Source (ODBC) Open the Data Sources (ODBC). This can be found on Windows XP under Control Panel Administrative Tools. Select the System DSN tab. Click the Add button. Page 3 of 6
Select Oracle in instantclient_11_2. (Do NOT choose Microsoft ODBC for Oracle) Click the Finish button. This will open the Oracle ODBC Driver Configuration, which will read the contents of the previously configured tnsnames.ora file. Click on Test connection and fill in the required credentials to test the connection Page 4 of 6
This should give the following message: 4. Install and configure the IDENTIKEY Audit viewer The installation of the Audit Viewer is done with the IDENTIKEY installer. It is possible to only install the Audit Viewer, by unselecting all other options as in the screen below Once the installation has finished, launch the Audit Viewer from the Windows Start Menu. Click on the highlighted button to add a connection to an ODBC Database. Page 5 of 6
Fill in the required information and choose the correct DSN name from the drop down menu This will add a database connection in the Audit viewer, under ODBC Database Page 6 of 6