Identity Manager 8.1 - Configuration Guide

Creating a web service solution with the Web Service Integration Wizard

Prerequisite

• Before you can bind a web service with the WCF service type, the SvcUtil,exe file must exist in the One Identity Manager installation directory.

  Refer to Microsoft for information about where you can purchase this file.

• Before you can bind a web service with the SOAP service type, the WSDL.exe file must be on the server that executed provisioning.

  Refer to Microsoft for information about where you can purchase this file.

To integrate a new web service

1. In Designer, select Base Data | General | Web services.
2. Select Integrate new web service from the task view.

   This start the Web Service Integration Wizard.

3. Click Next on the start page.
4. Enter the access data and general web service properties on the Integrate new web service page.

   Table 195: General properties of a web service

   Property	Description
   Web service name	Display name of the web service in One Identity Manager.
   Description	Spare text box for additional explanation.
   .NET namespace for the proxy code	Unique identifier for the .NET namespace.
   Web service URL	URL at which the web service is run.
   WSDL file URL	URL at which the WSDL.exe for the web service can be reached. If the WSDL.exe is not publicly available, it can also be saved locally. NOTE: If the web service operator changes the WSDL file, run the Web Service Integration Wizard again in order to implement the changes.
   Service type	Type of web service.
   Locked	Indicates whether the web service can be used.
   User name	User name for logging in to the web service.
   User domain	User domain.
   User password and password confirmation	Password for logging in to the web service.
   Proxy code generator	Path and file name for the proxy code generator. If the WCF service type is selected, path to SvcUtil.exe file. If the service type SOAP is selected, path to WSDL.exe file.

   Table 196: Advanced properties of a web service

   Property	Description
   Proxy server URL	URL of the proxy server, if communication is routed via a proxy server.
   Proxy server user name	User name for logging onto the proxy server.
   Proxy server domain	Proxy server domain.
   Proxy server password and password confirmation	Password and password confirmation for logging onto the proxy server.
   Timeout for WSDL.exe	Timeout for accessing the WSDL file.
   User-defined command line	Command line for calling the proxy code generator. The command line can extended by another parameter if required. Default command: /nologo /language:VB "/namespace:%Namespace%" "/out:{0}" %WsdlUrl% Example: /nologo /language:VB "/namespace:EnricoHolidayWebservice" "/out:{0}" http://kayaposoft.com/enrico/ws/v1.0/index.php?wsdl

   1. Click Check.

      This tests access to the web service.

   2. If the test is successful, click Next.
5. The generated proxy code is shown on the page, Create proxy code.

   The proxy code contains all web service methods, which are defined in the WSDL file and makes them available to the One Identity Manager script components.

6. On Select method calls, select the web service methods you want to use in One Identity Manager. A script is generated for each of the selected methods in the next step.
7. A script is generated to call the selected method on the Generate web service call page. Enter all the required parameter and properties for this.
   • Click to specify the type of method call.

     Table 197: Type of method call

     Type	Description
     Self-Defined Web Service Call	For more information, see Self-defined web service call .
     Direct Web Service Call	For more information, see Direct web service call.
     Generic Web Service Call	For more information, see Generic web service call.

   Table 198: Script properties

   Property	Description
   Script name	Name of script. Label custom scripts with the CCC_. Script names for the generic web service call must follow the following format: <customer prefix>_<table>_<target system>_<event> Select the table, target system and event to create the script for. Parameter, value type and data table are automatically determined from the selected table.
   Parameter	Name of the parameter.
   Value type	Parameter data type.
   Data table	Data table that contains the data to be transferred to the web service.
   Return value	Data type of the parameter containing the return value.

   Table 199: Data transfer

   Property	Description
   Parameter	Parameter transferred to the web service.
   Value type	Parameter data type.
   Mapped from	Parameter from the defined script properties. Open the menu and assign the associated parameters. If necessary, select the column from the data table which contains the value to be passed.

   You will see the generated script in the script code view. You can use extended edit mode to edit the script.

   TIP: The script calls the VID_GetWcfWebServicefunction, which in turn, uses the GetWcfBinding and GetWcfEndpointAddressfunctions. These three functions can be overwritten.

8. To end the Web Service Integration Wizard, click Finish.
9. Save the changes.
10. Compile the database.

Related Topics

• Scripts in One Identity Manager
• Overriding scripts

Modifying a web service solution

You can change or extend an existing web service solution at any time. This overwrites the existing script or adds new scripts.

To extend a web service solution

1. In Designer, select Base Data | General | Web services.
2. Select the web service in the List Editor.
3. Select Create web service call in the task view.

   This start the Web Service Integration Wizard.

4. Follow the wizard's instructions.
5. Save the changes.
6. Compile the database.

To edit a web service solution

1. In Designer, select Base Data | General | Web services.
2. Select the web service in the List Editor.
3. Select Edit web service.

   This start the Web Service Integration Wizard.

4. Follow the wizard's instructions.
5. Save the changes.
6. Compile the database.

Detailed information about this topic

• Creating a web service solution with the Web Service Integration Wizard

Deleting a web service solution

To delete a web service solution from the database

1. Delete the web service.
2. Delete all associated custom scripts.
3. Determine all other custom element of your web service solution and delete them.
4. Save the changes.
5. Compile the database.

SOAP Web Service

The One Identity Manager's SOAP Web Service provides a SOAP interface for accessing the One Identity Manager object model. The SOAP Web Service manages a connection pool. Not every call opens a new connection. Not all object layer functions are support by the SOAP Web Service. The SOAP Web Service supplies methods for single objects, object lists and function call.

Detailed information about this topic

• Installing and configuring the SOAP Web Service
• Examples of calls