前 言
MSN Messenger 是Microsoft开发的聊天工具,目前在国内拥有很大的用户群。使用MSN Messenger可以与他人进行文字聊天,语音对话,视频会议等即时交流,还可以通过此软件来查看联系人是否联机等。该软件的最新版本是6.1。
1999年,Microsoft向IETF提交了一份"MSN Messenger Service 1.0 Protocol"草案,这是最初版本的MSN Messenger协议。在以后几年,该公司不再公开有关MSN Messenger协议的升级、修改细节的官方文档。但无论是开发第三方的聊天客户端软件(如Gaim, MyIM等),还是做协议分析,必须对其通信协议有深入了解。正因为如此,有一些民间人士对这些协议开展了研究(见本文的"相关资源"一节)。
当我们还在感叹"这世界,变化快"的时候,MSN Messenger的协议已经到了第10版,简称MSNP10,对应于MSN Messenger 6.1。MSN Messenger 6.0则使用MSNP9。现在Microsoft强迫MSN Messenger用户升级到6.0或6.1版,因为服务器对MSNP8以下的版本不再支持。本文及后续文章所描述的MSN Messenger协议主要针对MSNP9/MSNP10。
1. 连 接
MSN Messenger协议建立在TCP/IP之上。除了文件传输和语音聊天是直接的"点对点"通信之外,其它所有的情形全部通过服务器进行。
在逻辑上,一共有三种类型的服务器,各司其职:
2. 命 令
MSN Messenger命令使用纯ASCII码。对非ASCII码字符使用URL编码。命令的语法是
XXX[<SP>TrID<SP>PARAM1<SP>PARAM2…]<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 | 身份验证失败 |
过去的MSN Messenger版本(MSNP8以下),简单地使用MD5等Hash算法对用户身份进行认证。MSNP9/MSNP10使用一种TWN(Tweener)认证方式,通过SSL/TLS连接到login.passport.com和loginnet.passport.com等服务器,借助于HTTP协议输入账号和密码,认证通过后,才能取得“入场券”。
真正意义上的身份认证,发生在客户端与通知服务器(NS)之间。客户端登陆NS时,首先交换版本信息。双方均支持MSNP8以上版本时,才能进行认证过程。如果客户端版本较低,不支持TWN,咋办?服务器会将你一脚揣出去,信不信?
好了,废话少说,现在拿一个成功认证的例子看看。在下面的例子中,账号是“example@passport.com”,密码是“password”。
VER 4 MSNP10 MSNP9 CVR0 \r\nVER 4 MSNP9 CVR0 \r\n
CVR 5 0x0804 winnt 5.0 i386 MSNMSGR 6.1.0203 MSMSGS example@passport.com \r\n
CVR 5 6.0.0602 6.0.0602 5.0.0527 http://download.microsoft.com/download/d/4/f/d4f560d5-6dc6-4901-b149-a568415561d7/SETUPNT.EXE http://messenger.msn.com/cn \r\n
USR 6 TWN I example@passport.com \r\n
USR 6 TWN Slc=1033,id=507,tw=40,fs=1,ru=http%3A%2F%2Fmessenger%2Emsn%2Ecom,ct=1073355862,kpp=1,kv=5,ver=2.1.0173.1, tpf=ed1c2f217a21c191c61251eb8b73bb60 \r\n
(此时通过SSL进行身份认证,获得“入场券”)
USR 7 TWN S t=4m1wWfEupDgUNb53qys5gJdw8OTJEtT82fcuDbS3U672gTymOOs6cgKeafj7WjgZNcufAQggxqHRRXko02DoflZA$$ &p=4QXNnX9rFDDgki9ZqvqPZGDGJa2Mrd5H13Zfl0NNjh4I78qPyfpzmkZPZEe0nxJTkzZSNDYtk!57cVqiYVfO86KgCRYWhi2kudS0M !7bdi82EDA1FYp3WboHD!sCQ17OZh7lPQI7fozrgsSMZwgSzRi2FNTPxf13oDNIfDCKCG!2guDvZKEpk78A$$ \r\n
USR 7 OK example@passport.com example@passport.com 1 0 \r\n
第一回合(TrID=4),双方协商MSN版本号。客户端说“我能支持MSNP9和MSNP10”,NS说“行,就MSNP9吧”。
第二回合(TrID=5),客户端报告本机信息:OS = Windows 2000 (NT 5.0), 语言 = 简体中文,MSN Messenger版本 = 6.1.0203, 账号 = example@passport.com。NS给出了推荐的版本号,能够使用的最老的版本号,新版本下载地址,官方网站地址等信息。
第三回合(TrID=6),客户端要求身份认证(I = Initial),NS则给出所需要的一长串信息(S = Subsequent)。其中tpf相当于challenge,参与Hash运算,能保证每次认证返回的串是不同的。
第四回合(TrID=7),客户端出示从认证服务器得到的“入场券”,NS放行(OK)。
第三、四回合之间,通过SSL的认证过程如下:
首先在HTTPS端口443向login.passport.com发送一个GET请求,将账号、密码和NS给定的一长串信息送出
GET /login2.srf HTTP/1.1 \r\nAuthorization: Passport1.4 OrgVerb=GET,OrgURL=http%3A%2F%2Fmessenger%2Emsn%2Ecom,sign-in=example%40passport.com,pwd=password, lc=1033,id=507,tw=40,fs=1,ru=http%3A%2F%2Fmessenger%2Emsn%2Ecom,ct=1073355862,kpp=1,kv=5,ver=2.1.0173.1, tpf=ed1c2f217a21c191c61251eb8b73bb60 \r\n
Host: login.passport.com \r\n \r\n
根据情况,会重定向到不同的URL。本例中,重定向到"https://loginnet.passport.com/login2.srf?lc=1033",服务器应答
HTTP/1.1 302 Found \r\n Server: Microsoft-IIS/5.0 \r\nDate: Mon, 22 Dec 2003 21:10:05 GMT \r\n
PPServer: H: LAWPPLOG5C006 \r\n
Connection: close \r\n
Content-Type: text/html \r\n
Expires: Mon, 22 Jun 2003 21:09:05 GMT \r\n
Cache-Control: no-cache \r\n
cachecontrol: no-store \r\n Pragma: no-cache \r\n
P3P: CP="DSP CUR OTPi IND OTRi ONL FIN" \r\n
Authentication-Info: Passport1.4 da-status=redir \r\n
Location: https://loginnet.passport.com/login2.srf?lc=1033 \r\n
\r\n ... ...
然后,重新向指定的URL发出请求,得到如下响应
HTTP/1.1 200 OK \r\n
Server: Microsoft-IIS/5.0 \r\n
Date: Mon, 22 Dec 2003 21:10:07 GMT \r\n
PPServer: H: LAWPPIIS6B061 \r\n
Connection: close \r\n Content-Type: text/html \r\n
Expires: Mon, 22 Dec 2003 21:09:07 GMT \r\n
Cache-Control: no-cache \r\n
cachecontrol: no-store \r\n
Pragma: no-cache \r\n
P3P: CP="DSP CUR OTPi IND OTRi ONL FIN" \r\n
Set-Cookie: ... ... \r\n
Authentication-Info: Passport1.4 da-status=success,tname=MSPAuth,tname=MSPProf,tname=MSPSec, from-PP='t=4m1wWfEupDgUNb53qys5gJdw8OTJEtT82fcuDbS3U672gTymOOs6cgKeafj7WjgZNcufAQggxqHRRXko02DoflZA$$ &p=4QXNnX9rFDDgki9ZqvqPZGDGJa2Mrd5H13Zfl0NNjh4I78qPyfpzmkZPZEe0nxJTkzZSNDYtk!57cVqiYVfO86KgCRYWhi2kudS0M !7bdi82EDA1FYp3WboHD!sCQ17OZh7lPQI7fozrgsSMZwgSzRi2FNTPxf13oDNIfDCKCG!2guDvZKEpk78A$$', ru=http://messenger.msn.com \r\n
Content-Length: 0 \r\n
\r\n
开始时直接向loginnet.passport.com发出正确的请求,也是可以的。不难看出,在服务器认证成功的返回信息中,Authentication-Info字段的from-PP串值,就是所谓的“入场券”。
如果认证失败,服务器返回401错误
HTTP/1.1 401 Unauthorized \r\n ... ...这样,就无法拿到“入场券”,自然不能在第四回合中输入合法的串。