Exploring SPML with Sun Identity Manager 7.x – A Cheatsheet

Are you tired of the high-level SPML content floating around the web from couple of analysts with no practical guidance ! If you are a practical guy..who want to explore SPML, here is something that you may find worth test-driving for SPML 1.0 amd SPML 2.0 based provisioning operations.


I had been using SPML using Sun IDM 7.0 for a while now.  Most frequently,  I forget the steps for configuration and also did’nt have the patience of going through the documentation (Frankly..I’m bit lazy).  So, I ended up doing my crazy way and here is the cheat sheet of the steps required.


Configuring SPML Web Services Endpoint in Sun IDM


1.  Make sure Sun IDM is deployed and tested to run in your Web container environment (My choice would be Glassfish on Solaris 10). Sorry, I am not a Windows guy 🙂

2. Open a terminal, set your JAVA_HOME and WSHOME environment variables

bash-3.00#  export JAVA_HOME=export JAVA_HOME=/usr/java
bash-3.00#  export WSHOME=/opt/SUNWappserver/domains/domain1/applications/j2ee-modules/idm
bash-3.00#  export
bash-3.00#  export DISPLAY=<your host_name>:0.0

bash-3.00# cd /opt/SUNWappserver/domains/domain1/applications/j2ee-modules/idm/bin
bash-3.00# ./lh console

3.  Configure SPML 1.0 and SPML 2.0 objects by importing them.

Configurator> import -f /opt/SUNWappserver/domains/domain1/applications/j2ee-modules/idm/sample/spml.xml
Added TaskDefinition:SPMLRequest
Added Configuration:SPML
Added Configuration:SPMLPerson
Added Configuration:SPMLRole
Added Configuration:SPMLResourceGroup
Added Configuration:BasicUser
Added Configuration:Empty
Added Configuration:SPMLviewtest1
Added Configuration:SysInfoForm
Configurator> exit

Configurator> import -f /opt/SUNWappserver/domains/domain1/applications/j2ee-modules/idm/sample/spml2.xml
Added TaskDefinition:SPML2Request
Updated Configuration:User Extended Attributes
Added Configuration:SPML2
Added Configuration:spml2PersonForm

Configurator> exit

4.  Set the Username/Password properties in Waveset.properties file.

bash-3.00# vi /opt/SUNWappserver/domains/domain1/applications/j2ee-modules/idm/config/Waveset.properties

Add the following to the end of Waveset.properties file:


4. Restart your Application Server:

bash-3.00# /opt/SUNWappserver/bin/asadmin stop-domain domain1

bash-3.00# /opt/SUNWappserver/bin/asadmin start-domain –user admin domain1

5. Test your SPML Web services connection. The following command will launch “SPML Monitor” Java application.

bash-3.00# ./lh spml

Sample code

Here is my code for testing (both SPML 1.0 and SPML 2.0), just compile and run it.





Enjoy !

4 thoughts on “Exploring SPML with Sun Identity Manager 7.x – A Cheatsheet

  1. Vishal Jaitly

    Hi Sir,
    Thnx a lot for your code. It really helped a lot to understand things.
    Actually i am a fresher and have to work on Sun Identity Manager 8.1, bt i have not got any formal training on it. I am struggling with the docs provided by sun i.e.
    a) SIM 8.1 deployment guide.pdf
    b) SIM 8.1 Installation.pdf
    c) SIM 8.1 overview.pdf
    d) SIM 8.1 Release notes.pdf
    e) Sun Identity Manager Deployment Reference.pdf
    f) Sun IdentityManager 8.1 Business Admin guide.pdf
    g) Sun IdentityManager 8.1 Web Services.pdf

    Bt i am not able to make u[ things out of that. Can u help me with some tutorials or exercises on SIM 8.1 that will b really a great help for me.

    Thank you.

  2. Sumira

    The sample code could not be downloaded. could you please help with that. Also how the connection between the Endpoint webservice and the Sun IDM is established? Do we need to use any connector? How the SIM identifies the webservice to post the request/response?


Leave a Reply

Your email address will not be published. Required fields are marked *