Protocols/MSNP/Commands/USR

USR - MSNP8-MSNP14

Dispatch Server/Notification server

This command is used to authenticate a client with the notification server. If the client is connected to a dispatch server, the initial USR command sent by the client will be replied with a XFR command by the server, followed by disconnection. The XFR will contain the address of a suitable notification server that the client should connect to, to continue authentication.

Initial USR sent to server

Description

USR trid TWN I passport

Parameters

• trid: Transaction ID
• TWN : Name of authentication system (always "TWN")
• I : Status of authentication (always "I" for initial)
• passport : Your Protocols/MSNP/Passport address

Subsequent USR from server

The server will either respond with XFR to transfer you, or with USR to continue the authentication process.

Description

USR trid TWN S auth_string

Parameters

• trid: Transaction ID
• TWN: Name of authentication system (always "TWN")
• S: Status of authentication (always "S" for subsequent)
• auth_string: String used for Protocols/MSNP/Tweener authentication

Subsequent USR response to server

Description

USR trid TWN S ticket

Parameters

• trid: Transaction ID
• TWN: Name of authentication system (always "TWN" for Protocols/MSNP/Tweener)
• S: Status of authentication (always "S" for subsequent)
• ticket: Ticket retrieved after Protocols/MSNP/Tweener authentication

Final response from server

Description

USR trid OK account_name display_name verified 0

Parameters

• trid: Transaction ID
• OK: Confirms a successful login
• account_name: Your Protocols/MSNP/Passport account-name
• display_name: Your Protocols/MSNP/URL Encoded friendly-name
• verified: Either 0 or 1 if your account is verified
• 0: Unknown (Kids passport?)

Switchboard Server

Sent when authenticating with a switchboard you started yourself with the XFR command.

Sent to the SB

Description

USR trid accountname ticket

Parameters

• trid: Transaction ID.
• accountname: Your Passport account name.
• ticket: The ticket your got from the XFR command on the NS.

Response from SB

Description

USR trid OK accountname friendlyname

Parameters

• trid: Transaction ID.
• OK: Authentication OK
• accountname: Your Passport account name.
• friendlyname: Your personal friendly name (May not always be synchronized with the NS value)

USR - MSNP15

Protocols/MSNP/MSNP15 uses "Single sign on" authentication scheme instead of tweener, which is what all previous protocols used.

See Protocols/MSNP/MSNP15/SSO for more information.