MSN Messenger 协议（MSN协议集合）

MSNP9协议分析报告
1. 连 接

MSN Messenger协议建立在TCP/IP之上。除了文件传输和语音聊天是直接的"点对点"通信之外，其它所有的情形全部通过服务器进行。

在逻辑上，一共有三种类型的服务器，各司其职：

派遣服务器(Dispatch Server, DS) - 客户端最初连接的服务器。负责给客户端分配合适的通知服务器。域名是messenger.hotmail.com，标准服务端口是1863。完成派遣任务后，切断TCP连接。
通知服务器(Notification Server, NS) - 客户端需要一直保持连接的服务器。很多任务要在这个会话内完成，包括登录、改变状态、获取用户列表、修改用户信息、发起聊天、接受呼叫、邮件通知、退出等等。服务端口由派遣服务器指定，通常也是1863。
接线服务器(Switchboard Server, SS) - 客户端之间聊天使用的中转服务器。每开一个聊天窗口，客户端和服务器就建立一个TCP会话。当客户端之间需要进行文件传输或语音聊天时，发送系统消息，建立"点对点"会话通道(可能转为使用UDP)。服务端口通常也是1863。"点对点" 通信使用的端口由客户端自动协商决定，如文件传输通常使用6891端口。
2. 命 令

MSN Messenger命令使用纯ASCII码。对非ASCII码字符使用URL编码。命令的语法是

XXX[<SP>TrID<SP&gtARAM1<SP&gtARAM2…]<CRLF>
其中，<SP>是空白字符，<CRLF>是回车换行，XXX是一个3字符的命令串，TrID是一个流水号，PARAMx是参数，[ ]内是可选项。最简单的命令没有流水号和参数。为了方便起见，下面讨论时用" "代表<SP>，"/r/n"代表<CRLF>，"/x??"代表一个值为0x??字节。红色表示由客户端发出，蓝色表示由服务器发出。一个MSN Messenger命令的例子如下：

USR 18 TWN I example@hotmail.com/r/n
3. 错 误

无论是由于客户端发出的命令无效，参数无效，还是其他什么原因，服务器可以返回一个错误。格式为

XXX[<SP>TrID]<CRLF>
其中，XXX是一个3位数字的串。如

ADD 21 AL non_existent@passport.com non_existent@passport.com/r/n
205 21/r/n
上例中，non_existent@passport.com是一个不存在的账号。

4. 消 息

MSN Messenger消息符合MIME 1.0标准，由消息头与消息体组成。通常使用UTF-8编码，消息头中也需要URL编码格式，消息体则直接用二进制数据。

一个MSN Messenger消息的例子如下：

MIME-Version: 1.0/r/n
Content-Type: text/plain; charset=UTF-8/r/n
X-MMS-IM-Format: FN=%E5%AE%8B%E4%BD%93; EF=; CO=0; CS=86; PF=0/r/n
/r/n
bhw98/xE4/xBD/xA0/xE5/xA5/xBD/xEF/xBC/x81
经简单分析可知，"%E5%AE%8B%E4%BD%93"是"宋体"的UTF-8加URL编码，而"bhw98/xE4/xBD/xA0/xE5/xA5/xBD/xEF/xBC/x81"是"bhw98你好！"的UTF-8编码。

命令一览
命令  来源  去向  说明  备注
ACK  SS  Client  确认，做出肯定回答。  acknowledgement
ADD  Client  NS  发出添加新联系人到列表的请求。  add user
NS  Client  返回添加新联系人请求的应答。
ADG  Client  NS  发出添加新联系人组请求。  add group
NS  Client  返回添加新联系人组请求的应答。
ANS  Client  SS  接受聊天连接请求。  answer
BLP  Client  NS  设置对尚未列入明确允许/禁止的联系人列表的保密策略。  block list privacy
NS  Client  返回设置保密策略请求的应答。
BYE  SS  Client  通知客户端结束会话。  bye
CAL  Client  SS  发出建立聊天连接的请求。  call
SS  Client  返回建立聊天连接请求的应答。
CHG  Client  NS  发出改变状态的请求。  change state
NS  Client  返回改变状态的应答。
CHL  NS  Client  服务器发出验证要求。  challenge
SS  Client
CVR  Client  NS  发出客户端的OS、语言、MSN Messenger版本等信息。  client version
Client  SS
NS  Client  返回推荐的MSN Messenger版本、升级软件需要的下载地址等信息。
SS  Client
FLN  NS  Client  通知有联系人列表中的用户下线。  off-line
GTC  Client  NS  设置当有联系人列表中的用户状态改变时给出的提示。  greeting to changes?
NS  Client  返回设置请求的应答。
INF  Client  NS  询问服务器所支持的认证方式。  information?
Client  SS
NS  Client  返回服务器所支持的认证方式。
SS  Client
ILN  NS  Client  当客户端登录或添加联系人到列表时，通知列表中的联系人的状态。  initial online state
IRO  SS  Client  当有新用户加入聊天连接时，通知客户端该连接中的用户名单。  initial roster information
JIO  SS  Client  通知客户端已经同另外的用户建立了聊天连接。  jion
LSG  Client  NS  发出获取联系人组列表的请求。  list groups
NS  Client  返回获取联系人组列表请求的应答。
LST  Client  NS  发出获取联系人列表的请求。  list
NS  Client  返回获取联系人列表请求的应答。
MSG  Client  SS  发送消息到其他用户(聊天对象)。  message
NS  Client  传递服务器(系统) 的消息到客户端。
SS  Client  传递其他用户(聊天对象)的消息到客户端。
NAK  SS  Client  做出否定回答。  negative acknowledgement
NLN  NS  Client  通知客户端联系人上线或改变状态。  on-line
OUT  All  All  结束客户端-服务器的连接。  out
PNG  Client  NS  测试TCP连接状态。  ping
Client  SS
PRP  Client  NS  发出设置个人电话号码的请求。  personal phone number
NS  Client  返回设置请求的应答
PNG  Client  NS  测试TCP连接状态。  ping
Client  SS
QNG  NS  Client  返回测试TCP连接状态的应答。  quiz ping?
SS  Client
QRY  Client  NS  客户端回答服务器的验证要求。  quiz reply?
Client  SS
REA  Client  NS  发出修改用户昵称的请求。  rename nickname
NS  Client  返回修改用户昵称请求的应答。
REG  Client  NS  发出修改联系人组的请求。  rename group
NS  Client  返回修改联系人组请求的应答。
REM  Client  NS  发出从联系人列表中删除用户的请求。  rename user
NS  Client  返回删除用户请求的应答。
RMG  Client  NS  发出删除联系人组的请求。  remove group
NS  Client  返回删除联系人组请求的应答。
RNG  NS  Client  通知客户端有人要建立聊天连接。  ring
SYN  Client  NS  客户端-服务器同步。  synchronization
NS  Client
URL  Client  NS  发出获取MSN服务URL的请求。  URL
NS  Client  返回获取URL请求的应答。
USR  All  All  声明、传递、鉴别用户身份。  user
VER  Client  DS  协商MSN Messenger协议版本。  version
Client  NS
DS  Client
NS  Client
XFR  DS  Client  向客户端分配NS（通知客户端转向连接指定的NS）。  transfer
Client  NS  发出分配SS的请求。
NS  Client  返回分配SS请求的应答。

MSN Messenger协议--错误代码一览
代码  含义  可能的命令  错误示例  备注
200  非法命令     ABC 18/r/n
200 18/r/n    
201  非法参数     CHG 19 FLN 0/r/n
201 19/r/n
ADD 20 AL aaa@bbb@ccc aaa@bbb@ccc/r/n
201 20/r/n    
205  用户不存在  ADD  ADD 21 AL none@hotmail.com none@hotmail.com/r/n
205 21/r/n    
206  缺少域名     
207  已经登录  USR  USR 20 TWN I example@hotmail.com/r/n
207 20/r/n
USR 21 TWN S 8d30fc782aa25ec9e1293fdda13cab42/r/n
207 21/r/n    
208  非法用户名  CAL  CAL 2 @@hotmail.com/r/n
208 2/r/n    
209  非法用户昵称  REA  REA 18 one@hotmail.com kill%20microsoft/r/n
209 18/r/n    
210  用户太多  ADD  ADD 23 FL one@hotmail.com one@hotmail.com 0/r/n
210 23/r/n  最大150
215  用户已在列表中  ADD  ADD 36 FL one@hotmail.com one@hotmail.com 2/r/n
ADD 36 825 FL one@hotmail.com one@hotmail.com 2/r/n
ADD 37 FL one@hotmail.com one@hotmail.com 2/r/n
215 37/r/n  
CAL  CAL 5 two@hotmail.com/r/n
CAL 5 RINGING 213697/r/n
CAL 6 two@hotmail.com/r/n
215 6/r/n
216  用户不在列表中  REM  REM 14 FL three@hotmail.com/r/n
216 14/r/n  
REA  REA 48 three@hotmail.com three/r/n
216 48/r/n
CAL  CAL 2 three@hotmail.com/r/n
216 2/r/n
217  用户不在线  CAL  CAL 2 two@hotmail.com/r/n
217 2/r/n  
218  已在指定模式  BLP  BLP 17 BL/r/n
BLP 17 151 BL/r/n
BLP 18 BL/r/n
218 18/r/n  
GTC  GTC 19 A/r/n
GTC 19 152 A/r/n
GTC 20 A/r/n
218 20/r/n
219  用户已经在相反的列表中  ADD  ADD 15 AL four@hotmail.com four@hotmail.com/r/n
ADD 15 AL 56 four@hotmail.com four/r/n
ADD 16 BL four@hotmail.com four@hotmail.com/r/n
219 16/r/n  
223  用户组太多  ADG  ADG 28 new%20group 0/r/n
223 28/r/n  最大30
224  非法组号  ADD  RMG 24 3/r/n
RMG 24 11506 3/r/n
ADD 25 FL five@hotmail.com 3/r/n
224 25/r/n  
REM  RMG 24 3/r/n
RMG 24 11506 3/r/n
REM 25 FL five@hotmail.com 3/r/n
224 25/r/n
REG  RMG 24 3/r/n
RMG 24 11506 3/r/n
REG 25 3 New%20Name 0/r/n
224 25/r/n
RMG  RMG 24 3/r/n
RMG 24 11506 3/r/n
RMG 25 3/r/n
224 25/r/n
225  用户不在组中  REM  REM 26 FL six@hotmail.com 3/r/n
225 26/r/n  
229  组名太长  ADG  ADG 27 ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789 0/r/n
229 27/r/n  最大60
230  不能删除组0  RMG  RMG 28 0/r/n
230 28/r/n  
300 缺少必要的参数       
302  尚未登录       
500 服务器内部错误       
540 验证应答错误       
600 服务器忙       
707 无法建立连接       
910 服务器忙       
911 身份验证失败