Configuring the One Identity Manager schema
The SPML web service supports the entire One Identity Manager schema. It is necessary to define the objects and properties to be managed as well as the relations in the One Identity Manager schema in order to manage objects and their relations using the SPML web service. The SPML web service cannot be used until the objects and properties as well as references have been defined in the One Identity Manager schema as being managed with SPML. After the definition has been made, two schema files are created that are needed for validation by the SPML web service. The files should be exchanged in the appropriate SPML web service directory.
Detailed information about this topic
Preparing the One Identity Manager schema for export to the SPML schema
For administration of objects with individual properties and of relations between different object types with SPML web service, label the corresponding tables, columns, and table relations of the One Identity Manager schema to be exported to the SPML schema.
To manage objects and their properties with the SPML web service
-
In the Designer, select the One Identity Manager schema category.
-
Select the table and start the Schema Editor with the Show table definition task.
-
On the Table tab, enable the Export for SPML schema option.
-
Select the column in Schema Editor.
-
On the Miscellaneoustab, enable the Export for SPML schema option.
NOTE: If references between different One Identity Manager schema object types are managed with the SPML Web Service, both of the affected objects for SPML administration must be marked. Therefore, both tables must be labeled with the Export for SPML schema option.
References between object types are mapped by foreign key relations and many-to-many assignments in One Identity Manager.
-
It is sufficient to mark the corresponding column in the One Identity Manager schema with the Export for SPML schema option in order to manage foreign key relations with SPML.
NOTE: Note that only one foreign key relation can be managed between two object types using SPML. Thus the business role manager (Org.UID_PersonHead) can be maintained with SPML, but not at the same time as the deputy manager (Org.UID_PersonHeadSecond).
-
For the configuration of many-to-many relations for use with SPML, select the respective many-to-many tables and label the table relation with the Export for SPML schema option.
Related topics
Creating schema files
Once you have labeled all tables, columns, and table relations that should be managed using SPML, you need to create the necessary schema file for SPML web service.
IMPORTANT:
-
Before exporting, ensure that you have committed all the changes in the Designer in the main database and that all open calculation tasks for the DBQueue Processor have been processed.
-
If you change other SPML-relevant settings on the One Identity Manager schema at a later date, you must recreate the schema file.
To create a schema file
-
In the Designer, start One Identity Manager in the Schema Editor.
-
Select the Schema > Export SPML schema information menu item.
-
Confirm the security prompt with OK.
-
In the Browse for folder dialog, enter the directory where the schema files will be created.
-
Click OK.
This starts the export. The export can take some time depending on the number of changes.
-
Click OK.
Place the QOIM_Schema.xsd and QOIM_SpmlTargetSchema.xsd schema files in the SPML web service directory. Enter the storage location for the schema files in the SPML web service configuration file. The files are saved by default to the Schemas directory in the installation directory.
Related topics
Testing SPML web service functionality
A simple test front-end is supplied in order to test the basic functionality of SPML web service. Prerequisite for using the test front-end is that SPML web service is correctly installed and configured. Use a browser to check whether SPML web service is functioning and correctly installed.
The SPML web service can be reached over a browser under:
http://<server>/<application name>
https://<server>/<application name>
TIP: You can open the web server's status display in the Job Queue Info. In the Job Queue Info, select View > Server state in the menu and, on the Web servers tab, open the web server status display from the Open in browser context menu.
Detailed information about this topic