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.