Using profiles from other vendors

Introduction

Using the transparent API you can download and manage profiles which are created by KPN as well as use profiles that originate with other vendors. To ensure that your requests are accepted by the RSP platform, you can signal which vendor is associated with the profile you are managing by supplying the X-KPN-ProviderEntityIdattribute.

The X-KPN-ProviderEntityId attribute

The X-KPN-ProviderEntityId attribute is an optional query parameter which may be part of the URI specified in the From element of the WS-Addressing headers of your SOAP envelope.

Similar to the EntityId query parameter, the value is an OID identifying an organistion. The value of the X-KPN-ProviderEntityId should be the OID associated with the vendor of the profile which you are trying to manage.

Example:

<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope">
  <env:Header xmlns:add="http://www.w3.org/2005/08/addressing">
    <add:From>
       <!-- 
         - Change as needed in your own application. This example decodes to: 
         -   EntityId = KPN OID (change this to match your own organisation's OID)
         -   EntityName = KPN (optional label, you can omit this entirely)
         -   X-KPN-ProviderEntityId = OID associated with Arqia profiles (change this to match the vendor of your profile)
        -->
       <add:Address>http://rsp.kpnthings.com?EntityId=1.3.6.1.4.1.6886?EntityName=KPN?X-KPN-ProviderEntityId=1.3.6.1.4.1.54008</add:Address>
    </add:From>
    <!-- rest of your SOAP request including other WS-Addressing headers, body, etc. -->
</env:Envelope>    

Please note that ? should be used as separator between multiple query parameters: this behavior is not specified as part of SGP .02 in version 3.2 but has been standardized from version 4.x onward.

List of vendors and their associated X-KPN-ProviderEntityId

The table below lists profile vendors and their associated X-KPN-ProviderEntityId values.

Vendor	X-KPN-ProviderEntityId
Arqia	1.3.6.1.4.1.54008
KPN	1.3.6.1.4.1.6886
Telenor	1.2.752.252

If you do not see your vendor listed here, please contact support for more information.