Click here for a complete list of operations.

GetAuthorisationChallenge

Issues the challenge that must be countersigned by the external Ministry authorisation gateway (ADONIS) before an actuation can be requested. DEVCON cannot countersign it locally, by design.

Test

To test the operation using the HTTP GET protocol, click the 'Invoke' button.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /services/Actuation.asmx HTTP/1.1
Host: devcon-dc01.local
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://devcon-dc01.local/sentris/GetAuthorisationChallenge"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetAuthorisationChallenge xmlns="http://devcon-dc01.local/sentris/">
      <nodeId>string</nodeId>
      <subjectMac>string</subjectMac>
      <tier>string</tier>
    </GetAuthorisationChallenge>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <GetAuthorisationChallengeResponse xmlns="http://devcon-dc01.local/sentris/">
      <GetAuthorisationChallengeResult>
      <challengeNonce>string</challengeNonce>
      <targetDigest>string</targetDigest>
      <validForSeconds>int</validForSeconds>
      <countersignBy>string</countersignBy>
      <gatewayState>string</gatewayState>
      </GetAuthorisationChallengeResult>
    </GetAuthorisationChallengeResponse>
  </soap:Body>
</soap:Envelope>