Sample code for 30+ languages & platforms
Java

SOAP WS-Security UsernameToken

See more XML Examples

Demonstrates how to add a UsernameToken with the WSS SOAP Message Security header.

Note: This example requires Chilkat v9.5.0.66 or later.

Chilkat Java Downloads

Java
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    //  This example requires the Chilkat API to have been previously unlocked.
    //  See Global Unlock Sample for sample code.

    //  An HTTP SOAP request is an HTTP request where the SOAP XML composes the body.
    //  This example demonstrates how to add a WS-Security header such as the following:
    //  
    //  <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="SecurityToken-6138db82-5a4c-4bf7-915f-af7a10d9ae96">
    //    <wsse:Username>user</wsse:Username>
    //    <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">CBb7a2itQDgxVkqYnFtggUxtuqk=</wsse:Password>
    //    <wsse:Nonce>5ABcqPZWb6ImI2E6tob8MQ==</wsse:Nonce>
    //    <wsu:Created>2010-06-08T07:26:50Z</wsu:Created>
    //  </wsse:UsernameToken>
    //  

    //  First build some simple SOAP XML that has some header and body.
    CkXml xml = new CkXml();
    xml.put_Tag("env:Envelope");
    xml.AddAttribute("xmlns:env","http://www.w3.org/2003/05/soap-envelope");
    xml.UpdateAttrAt("env:Header|n:alertcontrol",true,"xmlns:n","http://example.org/alertcontrol");
    xml.UpdateChildContent("env:Header|n:alertcontrol|n:priority","1");
    xml.UpdateChildContent("env:Header|n:alertcontrol|n:expires","2001-06-22T14:00:00-05:00");
    xml.UpdateAttrAt("env:Body|m:alert",true,"xmlns:m","http://example.org/alert");
    xml.UpdateChildContent("env:Body|m:alert|m:msg","Pick up Mary at school at 2pm");
    System.out.println(xml.getXml());
    System.out.println("----");

    //  The following SOAP XML is built:

    //  	<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope">
    //  	 <env:Header>
    //  	  <n:alertcontrol xmlns:n="http://example.org/alertcontrol">
    //  	   <n:priority>1</n:priority>
    //  	   <n:expires>2001-06-22T14:00:00-05:00</n:expires>
    //  	  </n:alertcontrol>
    //  	 </env:Header>
    //  	 <env:Body>
    //  	  <m:alert xmlns:m="http://example.org/alert">
    //  	   <m:msg>Pick up Mary at school at 2pm</m:msg>
    //  	  </m:alert>
    //  	 </env:Body>
    //  	</env:Envelope>
    //  

    //  Now build the WSSE XML housing that we'll insert into the above SOAP XML at the end.

    //  	<wsse:Security>
    //  	  <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="WSU_ID">
    //  	    <wsse:Username>USERNAME</wsse:Username>
    //  	    <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">PASSWORD_DIGEST</wsse:Password>
    //  	    <wsse:Nonce>NONCE</wsse:Nonce>
    //  	    <wsu:Created>CREATED</wsu:Created>
    //  	  </wsse:UsernameToken>
    //  	</wsse:Security>

    CkXml wsse = new CkXml();
    wsse.put_Tag("wsse:Security");
    wsse.UpdateAttrAt("wsse:UsernameToken",true,"xmlns:wsu","http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd");
    wsse.UpdateAttrAt("wsse:UsernameToken",true,"wsu:Id","WSU_ID");
    wsse.UpdateChildContent("wsse:UsernameToken|wsse:Username","USERNAME");
    wsse.UpdateAttrAt("wsse:UsernameToken|wsse:Password",true,"Type","http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest");
    wsse.UpdateChildContent("wsse:UsernameToken|wsse:Password","PASSWORD_DIGEST");
    wsse.UpdateChildContent("wsse:UsernameToken|wsse:Nonce","NONCE");
    wsse.UpdateChildContent("wsse:UsernameToken|wsu:Created","CREATED");
    System.out.println(wsse.getXml());
    System.out.println("----");

    //  Insert the wsse:Security XML into the existing SOAP header:
    CkXml xHeader = xml.GetChildWithTag("env:Header");
    xHeader.AddChildTree(wsse);

    //  Now show the SOAP XML with the wsse:Security header added:
    System.out.println(xml.getXml());
    System.out.println("----");

    //  Now our XML looks like this:
    //  	<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope">
    //  	    <env:Header>
    //  	        <n:alertcontrol xmlns:n="http://example.org/alertcontrol">
    //  	            <n:priority>1</n:priority>
    //  	            <n:expires>2001-06-22T14:00:00-05:00</n:expires>
    //  	        </n:alertcontrol>
    //  	        <wsse:Security>
    //  	            <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="WSU_ID">
    //  	                <wsse:Username>USERNAME</wsse:Username>
    //  	                <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">PASSWORD_DIGEST</wsse:Password>
    //  	                <wsse:Nonce>NONCE</wsse:Nonce>
    //  	                <wsu:Created>CREATED</wsu:Created>
    //  	            </wsse:UsernameToken>
    //  	        </wsse:Security>
    //  	    </env:Header>
    //  	    <env:Body>
    //  	        <m:alert xmlns:m="http://example.org/alert">
    //  	            <m:msg>Pick up Mary at school at 2pm</m:msg>
    //  	        </m:alert>
    //  	    </env:Body>
    //  	</env:Envelope>
    //  

    //  -----------------------------------------------------
    //  Now let's fill-in-the-blanks with actual information...
    //  -----------------------------------------------------

    String wsu_id = "Example-1";
    wsse.UpdateAttrAt("wsse:UsernameToken",true,"wsu:Id",wsu_id);

    String password = "password";
    String username = "user";
    wsse.UpdateChildContent("wsse:UsernameToken|wsse:Username",username);

    //  The nonce should be 16 random bytes.
    CkPrng prng = new CkPrng();
    CkBinData bd = new CkBinData();
    //  Generate 16 random bytes into bd.
    //  Note: The GenRandomBd method is added in Chilkat v9.5.0.66
    prng.GenRandomBd(16,bd);

    String nonce = bd.getEncoded("base64");
    wsse.UpdateChildContent("wsse:UsernameToken|wsse:Nonce",nonce);

    //  Get the current date/time in a string with this format: 2010-06-08T07:26:50Z
    CkDateTime dt = new CkDateTime();
    dt.SetFromCurrentSystemTime();
    boolean bLocal = false;
    String created = dt.getAsTimestamp(bLocal);
    wsse.UpdateChildContent("wsse:UsernameToken|wsu:Created",created);

    //  The password digest is calculated like this:
    //  Password_Digest = Base64 ( SHA-1 ( nonce + created + password ) )
    bd.AppendString(created,"utf-8");
    bd.AppendString(password,"utf-8");

    CkCrypt2 crypt = new CkCrypt2();
    crypt.put_HashAlgorithm("SHA-1");
    crypt.put_EncodingMode("base64");
    //  Note: The HashBdENC method is added in Chilkat v9.5.0.66
    String passwordDigest = crypt.hashBdENC(bd);
    wsse.UpdateChildContent("wsse:UsernameToken|wsse:Password",passwordDigest);

    //  Examine the final SOAP XML with WS-Security header added.
    System.out.println(xml.getXml());
  }
}