Additional Subscription Options

Intel AMT Features > WS-Eventing > Detailed Description > Additional Subscription Options

Additional Subscription Options

This section describes additional options that can be defined when subscribing to events.

Reference Parameters

Reference parameters can be set during the subscribe command and will afterwards be sent to the subscriber receiving the events. Reference parameters are additional information that usually used to distinguish between events sent from different platforms.

It is normal to declare a namespace in the namespace declaration section:

<-- Optional: Added for the Reference Parameters -->

xmlns:m=”http://mynamespace.com”

And in the body of the subscribe command (inside a NotifyTo block below the </wsa:address> tag (See the example here):

<-- Optional: Reference Parameters (will be present in the

event) -->

<wsa:ReferenceParameters>

<-- This is free style -->

<m:Hello>here</m:Hello>

<m:Goodbye>there</m:Goodbye>

</wsa:ReferenceParameters>

<-- End of optional Reference Parameters -->

Reference parameters are limited by Intel AMT to a maximum length of 256 characters. This value includes tags and namespaces, and not just the values.

In the received event the following will be included in the event header:

<m:Hello xmlns:m="http://mynamespace.com">

Here

</m:Hello>

<m:Goodbye xmlns:m="http://mynamespace.com">

There

</m:Goodbye>

Digest Authorization

It is possible to send a username and password that will be used for digest authorization when the event is sent. This is done by adding the following section to the header or the subscribe request:

<-- Optional: To request digest authentication when alerts are sent -->

<wst:IssuedTokens

xmlns:wst="http://schemas.xmlsoap.org/ws/2005/02/trust"

xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-

wssecurity-secext-1.0.xsd" soap:mustUnderstand="true">

<wst:RequestSecurityTokenResponse>

<wst:TokenType>

http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#UsernameToken</wst:TokenType>

<wst:RequestedSecurityToken>

<wsse:UsernameToken>

<-- username -->

<wsse:Username>John</wsse:Username>

<wsse:Password

Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-

wssecurity-secext-1.0.xsd#PasswordText">

<-- Password -->

Pwd!123

</wsse:Password>

</wsse:UsernameToken>

</wst:RequestedSecurityToken>

</wst:RequestSecurityTokenResponse>

</wst:IssuedTokens>

<-- End of digest authentication section -->

And the following section should be part of the body of the subscribe request:

<-- Optional – if digest authorization is requested -->

<wsman:Auth

Profile="http://schemas.xmlsoap.org/wbem/wsman/1/wsman/
/secprofile/http/digest"/>

<-- End of digest authorization section -->

The Intel AMT device will use the username and password provided using HTTP digest authentication to authenticate itself to the WS-Eventing listener.