Sending requests to Identity Hub

Content type settings

To send requests to Identity Hub, the character set must be set to UTF-8. You set this in the XML header, using the content-type element:

Content-Type:text/xml;charset=UTF-8

This should be included in the header for every request sent to Identity Hub.

Example SOAP header

POST https://mysystem.experian.com/EIHEndpoint_v3 HTTP/1.1

Accept-Encoding: gzip,deflate

Content-Type: text/xml;charset=UTF-8

SOAPAction: ""

Content-Length: 5249

Host: testing.experian.com

Connection: Keep-Alive

User-Agent: An-HttpClient/1.1.1

Security settings

To access Identity Hub you must generate a WASP security token and then add the token to the SOAP header of the request contained within a BinarySecurityToken element. This header must follow the WS-Security protocol and be made up of three major elements: BinarySecurityToken, Signature and ReferenceList. For Identity Hub, you use BinarySecurityToken.

A BinarySecurityToken can contain any class of binary credential including proprietary tokens. The tokens must be base 64 binary encoded to conform to standard xml formats. ValueType specifies what type of token is being used. The ID is an optional string label for the security token.

You need to set the EncodingType to Base64 binary encoding and the ValueType to ExperianWASP.

Example BinarySecurityToken

<wsse:BinarySecurityToken ValueType="ExperianWASP" EncodingType="wsse:Base64Binary" wsu:Id="SecurityToken">

MjAtRTctQ0YtMTUtN0EtODEtNTk...

</wsse:BinarySecurityToken>

WS-Security SOAP Header structure

<soap:Header>

<wsse:Security>

<wsse:BinarySecurityToken>

...

</wsse:BinarySecurityToken>

<ds:Signature>

...

</ds:Signature>

<xenc:ReferenceList>

...

</xenc:ReferenceList>

</wsse:Security>

</soap:Header>

SOAP request message

<soap:Header>

<wsse:Security>

<wsu:Timestamp wsu:Id="Timestamp-2b27a32b-ca9c-4405-b377-4444f63c8f29">

<wsu:Created>2011-02-20T16:36:54Z</wsu:Created>

<wsu:Expires>2011-02-20T16:41:54Z</wsu:Expires>

</wsu:Timestamp>

<wsse:BinarySecurityToken ValueType="ExperianWASP" EncodingType="wsse:Base64Binary" wsu:Id="SecurityToken-f64439f9-c12c-4d09-ac3d-fc478ad19775">MjAtRTctQ0YtMTUtN0EtODEtNTk.</wsse:BinarySecurityToken>

</wsse:Security>

</soap:Header>

<soap:Body>

<!-- SOAP content for the Identity Hub service call -- >

</soap:Body>