2.2.2.1.1 GetAuthorizationCookie

  • Article

msdn link

Synopsis:

This method provides a mechanism for the server to authenticate and authorize client access to the client Web service.

 <wsdl:operation name="GetAuthorizationCookie" />

The SOAP operation is defined as given below.

 <soap:operation soapAction="http://www.microsoft.com/
    SoftwareDistribution/Server/SimpleAuthWebService/GetAuthorizationCookie" 
    style="document" />

Request:

 <s:element name="GetAuthorizationCookie">
   <s:complexType>
     <s:sequence>
       <s:element minOccurs="0" maxOccurs="1" name="clientId" 
          type="s:string" />
       <s:element minOccurs="0" maxOccurs="1" name="targetGroupName" 
          type="s:string" />
       <s:element minOccurs="0" maxOccurs="1" name="dnsName" 
          type="s:string" />
     </s:sequence>
   </s:complexType>
 </s:element>

clientId: A ClientIdString that the client SHOULD generate at the time of installation to identify itself. This element MUST be present.

targetGroupName: A named collection of computers (target group) in which the client claims membership.

dnsName: The client's name. It MUST uniquely identify the computer on the network. The client MUST also use the same value in the call to RegisterComputer (section 2.2.2.2.3). This element MUST be present.

Response:

The server MUST return a result with the following syntax.

 <s:element minOccurs="0" maxOccurs="1" 
    name="GetAuthorizationCookieResult" type="s1:AuthorizationCookie" />

GetAuthorizationCookieResult: Upon successful completion of this operation, this element MUST be returned. The syntax for the AuthorizationCookie type MUST be as specified in section 2.2.3.4.