Provisioning Reference Guide › Program Exits › Define Common Exits in the Provisioning Manager

Define Common Exits in the Provisioning Manager

You can define a common exit that will be executed in the Provisioning Server core infrastructure by using the Program Exit property sheet.

Note: To define a Native Exit to be executed in a managed endpoint type, see the specific Connector Guide.

To define a common program exit

1. Click Endpoints.
2. Select Common Program Exit from the drop-down list in the Object Type field.
3. Click New. The Common Program Exit dialog appears.
4. Fill in the name and description of the exit to be invoked on the Program Exit tab. If the Disabled box is selected, the program exit will not be invoked, even if it is referenced in another object.
5. Specify whether the Provisioning Server uses the Simple Object Access Protocol (SOAP) or a Dynamic Link Library (DLL) file to invoke the exit on the Common Parameters tab. You can specify that the information be sent securely by selecting SSL Enabled.
6. Enter the path that points to the DLL file or the address of the SOAP service in the Location field. In the Method field, provide the name of the exported function in the DLL file or the name of the function defined by the SOAP service.

   For DLL program exits, you can enter for location either a full path, such as:

   c:\yourfolder\yourlibrary.dll
   

   or you can enter just the common name of the library

   yourlibrary
   

   If you enter just the common name, you can have more than one Provisioning Server for the domain, where the library does not have to appear at exactly the same path. This is important if the domain has a mix of Solaris and Windows servers, because these operating systems have different pathname syntax.

   If you provide just a common name (yourlibrary), the Provisioning Server will locate the library in the following way:

   • For Windows, locate yourlibrary.dll file on the Provisioning Server service’s execution path as defined by the PATH environment variable. We recommend that you place the library in the PSHOME\bin folder which is known to already be on PATH.
   • For Solaris, locate the libyourlibrary.so file on the Provisioning Server service’s library path as defined by the LD_LIBRARY_PATH environment variable. We recommend that you place the library into the $PSHOME/lib directory which is known to already be on LD_LIBRARY_PATH.
7. Select an Authentication Type to provide information for authentication data to be passed to the invoked program exit on the Authentication tab:
   • Select None to pass no authentication data to the exit.
   • Select Current User to pass the authentication data of the global user who is logged on at the time the exit is invoked.
   • Select Proxy User to select a specific global user that will be used for authorization of the operations.

   Note: When you select Proxy User, the information you provide must be that of a valid global user.

   • Select Other to enable the Authentication Details group field, which lets you select an arbitrary name and password. The exit code uses this information for authentication.
8. Click OK to complete the definition of the common exit.