2.2.4.14 LinkMacToViewerSecurityChallenge

The LinkMacToViewerSecurityChallenge message is sent by the server to request authentication from the client.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

chunkLen

MID

playIncarnation

cookie

cbToken

pToken (variable)

...

chunkLen (4 bytes): Length of the message in chunks. A chunk is 8 bytes.

MID (4 bytes): Message ID. For this message, the value MUST be 0x0004001A.

playIncarnation (4 bytes): A 32-bit field. It MUST be set to the value of the playIncarnation field in the message received from the client that triggered the transmission of this LinkMacToViewerSecurityChallenge message. The message is either a LinkViewerToMacOpenFile (section 2.2.4.21) message or a LinkViewerToMacSecurityResponse (section 2.2.4.24) message.

cookie (4 bytes): A 32-bit field. It SHOULD be set by the server in such a way that when the client echoes the value of this field in the LinkViewerToMacSecurityResponse (section 2.2.4.24) message, the server can determine what LinkMacToViewerSecurityChallenge message the LinkViewerToMacSecurityResponse (section 2.2.4.24) message is a response to.

cbToken (4 bytes): An unsigned 32-bit integer. It MUST be the size of the pToken field in bytes.

pToken (variable): A variable-size array of bytes. If Basic authentication (as specified in [RFC2617]) is used, the pToken field MUST consist of an array of Unicode characters, and MUST adhere to the following ABNF syntax:

 basic-realm= "realm="
    realm-value ; as defined in [RFC2617]
 ptoken-value= [ basic-realm ] %x0000 
            

If the authentication realm for Basic authentication is unspecified, the basic-realm syntax element SHOULD still be included in the pToken field. In that case, the realm-value syntax element SHOULD be set to an empty quoted string.<13>

If NT LAN Manager (NTLM) authentication (as specified in [MS-NLMP]) is used, the first two bytes of the pToken field MUST be 0x00. Any subsequent bytes of pToken are either an NTLM_AUTH structure (as defined in section 2.2.4.14.1) or an NTLM challenge token (as defined in [MS-NLMP] section 2.2.1.2).