171 lines
6.2 KiB
Markdown
171 lines
6.2 KiB
Markdown
# Introduction
|
|
MSNP10 is the ninth released version of the Mobile Status Notification Protocol.
|
|
It was introduced officially in Client Version 6.1.0155.
|
|
|
|
# Command information
|
|
It introduces the notification service commands:
|
|
* ADC
|
|
* SBP
|
|
|
|
*No switchboard or dispatch service commands were known to be introduced in this version*
|
|
|
|
*No error codes were known to be introduced in this version*
|
|
|
|
The following commands were removed in this version:
|
|
* ADD (automatic disconnection)
|
|
* REA (automatic disconnection?)
|
|
|
|
# Known changes
|
|
(from [MSNP9](msnp9.md)):
|
|
* Added new initial profile variable `TOUNeeded`. If exists and set to 1,
|
|
a dialog box to review the Messenger Service Terms of Use is shown to the user.
|
|
* Changed SYN request and response.
|
|
Client: `SYN transactionID listVersion settingsVersion`.
|
|
Server: `SYN transactionID listVersion settingsVersion numberOfContacts numberOfGroups`.
|
|
`settingsVersion` is always 0.
|
|
* Current display name is removed from USR, now is returned with other user properties ([PRP](../commands/prp.md) commands) in SYN.
|
|
* [PRP](../commands/prp.md) MFN replaces REA (current passport). SBP (contact's address) MFN replaces other uses of REA.
|
|
* [LST](../commands/lst.md): Added prefixes to the user handle (`N=`) and friendly name (`F=`) parameters.
|
|
* Added new initial profile variable `ABCHMigrated`. If set to 1, some commands are altered, such as:
|
|
SYN: The request and response's list versions are now ISO 8601 with 7 subsecond digits,
|
|
usually with a -07:00 timezone offset.
|
|
the previously unused second parameter (both request and response) is used as the Last Settings Version,
|
|
and follows the same time format as List Versions now do.
|
|
[LST](../commands/lst.md): GUID specified as `C=` parameter, group IDs are now GUIDs.
|
|
ADC, REM: uses GUIDs instead of contact emails if the list is FL, and also for groups.
|
|
LSG, ADG: Uses GUIDs instead of IDs.
|
|
SBP: Uses the contact's GUID instead of the Contact Address.
|
|
* All list version updating commands no longer return the current list version when used.
|
|
[GTC](../commands/gtc.md), [BLP](../commands/blp.md), ADG, REG, RMG, REM, [PRP](../commands/prp.md) commands are affected by this change.
|
|
* Asynchronous [BPR](../commands/bpr.md) commands also do not include the new list version number,
|
|
and now provide Friendly Name (MFN) changes instead of sending entire NLNs [needs to be confirmed].
|
|
* Added a new list: Pending List/PL (bit 5, decimal 16). Is meant for unhandled contact added you notifications.
|
|
* Added new server-side [OUT](../commands/out.md) reasons: MIG, if the server has migrated you to ABCH,
|
|
and TOU, for not accepting the Service Terms of Use.
|
|
* Official Client: Now handles the 604 error code again, which was last seen in Client Version 3.6.003x.
|
|
Error code 913 is no longer handled after being implemented in Client Version 4.5.
|
|
* First protocol version to remove a core command implemented since [MSNP2](msnp2.md) draft (ADD).
|
|
|
|
# Client-server communication example
|
|
*NOTE: This has been line-breaked.
|
|
Lines beginning with `..` followed by a space are continuations of the previous line.*
|
|
```
|
|
C: VER 1 MSNP10 MSNP9 CVR0
|
|
S: VER 1 MSNP10
|
|
C: CVR 2 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com
|
|
S: CVR 2 6.1.0211 6.1.0211 6.1.0155
|
|
.. http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe
|
|
.. http://messenger.msn.com
|
|
C: USR 3 TWN I example@hotmail.com
|
|
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863
|
|
```
|
|
Client disconnects from server
|
|
|
|
Client opens a connection to 10.0.0.5:1863
|
|
```
|
|
C: VER 4 MSNP10 MSNP9 CVR0
|
|
S: VER 4 MSNP10
|
|
C: CVR 5 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com
|
|
S: CVR 5 6.1.0211 6.1.0211 6.1.0155
|
|
.. http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe
|
|
.. http://messenger.msn.com
|
|
C: USR 6 TWN I example@hotmail.com
|
|
S: USR 6 TWN S passport=parameters,neat=huh,lc=1033,id=507
|
|
C: USR 7 TWN S $(pp14response.headers.authenticationInfo["from-PP"])
|
|
S: USR 7 OK example@hotmail.com 1 0
|
|
S: MSG Hotmail Hotmail 465
|
|
MIME-Version: 1.0
|
|
Content-Type: text/x-msmsgsprofile; charset=UTF-8
|
|
LoginTime: 1726321960
|
|
EmailEnabled: 1
|
|
MemberIdHigh: 1
|
|
MemberIdLow: 2
|
|
lang_preference: 1033
|
|
PreferredEmail: example@hotmail.com
|
|
country: US
|
|
PostalCode:
|
|
Gender:
|
|
Kid: 0
|
|
Age:
|
|
BDayPre:
|
|
Birthday:
|
|
Wallet:
|
|
Flags: 1027
|
|
sid: 507
|
|
kv: 11
|
|
MSPAuth: whatever+t+is+in+your+passport+login+ticket+that+you+sent+for+USR+TWN+S$
|
|
ClientIP: 192.168.1.111
|
|
ClientPort: 18183
|
|
ABCHMigrated: 0
|
|
|
|
C: SYN 8 15 0
|
|
S: SYN 8 16 0 1 1
|
|
S: GTC A
|
|
S: BLP AL
|
|
S: PRP MFN example%20user
|
|
S: PRP PHH 123%20(4567)
|
|
S: LSG Other%20Contacts 0
|
|
S: LST N=anotheruser@hotmail.com F=another%20user 11 0
|
|
S: BPR PHH 1%20(222)%20333%204444
|
|
C: CHG 9 NLN
|
|
S: CHG 9 NLN
|
|
S: OUT MIG
|
|
```
|
|
Server disconnects client
|
|
|
|
Client opens a connection to 10.0.0.5:1863 (from stored server)
|
|
```
|
|
C: VER 10 MSNP10 MSNP9 CVR0
|
|
S: VER 10 MSNP10
|
|
C: CVR 11 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com
|
|
S: CVR 11 6.1.0211 6.1.0211 6.1.0155
|
|
.. http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe
|
|
.. http://messenger.msn.com
|
|
C: USR 12 TWN I example@hotmail.com
|
|
S: USR 12 TWN S passport=parameters,neat=huh,lc=1033,id=507
|
|
C: USR 13 TWN S $(pp14response.headers.authenticationInfo["from-PP"])
|
|
S: USR 13 OK example@hotmail.com 1 0
|
|
S: MSG Hotmail Hotmail 465
|
|
MIME-Version: 1.0
|
|
Content-Type: text/x-msmsgsprofile; charset=UTF-8
|
|
LoginTime: 1726321960
|
|
EmailEnabled: 1
|
|
MemberIdHigh: 1
|
|
MemberIdLow: 2
|
|
lang_preference: 1033
|
|
PreferredEmail: example@hotmail.com
|
|
country: US
|
|
PostalCode:
|
|
Gender:
|
|
Kid: 0
|
|
Age:
|
|
BDayPre:
|
|
Birthday:
|
|
Wallet:
|
|
Flags: 1027
|
|
sid: 507
|
|
kv: 11
|
|
MSPAuth: whatever+t+is+in+your+passport+login+ticket+that+you+sent+for+USR+TWN+S$
|
|
ClientIP: 192.168.1.111
|
|
ClientPort: 18183
|
|
ABCHMigrated: 1
|
|
|
|
C: SYN 14 0 0
|
|
S: SYN 14 2024-09-28T17:18:18.6400000-07:00 2024-09-28T17:18:18.6400000-07:00 1 1
|
|
S: GTC A
|
|
S: BLP AL
|
|
S: PRP MFN example%20user
|
|
S: PRP PHH 123%20(4567)
|
|
S: LSG Other%20Contacts d6deeacd-7849-4de4-93c5-d130915d0042
|
|
S: LST N=anotheruser@hotmail.com F=another%20user C=c1f9a363-4ee9-4a33-a434-b056a4c55b98 11 d6deeacd-7849-4de4-93c5-d130915d0042
|
|
S: BPR PHH 1%20(222)%20333%204444
|
|
C: CHG 15 NLN
|
|
S: CHG 15 NLN
|
|
C: OUT
|
|
```
|
|
Client disconnects from server
|
|
```
|
|
S: OUT
|
|
```
|
|
Server disconnects client
|