Portal協(xié)議分析

1、文檔可自由編輯打印AC、Portal 與 AAA交互協(xié)議分析文檔可自由編輯打印上海寰創(chuàng)通信科技有限公司文檔可自由編輯打印文檔更新記錄文檔更新記錄日期更新人版本備注2009-2-13齊霄鵬2009-2-16齊霄鵬文檔可自由編輯打印目錄目錄1PORTAL 協(xié)議協(xié)議概述協(xié)議協(xié)議概述 .52PORTAL 協(xié)議報(bào)文格式協(xié)議報(bào)文格式 .53PORTAL 協(xié)議報(bào)文字段說明協(xié)議報(bào)文字段說明 .54與與 PORTAL 交互中報(bào)文填充說明交互中報(bào)文填充說明 .64.1REQ_CHALLENGE.64.2ACK_CHALLENGE.74.3REQ_AUTH.84.4ACK_AUTH.84.5AFF_ACK_AUTH

2、.95與與 3A 相關(guān)的交互中報(bào)文填充說明相關(guān)的交互中報(bào)文填充說明.105.1ACCESS_REQUEST.105.2ACCOUNTING-REQUEST/START.105.3ACCOUNTING-REQUEST/INTERIM-UPDATE.115.4ACCOUNTING-REQUEST/STOP.116HTTP REQUEST PORTAL-URL.11文檔可自由編輯打印1Portal 協(xié)議協(xié)議概述協(xié)議協(xié)議概述AC 與 Portal Server 之間通過 Portal 協(xié)議交互。2Portal 協(xié)議報(bào)文格式協(xié)議報(bào)文格式VerTypePap/ChapRsvSerialNoReqID012

3、3468UserIPUserPortErrCodeAttrNum57Attr .3Portal 協(xié)議報(bào)文字段說明協(xié)議報(bào)文字段說明VerVer 字段是協(xié)議的版本號(hào)，長度為 1 字節(jié)，目前定義的值為 0 x01。TypeType 字段定義報(bào)文的類型，長度為 1 字節(jié)。Pap/ChapPap/Chap 字段定義此用戶的認(rèn)證方式，長度為 1 字節(jié)，只對(duì) Type 值為 0 x03 的認(rèn)證請(qǐng)求報(bào)文有意義：chap 方式認(rèn)證（0 x00） 、Pap 方式認(rèn)證（0 x01） 。RsvRsv 目前是保留字段，長度為 1 字節(jié)，在所有報(bào)文中值為 0。SerialNoSerialNo 字段是報(bào)文的序列號(hào)，長度為

4、2 字節(jié)，由 Portal Server 隨機(jī)生成；由Portal Server 發(fā)給 AC 的報(bào)文；每一個(gè)由 AC 設(shè)備發(fā)給 Portal Server 的響應(yīng)報(bào)文的SerialNo 必須和 Portal Server 發(fā)送的相應(yīng)請(qǐng)求報(bào)文的 SerialNo 一樣。ReqIDReqID 字段長度 2 個(gè)字節(jié)，AC 隨機(jī)生成。UserIPUserIP 字段為 Portal 用戶的 IP 地址，長度是 4 字節(jié)，由 Portal Server 根據(jù)獲得的IP 地址填寫，必填項(xiàng)。UserPortUserPort 字段目前沒有用到，長度為 2 字節(jié)，在所有報(bào)文中其值為 0。ErrCodeErrCod

5、e 字段和 Type 字段一起表示一定的意義，長度為 1 字節(jié)。AttrNumAttrNum 字段表示其后便可變長度的屬性字段屬性的個(gè)數(shù)，長度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性） ，其值在所有的報(bào)文中都要根據(jù)具體情況賦值。Attr文檔可自由編輯打印Attr 字段（屬性字段）是一個(gè)可變長字段，由多個(gè)屬性依次鏈接而成，每個(gè)屬性的格式為 TLV，如圖：AttrTypeAttrLenAttrValue.012屬性字段中每個(gè)屬性說明如下：（1）屬性類型（AttrType）Attr(屬性字段)AttrType屬性值長度屬性含義UserName0 x01=253 （可變） 隨e行用戶名，具體為：

6、“用戶手機(jī)號(hào)碼”；全國/省內(nèi)預(yù)付費(fèi)卡用戶名稱：13位數(shù)字；為滿足國際漫游的需要，支持253字節(jié)的長用戶名。PassWord0 x02=16（可變）用戶提交的明文密碼Challenge0 x0316（固定） Chap方式加密的魔術(shù)字ChapPassWord0 x0416（固定）經(jīng)過Chap方式加密后的密碼（2）屬性長度（AttrLen）AttrLen 字段表示屬性的長度，長度為 1 字節(jié)，其值是整個(gè)屬性三個(gè)字段AttrType、AttrLen、AttrValue 的長度之和。（3）屬性值（AttrValue）AttrValue 的值為具體的屬性值，比如用戶名、口令等，長度有些可變，有些固定，但最

7、長不超過 253（255-2）字節(jié)4與與 Portal 交互中報(bào)文填充說明交互中報(bào)文填充說明4.1REQ_CHALLENGE序號(hào)序號(hào)參數(shù)名稱參數(shù)名稱長度（字節(jié)）長度（字節(jié)）值值說明說明1Ver10 x01協(xié)議版本號(hào)2Type10 x01報(bào)文類型3Pap/Chap1無意義定義用戶的認(rèn)證方式4Rsv10保留字段5SerialNo2隨機(jī)報(bào)文的序列號(hào)，Portal Server 隨機(jī)生成，同一個(gè)認(rèn)證流程中所有報(bào)文的 SerialNo 相同6ReqID20該字段無意義7UserIP4IP由 Portal Server 根據(jù)獲得的 IP地址填寫，必填8UserPort20保留字段9ErrCode10該字段

8、無意義10AttrNum10其后便可變長度的屬性字段屬性的個(gè)數(shù)，長度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）文檔可自由編輯打印4.2ACK_CHALLENGE序號(hào)序號(hào)參數(shù)名稱參數(shù)名稱長度（字節(jié)）長度（字節(jié)）值值說明說明1Ver10 x01協(xié)議版本號(hào)2Type10 x02報(bào)文類型3Pap/Chap1無意義定義用戶的認(rèn)證方式4Rsv10保留字段5SerialNo2同 4.1 中的SerialNo相同報(bào)文的序列號(hào)，與 Type 字段的值等于 0 x01 的報(bào)文相同6ReqID2Chap方式：隨機(jī)Pap方式：無意義，0Chap 方式：AC 隨機(jī)生成，AC設(shè)備的請(qǐng)求 Challenge 響應(yīng)報(bào)文

9、中把該 ReqID 的值告訴Portal Server7UserIP4IP由 Portal Server 根據(jù)獲得的IP 地址填寫，必填8UserPort20保留字段9ErrCode10:請(qǐng)求challenge成功1:請(qǐng)求challenge拒絕2:鏈接已建立3:有一個(gè)用戶在認(rèn)證4:請(qǐng)求challenge失敗與 Type 字段一起表示一定的意義，AC 設(shè)備通知 Portal Server10AttrNum11其后可變長度的屬性字段屬性的個(gè)數(shù)，長度為 1 字節(jié)（表示最多可有 255 個(gè)屬性）11AttrType10 x03屬性類型（Challege）12AttrLenth118整個(gè)屬性三個(gè)字段At

10、trType、AttrLen、AttrVal文檔可自由編輯打印ue 的長度之和13AttrValue16具體的屬性值，Chap 方式加密的魔術(shù)字4.3REQ_AUTH序號(hào)序號(hào)參數(shù)名稱參數(shù)名稱長度（字節(jié)）長度（字節(jié)）值值說明說明1Ver10 x01協(xié)議版本號(hào)2Type10 x03報(bào)文類型3Pap/Chap1Chap:0 x00Pap:0 x01定義用戶的認(rèn)證方式4Rsv10保留字段5SerialNo2隨機(jī)報(bào)文的序列號(hào)，Portal Server 隨機(jī)生成6ReqID2Chap方式：和Type值為2 的報(bào)文中此字段的值相同Pap方式：無意義，07UserIP4IP由 Portal Server 根

11、據(jù)獲得的IP 地址填寫，必填8UserPort20保留字段9ErrCode10字段無意義10AttrNum13其后便可變長度的屬性字段屬性的個(gè)數(shù)，長度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）11AttrType10 x01屬性字段類型（UserName）12AttrLenth1=255屬性長度13AttrValue=253隨 e 行用戶名14AttrType10 x02屬性字段類型（PassWord）15AttrLenth1=18屬性長度16AttrValue=16用戶提交的明文密碼17AttrType10 x03屬性字段類型（Challenge）18AttrLenth118屬性長度1

12、9AttrValue16Chap 方式加密的魔術(shù)字文檔可自由編輯打印4.4ACK_AUTH序號(hào)序號(hào)參數(shù)名稱參數(shù)名稱長度（字節(jié)）長度（字節(jié)）值值說明說明1Ver10 x01協(xié)議版本號(hào)2Type10 x04報(bào)文類型3Pap/Chap1無意義定義用戶的認(rèn)證方式4Rsv10保留字段5SerialNo2同 4.3 中的SerialNo相同報(bào)文的序列號(hào)，與 Type 字段的值等于 0 x03 的報(bào)文相同6ReqID2Chap方式：和Type值為2 的報(bào)文中此字段的值相同Pap方式：無意義，07UserIP4IP由 Portal Server 根據(jù)獲得的IP 地址填寫，必填8UserPort20保留字段9E

13、rrCode10：用戶認(rèn)證成功1：用戶認(rèn)證請(qǐng)求被拒絕3：有一個(gè)用戶在認(rèn)證，青售后再試4：此用戶認(rèn)證失敗與 Type 字段一起表示一定的意義，AC 設(shè)備通知 Portal Server10AttrNum10其后便可變長度的屬性字段屬性的個(gè)數(shù)，長度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）4.5AFF_ACK_AUTH序號(hào)序號(hào)參數(shù)名稱參數(shù)名稱長度（字節(jié)）長度（字節(jié)）值值說明說明文檔可自由編輯打印1Ver10 x01協(xié)議版本號(hào)2Type10 x07報(bào)文類型3Pap/Chap1無意義定義用戶的認(rèn)證方式4Rsv10保留字段5SerialNo2同 4.3 中的SerialNo相同由 Portal S

14、erver 向 AC 設(shè)備發(fā)出的認(rèn)證成功確認(rèn)報(bào)文，與Type 字段的值等于 0 x03 的報(bào)文相同6ReqID2Chap方式：和Type值為2 的報(bào)文中此字段的值相同Pap方式：無意義，07UserIP4IP由 Portal Server 根據(jù)獲得的IP 地址填寫，必填8UserPort20保留字段9ErrCode10字段無意義10AttrNum10其后便可變長度的屬性字段屬性的個(gè)數(shù)，長度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）5與與 3A 相關(guān)的交互中報(bào)文填充說明相關(guān)的交互中報(bào)文填充說明5.1Access_Request序號(hào)序號(hào)參數(shù)名稱參數(shù)名稱長度（字節(jié)）長度（字節(jié)） 值（十進(jìn)制）值

15、（十進(jìn)制）說明說明1AttrNum13其后便可變長度的屬性字段屬性的個(gè)數(shù)，長度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）2AttrType11屬性字段類型（UserName）3AttrLenth1=255屬性長度4AttrValue=253用戶名5AttrType12屬性字段類型（PassWord）6AttrLenth118=.=130屬性長度7AttrValue=1616=.=7屬性長度10AttrValue165=.=247Chap 方式加密的魔術(shù)字文檔可自由編輯打印5.2Accounting-Request/Start序號(hào)序號(hào)參數(shù)名稱參數(shù)名稱長度（字節(jié)）長度（字節(jié)） 值（十進(jìn)制）值

16、（十進(jìn)制）說明說明1AttrNum11其后便可變長度的屬性字段屬性的個(gè)數(shù)，長度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）2AttrType11屬性字段類型（UserName）3AttrLenth1=255屬性長度4AttrValue=253用戶名5.3Accounting-Request/Interim-Update序號(hào)序號(hào)參數(shù)名稱參數(shù)名稱長度（字節(jié)）長度（字節(jié)） 值（十進(jìn)制）值（十進(jìn)制）說明說明1AttrNum11其后便可變長度的屬性字段屬性的個(gè)數(shù)，長度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）2AttrType11屬性字段類型（UserName）3AttrLenth1=255屬

17、性長度4AttrValue=253用戶名5.4Accounting-Request/Stop序號(hào)序號(hào)參數(shù)名稱參數(shù)名稱長度（字節(jié)）長度（字節(jié)） 值（十進(jìn)制）值（十進(jìn)制）說明說明1AttrNum11其后便可變長度的屬性字段屬性的個(gè)數(shù)，長度為 1 字節(jié)（表示屬性最多可有 255 個(gè)屬性）2AttrType11屬性字段類型（UserName）3AttrLenth1=255屬性長度4AttrValue=253用戶名6HTTP Request portal-urlHTTP Request portal-url（實(shí)現(xiàn)強(qiáng)制 PORTAL 功能）的相關(guān)參數(shù)當(dāng) AC 實(shí)現(xiàn)強(qiáng)制 Portal 功能時(shí)，要求強(qiáng)制 Po

18、rtal 中包含一下參數(shù)：參數(shù)名稱參數(shù)名稱參數(shù)取參數(shù)取值值參數(shù)說明參數(shù)說明認(rèn)證認(rèn)證模式模式作用階段作用階段舉例舉例wlanuserip十進(jìn)制的字符串格式網(wǎng)段在前，主機(jī)在后WLAN用戶的私網(wǎng)地址，是認(rèn)證Portal與AC之間判別WLAN用戶的身份識(shí)別碼WEB重定向認(rèn)證頁面請(qǐng)求時(shí)wlanuserip=4wlanacname十進(jìn)制的字符串格式wlanacname=ACN. .CTY. .PRO. .OPE，屬性名為嚴(yán)重定向認(rèn)證頁面請(qǐng)求時(shí)wlanacip= ACN. .CTY. .文檔可自由編輯打印參數(shù)名稱參數(shù)名稱參數(shù)取參數(shù)取值值參數(shù)說明參數(shù)說明認(rèn)證認(rèn)證模式模式作用階段作用階段舉例舉例格小寫，屬性值為按照下列規(guī)定的AC名稱。統(tǒng)一規(guī)定全國AC的編碼，其編碼規(guī)