The Identity Manager User Application includes an e-mail notification facility that lets you send e-mail messages to notify users of changes in the state of the provisioning system, as well as tasks that they need to perform. To support access by third-party software applications, the notification facility includes a Web service endpoint. The endpoint lets you send an e-mail message to one or more users. When you send an e-mail, you include parameters that specify the target e-mail address, the e-mail template to use, and the replacement values for tokens in the e-mail template.
This Appendix describes the programming interface for the Notification Web Service.
You can access the Notification Web Service endpoint using a URL similar to the following:
http://server:port/warcontext/notification/service?test
For example, if your server is named “myserver”, your User Application is listening on port 8080, and your User Application war file is named “IDMPROV”, the URL would be:
http://myserver:8080/IDMPROV/notification/service?test
You can also access the SOAP endpoint by going to the tab within the User Application. To do this, you need to select the tab, then select from the left-navigation menu. After selecting , pick the Web Service endpoint you want from the list.
WARNING:The test page is disabled by default. Since some of the methods allow data to be updated, the test page presents a potential security vulnerability and should not be allowed in a production environment. For details on enabling the test page, see the instructions provided for the Role Service in Enabling the Test Page.
You can access the WSDL for the Notification Web Service using a URL similar to the following:
http://server:port/warcontext/notification/service?wsdl
For example, if your server is named “myserver”, your User Application is listening on port 8080, and your User Application war file is named “IDMPROV”, the URL would be:
http://myserver:8080/IDMPROV/notification/service?wsdl
Before using the Web Service, you need to use the WSSDK tool or another SOAP tool kit to generate the stub classes. To allow your code to find the stub classes, you also need to add the JAR that contains the stub classes to your classpath.
If you want to use the Novell WSSDK tool, you can generate the client stubs by extracting the WSDL and running the wsdl2java utility. For example, you could run this command to generate the stubs in a package called com.novell.ws.client.notification:
"C:\Program Files\Java\jdk1.5.0_14\bin\java" -cp "../lib/wssdk.jar;../lib/jaxrpc-api.jar";"../lib/mail.jar";"../lib/activation.jar";"c:\Program Files\Java\jdk1.5.0_14\lib\tools.jar"; com.novell.soa.ws.impl.tools.wsdl2java.Main -verbose -ds gensrc -d C:\ -noskel -notie -genclient -keep -package com.novell.ws.client.notification -javadoc notification.wsdl
You can change the wsdl2java parameters to suit your requirements.