One Identity Manager Software Architecture
Working with Objects in One Identity Manager
Inserting, Modifying and Deleting Objects in One Identity Manager
Working with the Designer
General Information about the Program
Menu Items
Views in the Designer
Customizing Program Settings
Using Help
Limiting List Sizes
Searching for List Entries
Using the Designer's Own Full-Text Search
Using User Defined Filters for Searching
Making and Committing Changes to Objects
The Designer Editors
Working with the Object Editor
Working with the List Editor
Customizing the One Identity Manager Default Configuration
Checking Data Consistency
Menu Items
Functions in the Result List
Result List Configuration
Multiple Editing of List entries
Displaying Object Relations
Working with the SQL Editor
Support for Scripting
Working with the Consistency Editor
Starting the Consistency Check
Recording Test Results
Repairing Errors
Compiling a One Identity Manager Database
Working with Change Labels
Creating Change Labels
Displaying Contents of a Change Label
Booking Changes to a Change Label Retrospectively
Basic System Configuration Data
One Identity Manager Authentication Module
Database Connection Data
The One Identity Manager Data Model
Database Connection Properties
Configuring a One Identity Manager Database for Testing, Development or Production
Configuration Parameters for System Configuration
Setting up the Mail Notification System
Enabling More Languages for Displaying and Maintaining Data
Displaying Country Information
Working in Different Time Zones
Determining Working Hours
Editing Countries
Editing States
Modifying Public Holidays
Setting Up and Configuring Schedules
Password Policies in One Identity Manager
Predefined Password Policies
Editing Password Policies
Custom Scripts for Password Requirements
Restricted Passwords
Testing a Password
Testing Generating a Password
Assigning a Password Policy
Reloading Changes Dynamically
TimeTrace Databases
Machine Roles and Server Functions
Files for Software Update
Importing New Files into a One Identity Manager Database
Exporting Files from a One Identity Manager Database
Configuring Files
Operating Systems in Use
System Configuration Reports
Using Predefined Database Queries
Managing Custom Database Objects within a Database
Basics of the Data Model
General Advice for Editing Table and Column Definitions
Working with the Schema Editor
Mapping Table Definitions
Granting One Identity Manager Schema Permissions
Table Properties
Working with Module Globally Unique Modifiers
Table scripts
Database Views of Type "View"
Database Views of Type "Union"
Database Views of Type "Proxy"
Database Views of Type "Read-only"
Mapping Column Definitions
Column Properties
Templates
Mapping Table Relations
Supporting File Groups
Editing Value Templates
Example of Local Value Templates within an Object
Example of Value Templates across Objects
Formats for Checking Values
Permitted Column Values
Mapping Dynamic Foreign Keys
Column Dependencies for Setting Values
Configuring Columns for Full-Text Search
Predefined Permissions Groups and System Users
Editing Permissions Groups and System Users
Working with the User Interface
Working with the User & Permissions Group Editor
Permissions Group Dependencies
Copying Permissions Groups
Manually Creating Permissions Groups
Permissions Groups Properties
Editing System Users
Adding a System User to Permissions Groups
Dynamic system user
Which Employees Use System Users?
Editing Permissions for One Identity Manager Schema Tables and Columns
Rules for Finding Valid Permissions for Tables and Columns
Working with the Permissions Editor
Availability of Certain Functionality
Displaying Permissions for an Object
Displaying the Current User's Permissions
Menu Items
Views in the Permissions Editor
Functions in the Permissions Edit View
Filtering Entries in the Permissions Editor
Granting Permissions for Tables
Granting Column Permissions
Object definitions for the User Interface
Process Orchestration in One Identity Manager
Selection Criteria for Object Definitions
Using Display Text for Object Definitions
Working with Object Definitions
User Interface Navigation
Navigation View Elements
Recommendations for Editing Menu Navigation
Working with the User Interface Editor
Editing Menu Items
General Menu Item Properties
Creating Database Queries for Data Dependent Menu Items
Editing Lists
Using Links
Using Variables
Forms for the User Interface
Recommendations for Editing Forms
Working with the Form Editor
Editing Interface Forms
Statistics in the One Identity Manager
User Interface Form Properties
Form Definitions and Form Templates
Effects of Object Definitions when Displaying Interface Forms
Features of the Assignment Form
Forms for Custom Extensions
Custom Master Data Forms
Configuration Data for Displaying Many-to-Many and Object Relations on Forms
Replacing Default Forms with Custom Forms
Working with Overview Forms
Working with Statistic Definitions
Linking Statistics into the User Interface
Diagram Types for Visualizing Statistics
Examples of Statistic Definitions
Extending the Launchpad
Task Definitions for the User Interface
Applications for Configuring the User Interface
Icons and Images for Configuring the User Interface
Language Dependent Data Representation
Declaring the Job Server
Tracking Changes with Process Monitoring
Working with the Job Server Editor
Editing a Job Server
One Identity Manager Service Configuration
Job Server Properties
Server Functions of a Job Server
Job Server Machine Roles
Job Server Statistic Information
Installing the One Identity Manager Service on the Job Server
Customizing the One Identity Manager Service Configuration for a Job Server
One Identity Manager Service Configuration Files
Process Collection Module
Handling Processes in the One Identity Manager
MSSQLJobProvider
OracleJobProvider
FileJobProvider
FTPJobProvider
HTTPJobProvider
AppServerJobProvider
The Jobdestination Module
The Configuration Module
The Logwriter Module
The Dispatcher Module
The Connection Module
The HTTP Authentication Module
The Plug-ins Module
HTTPLogPlugin
ScheduleCommandPlugin
DBSchedulerWatchDogPlugin
RequestWatchDogPlugin
PerformanceCounterPlugin
DebugMailPlugin
ShareInfoPlugin
RemoteConnectPlugin
Module File with Private Key
Working with the Process Editor
Defining Processes
Creating and Editing Processes
Executing Processes Automatically
Process Components
Properties for a Process
Using Process Specific and Global Variables for the Process Definition
Thresholds for Handling Processes
Creating and Editing Events
Creating and Editing Process Steps
Process Step Parameters
Searching for a Process Step within a Process
Comparing Processes
Exporting and Importing Processes
Simulating Process Generation
Checking the Validity of a Process
Compiling a Process
Basics for Process Monitoring
Logging Data Changes
Logging Process Information during Process Handling
Recording Messages in the Process History
Process Tracking for DBQueue Processor Operations
Archiving and Deleting Recordings
Conditional Compilation using Preprocessor Conditions
Preprocessor Relevant Configuration Parameters
Preprocessor Conditions in Objects
Preprocessor Conditions in VB.Net Expressions
Evaluation of Preprocessor Conditions during Compilation
One Identity Manager Scripts
Using Scripts
Message Output
Implementing Dates
Using Dollar ($) Notation
Maintaining Mail Templates
Reports in the One Identity Manager
Accessing Local Object Columns
Accessing Object Columns Connected by a Relation
Accessing the Old Column Value
Accessing Column Display Values
Accessing References in Comments
Accessing Local Object Meta Values
Using base. Object
Calling Functions
Pre-scripts for using in Processes and Process Steps
Using Session Services
Querying Configuration Parameters
Testing the Existence of Certain Database Entries
Querying Session Object Global Variables
Using #LD Notation
Scripts in the Script Library
Working with the Script Editor
Editing Scripts
Overriding Scripts
Testing Script Compilation
Testing a Script with the Script Editor
Testing Scripts with the System Debugger
Working with the Report Editor
Creating and Editing Reports
Custom schema extensions
General Report Properties
Creating a Data Source
Example of a Simple Report with Data Grouping
Translating Reports
Linking Reports into the User Interfaces
Data Retrieval using an SQL Query
Data Retrieval using a Database View
Data Retrieval using an Object
Data Retrieval using Single Object History
Data Retrieval using Multiple Object History
Data Retrieval using Historical Assignments
Data Query for Simulation Data
Editing Report Parameters
Using Virtual Data Sources
Editing the Report Form
Creating a New Table
Extending a Table
Defining Columns
Transporting One Identity Manager Schema Customizations
Creating a Simple Column
Creating a Foreign Key Column
Creating New Columns for Database Views
Configuring Column Properties
Creating a Read-Only Database View
Creating a Union View
Creating New Assignments Tables
Creating Indexes
Permissions for Schema Extensions
Specifying Change Labels for Schema Extensions
Adding Schema Extensions
Adding in Custom Extensions to the User Interface
Basics for Transport of One Identity Manager Schema Modifications
Creating a Transport Package with the Database Transporter
Importing Data
Transporting SQL Statements
Transporting Favorite Objects
Transport by Change Label
Transport by Change Information
Transporting Schema Extensions
Transporting Selected Objects and their Dependencies
Transporting System Configuration
Transporting System Files
Displaying Contents of a Transport Package
Importing a Transport Package with the Database Transporter
Displaying Transport History
Importing Data from CSV Files
Importing Data from a Database
Import Configuration
Web Service Integration
Assigning Target Tables and Columns
Assigning Target Columns with the Assignment Wizard
Specifying the Hierarchy
Options for Handling Records
Specifying Connection Variables
Importing Data
Using Import Definition Files
Binding a Web Service
SOAP Web Service
Generic Web Service Call
Direct Web Service Call
Self-Defined Web Service Call
Creating a Web Service Solution with the Web Service Integration Wizard
Changing a Web Service Solution
Deleting a Web Service Solution
Installing and Configuring the SOAP Web Service
One Identity Manager as SPML Provisioning Service Provider
Installing the SOAP Web Service
Configuring the SOAP Web Service
Displaying the Status of a SOAP Web Service
Uninstalling the SOAP Web Service
Examples of Calls
SPML Web Service
Installing and Configuring SPML Web Services
Configuring the One Identity Manager Schema
Testing SPML Web Service Functionality
Searching for Errors in the One Identity Manager
Monitoring Process Handling with Job Queue Info
Processing DBQueue Tasks
Working with Job Queue Info
Job Queue Info Views
Monitoring Process Execution
Error Messaging in the Error Message Window
Displaying Messages in the Error Log View
Logging Messages in the Database Journal
Writing the One Identity Manager Log
One Identity Manager Service Logging
Displaying Details of Process Handling
Displaying Details of Process Step Handling
Displaying Details of a Process Step Parameter
Reinstating Process Steps and Processes
Enabling Extended Logging of Process Steps
Determining the State of the Server
Displaying Entries in the DBQueue
Displaying Messages in the Database Journal
Displaying the Job Queue Sequence
Stopping the System (Emergency Stop)
Configuring the One Identity Manager Service Log File
Advanced Logging in the One Identity Manager Service
Displaying the One Identity Manager Service Log File
Extended Debugging in the One Identity Manager Service
Output of Extended Return Values from Individual Process Components
Outputting Custom Messages in the One Identity Manager Service Log File
Logging Messages in the Event View
HTTPLogPlugins Log File
Displaying One Identity Manager Application Server Status
Configuring the DBQueue Processor for Test and Development
Initializing the DBQueue Processor
Controlling Processing of DBQueue Processor Tasks
Processing DBQueue Processor Tasks
Reactivating DBQueue Processor Tasks
Bulk Processing in DBQueue Processor
How the Central Dispatcher Communicates with Individual Slots
Scheduled Maintenance Tasks
One Identity Manager Configuration Files
Working with the User & Permissions Group Editor
Granting One Identity Manager Schema Permissions > Editing Permissions Groups and System Users > Working with the User & Permissions Group Editor
Working with the User & Permissions Group Editor
Use the User & Permissions Group Editor to create and edit system users and permissions groups. The editor is started from the program "Designer" and opens in the document view. Only additional User & Permissions Group Editor functions are described in the following.
Menu Items
The following items are added to the menu bar when the editor starts.
| Menu | Menu Item | Meaning |
|---|---|---|
| Permissions group | New | Adds a new permissions group. |
| Delete | Deletes the selected permissions group after requesting confirmation. | |
| Assign users... | Opens a dialog window in which system users can be selected for assignment to a permissions group | |
| Copy permissions groups... | Starts a wizard for copying permissions groups. | |
| Refresh | Updates the hierarchical view of the permissions groups. | |
| Users | New | Adds a new system user. |
| Delete | Deletes the selected system user after requesting confirmation. | |
| Assign permissions groups... | Opens a dialog window in which permissions groups can be selected for assignment to a system user. | |
| Create administrator | Creates a new system user and adds it to the default permissions group. | |
| Options | Display permissions group inheritance | Shows/hides a system user’s permissions group membership inheritance in the hierarchical view. |
| View | Properties | Shows/hides the edit view. |
| One Identity Manager employees | Shows employees that use this system user. | |
| Help | Users and permissions group management help | Opens the help on this topic. |
| User & Permissions Group Editor help | Opens the editor help. |
| Icon | Meaning |
|---|---|
 |
Inserts a system user. |
 |
Deletes a system user. |
 |
Inserts a permissions group. |
 |
Deletes a permissions group. |
 |
Create administrator. |
 |
Zooms in on the view. |
 |
Zooms out on the view. |
 |
Hides/shows system user’s inherited permissions group memberships in the hierarchical view. |
 |
Updates the permissions group display in the hierarchical view. |
Views in the User & Permissions Group Editor
Granting One Identity Manager Schema Permissions > Editing Permissions Groups and System Users > Working with the User & Permissions Group Editor > Views in the User & Permissions Group Editor
Views in the User & Permissions Group Editor
The User & Permissions Group Editor has several views for displaying and editing system users and permissions groups.
| View | Description | ||
|---|---|---|---|
| System user and permissions groups edit view | The properties of the selected system user or permissions group are displayed in the edit view and may be changed there. A default context menu is available for input fields. | ||
| System user and permissions groups edit view |
This view displays the permissions groups in their hierarchical form. The permissions group memberships are displayed for one system user. Each permissions group is represented by a permissions group element. Each permissions group element has a tooltip. The contents of the tooltip is made up of the name and description of the permissions group.
|
Figure 23: User & Permissions Group Editor with Hierarchical View (Above) and Edit View (Below)
| Context Menu Item | Meaning |
|---|---|
| Assign users... | Assigns users to the selected permissions group. |
| Assign permissions group... | Assigns permissions groups to the selected system user. |
| Inherit permissions from... | The selected permissions group is added to other permissions groups and inherits permissions from those permissions groups. |
| Permissions inherited by... | More permissions group are added to the selected permissions group. Permissions subgroups inherit permissions from the selected permissions group. |
| Navigation | Shows all other editors that can be used with the selected object. |
Permissions Group Dependencies
Granting One Identity Manager Schema Permissions > Editing Permissions Groups and System Users > Permissions Group Dependencies
You can enable permissions and user interface components to be passed on from one permissions group to other permissions groups by structuring permissions groups hierarchically. This means that inheritance is top down within the hierarchy.
Example
Two permissions groups are defined with the following permissions and user interface components.
| Permissions group | Permissions | User interface |
|---|---|---|
| A | Viewing permissions | Menu structures and forms |
| B | Edit permissions | Methods |
Permissions group A is above permissions group B in the hierarchy, so that B inherits the permissions group from A. Therefore the viewing and edit permissions and the menu structure, form and methods are available to users of the permissions group B.
You can use the hierarchical view in the User & Permissions Group Editor to set up dependencies between permissions groups. Permissions groups, which are higher up in the hierarchy are displayed further to the right in the User & Permissions Group Editor. When a permissions group is selected in the hierarchical view, the dependencies to other permissions groups are marked in color which also is also used to show the direction of inheritance.
Figure 24: Diagram of Permissions Group Hierarchy (Direction of Inheritance from Right to Left)
| Color | Meaning |
|---|---|
|
Blue |
The selected permissions group. |
| Purple | This permissions group is a child of the selected permissions group and directly inherits from the selected permissions group. |
| Light purple | This permissions group inherits indirectly from the selected permissions group over the hierarchy. |
| Red | This permissions group is a parent of the selected permissions group and passes inheritance to the selected permissions group. |
| Light red | This permissions group passes inheritance indirectly to the selected permissions group over the hierarchy. |
| Gray | This permissions group does not inherit or pass inheritance to the selected permissions group. |
When a new permissions group is inserted into the hierarchical view the element is initially labeled as "New permissions group". The permissions group name is copied to the permissions group element when the hierarchical view is refreshed.
To display the permissions group elements hierarchically they are attached to each other with a connector. You can control the connection points with your mouse.
- To link permissions group elements, hold down the left mouse button and drag the connector from one permissions groups element to the other. The mouse cursor changes from a sidewards pointing arrow to a downwards pointing arrow.
- To release the connection, hold the left mouse button down and drag the connector back from one permissions group element to the other. The mouse cursor changes from a sidewards pointing arrow to an upwards pointing arrow in the process.