Chat now with support
Chat with Support

Identity Manager 8.1 - Configuration Guide

About this guide One Identity Manager software architecture Customizing the One Identity Manager default configuration Adjusting the One Identity Manager base configuration One Identity Manager schema basics Editing the user interface
Object definitions for the user interface User interface navigation Forms for the user interface Statistics in One Identity Manager Extending the Launchpad Task definitions for the user interface Applications for configuring the user interface Icons and images for configuring the user interface Using predefined database queries
Localization in One Identity Manager Process orchestration in One Identity Manager
Setting up Job servers in Designer Configuring the One Identity Manager Service Handling processes in One Identity Manager
Tracking changes with process monitoring Conditional compilation using preprocessor conditions Scripts in One Identity Manager Reports in One Identity Manager Adding custom tables or columns to the One Identity Manager schema Web service integration SOAP Web Service One Identity Manager as SPML provisioning service provider Processing DBQueue tasks Appendix: Configuration files of the One Identity Manager Service

One Identity Manager Service configuration files

Configuration One Identity Manager Service and its plug-ins with a configuration file. The file has to reside in the same directory as the file viNetworkService. The configuration file is necessary both for One Identity Manager Service on a windows based operating system and for the Linux daemon.

Two configuration file formats are supported:

  • Jobservice.cfg

    Jobservice.cfg is an XML configuration file in our own format. The advantage of this file is that run-time loading is supported.

  • viNetworkService.exe.config

    The viNetworkService.exe.config file is the default configuration file for .NET exes and has the specified format.

The system initially searches for the parameter in the configuration file Jobservice.cfg in order to determine the setups. If the parameter is not found, the file viNetwordService.exe is automatically used. Thus the One Identity Manager Service can only work with the configuration file viNetworkService.exe.config.

You handle configuration of the One Identity Manager Service in Designer under Base data | Installation | Job server or with the Job Service Configuration program.

There is one unique section in the file for each of the different modules in One Identity Manager Service.

Table 83: One Identity Manager Service Modules
Module Description

Process collection

Specify the Job provider in this module.

JobDestination

In this module, you specify the job destination.

Configuration

Standard configuration settings for One Identity Manager Service are in this module.

LogWriter

This module writes One Identity Manager Service messages to a log file.

Request dispatcher

Use this module to configure the One Identity Manager Service as a dispatcher. The process requests from the child Job server are buffered, processed and forwarded.

Connection

With this module you can set special configuration settings for the behavior of the One Identity Manager Service.

HTTP authentication module

Use this module to specify how authentication works on an HTTP server so that extended services can be accessed, for example, displaying the log file or the status display.

Plug-ins

Specify which plugins should be installed in this module.

File with the private key.

In this module, you provide the data for files with a private key. Use this module if you are working with more than one private key.

Detailed information about this topic

Customizing the One Identity Manager Service configuration for a Job server

This configuration is already created when the One Identity Manager Service is installed. Use the Job Server Editor to modify each configuration setting. You can also customize all configuration settings in the Job Service Configuration program.

Note: Before changing the One Identity Manager Service configuration, make sure that the configuration is imported into the database. In Designer, configure and enable the schedule Get configuration file from the Job server and write in the Job server configuration.

To modify the One Identity Manager Service configuration on a Job server

  1. Select Base Data | Installation | Job server in Designer.
  2. Start the Job Server Editor using the Edit Job server task.
  3. Activate the Configure One Identity Manager Service view.
  4. Select the Job server to be edited in the Job server overview.
  5. Edit the configuration settings.

    TIP: Use the and buttons to change the configuration data.

  6. Save the configuration using .
  7. Use the button to test the configuration.
  8. Deploy the modified configuration to the Job server using Job server | Deploy Job server configuration from menu.

    This generates a process, which updates the configuration file on the Job server.

TIP: Use the Job server | Start HTTP request menu item to address the HTTP server of the One Identity Manager Service for a Job server and display the different services of the One Identity Manager Service.

Related Topics

Template for the configuration file

Note: The templates are only available in the Job Service Configuration program.

The SQL server direct template is supplied for configuring the One Identity Manager Service with a direct database connection.

This template already contains the most important modules with settings for a simple One Identity Manager Service configuration with a direct connection to an SQL Server. You can load the template using the menu item Templates | SQL server direct. After loading, the configuration the template needs to be modified as required.

Related Topics

Selecting the module types and editing the parameters

The module list of the One Identity Manager Service configuration gives an overview of the individual configuration sections. A selection of module types is available for certain modules.

To select a module type

  1. Click on the module in the module list.
  2. Use Insert to open the module type menu.
  3. Select the module type you want from the list and insert it with the OK button.

To change the name of a module type

  1. Click on the module in the module list.
  2. Select the module type and click Rename.
  3. Change the name of the module type.
  4. Press return.

To delete a module type

  1. Click on the module in the module list.
  2. Select the module type and click Delete.

To edit a parameter value

  1. Select the parameter in the Properties column.
  2. Click Edit.

When a item is selected in the module list, all possible parameters and their values are displayed. You can change some values by clicking in input field or on the option button in the Value column.

NOTE: The parameter description in each module contains the parameter name, in brackets, which is used in the configuration file.

The following icons are used:

Table 84: Meaning of the Icons for the Module Parameters
Icon Meaning
The value is passed as a string.
Compulsory input. The parameter must be altered as required. The value is passed as a string.
The value is passed as an integer.
The parameter can be enabled or disabled.
This parameter is added during run-time. The One Identity Manager Service does not need to be restarted.
The parameter takes effect after the One Identity Manager Service is restarted.
Related Topics
Related Documents