XML Web Service 從誕生就號稱改變一切,但五年多過去,它並未如當初宣傳的那般普及。原因不少:各家廠商堅持自己的 service 標準難以統一、既有穩定系統不願更動,還有兩個來自技術本身的問題——安全與效能。本文開始一系列討論,先談安全。
一是我得確定呼叫者是誰,也就是來源合法性;二是資料在傳輸途中不能被人側錄或竄改。當然還有別的隱患,日後再補充。要讀懂本文,你應該已經理解 XML Web Service 的運作原理,並實際開發部署過服務——只是還不確定自己部署的版本夠不夠安全。
本節示範最簡單的一種身份驗證:把使用者名稱與密碼附加在 SOAP 訊息標頭(SoapHeader)中,由伺服器端驗證。這種做法解決了「服務無法針對特定對象回應」的問題,但因為身分資訊仍以明文傳輸,無法有效防止側錄、竄改或偽造。若你已熟悉這招,可以直接跳到後續文章。
開啟 Visual Studio 2005,在起始頁點選「建立專案」,選擇 Visual C# 底下「ASP.NET Web 服務應用程式」,輸入專案名稱。
建立一個繼承 SoapHeader 的類別,把帳號與密碼包成兩個屬性:
using System.Web.Services.Protocols;
namespace WebService1
{
public class MySoapHeader : SoapHeader
{
private string _userName;
private string _pwd;
/// <summary>使用者名稱</summary>
public string UserName
{
get { return _userName; }
set { _userName = value; }
}
/// <summary>密碼</summary>
public string Pwd
{
get { return _pwd; }
set { _pwd = value; }
}
}
}
宣告一個 MySoapHeader 型別的公開欄位,再用 [SoapHeader] 特性把它綁到方法上。進入方法後先確認標頭存在,再比對帳密:
[WebService(Namespace = "https://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
[ToolboxItem(false)]
public class Service1 : System.Web.Services.WebService
{
public MySoapHeader header = new MySoapHeader();
[WebMethod]
[SoapHeader("header")]
public string HelloWorld()
{
if (header == null)
return "您沒有設置 SoapHeader,不能正常訪問此服務!";
if (header.UserName != "jillzhang" || header.Pwd != "123456")
return "您提供的身份驗證信息有誤,不能正常訪問此服務!";
return "Hello World";
}
}
這裡有兩個常被忽略的細節:一是 header == null 的判斷必須放在最前面,否則下一行取屬性會直接丟出 NullReferenceException;二是帳密比對條件要用 || 而非 &&——用 AND 的話,只要其中一項相符就能通過,等於沒有驗證。
加入服務參考後,代理類別會自動產生對應的 MySoapHeaderValue 屬性,只要設定它就能把標頭送出去:
localhost.Service1 ws = new localhost.Service1(); //ws.MySoapHeaderValue = new localhost.MySoapHeader(); //ws.MySoapHeaderValue.UserName = "jillzhang"; //ws.MySoapHeaderValue.Pwd = "123456"; Console.WriteLine(ws.HelloWorld());
把這三行註解打開,服務才會通過驗證;維持註解狀態則會收到錯誤訊息。
很多人不清楚為什麼這種寫法能生效,最快的答案是把 SOAP 訊息攔下來看。
未設定 SoapHeader 時,請求裡只有 Body:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="https://www.w3.org/2001/XMLSchema">
<soap:Body>
<HelloWorld xmlns="https://tempuri.org/" />
</soap:Body>
</soap:Envelope>
回應則是帶著驗證失敗的訊息:
<soap:Body>
<HelloWorldResponse xmlns="https://tempuri.org/">
<HelloWorldResult>您提供的身份驗證信息有誤,不能正常訪問此服務!</HelloWorldResult>
</HelloWorldResponse>
</soap:Body>
設定 SoapHeader 之後,請求多了一個 Header 節點:
<soap:Header>
<MySoapHeader xmlns="https://tempuri.org/">
<UserName>jillzhang</UserName>
<Pwd>123456</Pwd>
</MySoapHeader>
</soap:Header>
<soap:Body>
<HelloWorld xmlns="https://tempuri.org/" />
</soap:Body>
正是這個節點把資訊送進伺服器,服務端得以解析並處理,回應也變成 Hello World。
從訊息可以看得很清楚:帳號與密碼是明文傳輸的。這讓 SoapHeader 更像 HTTP 裡的 Cookie——可以參考 Cookie 的用法去擴充它,例如加入時間戳與簽章,但本質上的限制仍在。因此在安全要求不高的內部應用中,這個方案因為方便、靈活而值得採用;一旦服務暴露在不可信的網路上,就必須搭配傳輸層加密(HTTPS)或訊息層加密與簽章。下一節將說明如何攔取與檢視 SOAP 訊息,那是後續所有安全機制除錯的基礎。