服務身分識別和驗證
服務的「端點身分識別」(Endpoint Identity) 是由 Web 服務描述語言 (WSDL) 服務所產生的值。這個值會傳播至任何用戶端上,用來驗證服務。在用戶端初始化對某個端點的通訊,且服務也向用戶端進行自我驗證之後,用戶端就會比較端點身分識別值與端點驗證處理序傳回的實際值。如果兩者相符,則可確定用戶端已聯繫所需的服務端點。這項功能可以防範「網路釣魚」(Phishing),因為它會防止用戶端重新導向至由惡意服務所裝載的端點。
如需示範身分識別設定的範例應用程式,請參閱服務身分識別範例。如需詳細資訊端點與端點位址的詳細資訊,請參閱端點位址。
注意: |
---|
當您使用 NT LanMan (NTLM) 進行驗證時,因為用戶端在 NTLM 協定下無法驗證伺服器,所以不會檢查服務身分識別。當電腦是 Windows 工作群組的一部分,或者執行的是不支援 Kerberos 驗證的舊版 Windows 時,就會使用 NTLM。 |
當用戶端初始化安全通道以透過其傳送訊息至服務時,Windows Communication Foundation (WCF) 基礎結構會驗證服務,而且如果服務身分識別符合用戶端所使用之端點位址中指定的身分識別時,這個基礎結構只會傳送訊息。
身分識別處理包含下列階段:
在設計階段,用戶端開發人員會從端點的中繼資料 (透過 WSDL 公開) 來決定服務的身分識別。
在執行階段,用戶端應用程式會先檢查服務安全性認證的宣告,再將訊息傳送至服務。
用戶端上的身分識別處理與服務上的用戶端驗證很類似。安全服務會等到用戶端認證經過驗證之後,才會執行程式碼。同理,用戶端會等到服務認證根據事先從服務中繼資料得知的內容經過驗證之後,才會將訊息傳送至服務。
EndpointAddress 類別的 Identity 屬性代表用戶端所呼叫之服務的身分識別。服務會在其中繼資料內發行 Identity。當用戶端開發人員針對服務端點執行 ServiceModel 中繼資料公用程式工具 (Svcutil.exe) 時,產生的組態會包含服務的 Identity 屬性值。WCF 基礎結構 (如果使用安全性來設定) 會確認服務是否具有指定的身分識別。
注意: |
---|
中繼資料包含所需的服務識別,因此建議您透過安全方式來公開服務中繼資料,例如為服務建立 HTTPS 端點。如需詳細資訊,請參閱 How to: Secure Metadata Endpoints. |
識別類型
服務可以提供五種識別類型,每種身分識別類型都會對應至可包含在組態 <identity> 項目中的某個項目。所使用的類型會隨情況和服務的安全性需求而有所不同,下表說明每種身分識別類型。
身分識別類型 | 描述 | 典型案例 |
---|---|---|
網域名稱系統 (DNS) |
您可以使用此項目來搭配 X.509 憑證或 Windows 帳戶,它會比較認證中指定的 DNS 名稱與此項目中指定的值。 |
DNS 檢查可讓您使用包含 DNS 或主體名稱的憑證。如果重新發行的憑證包含相同的 DNS 或主體名稱,則身分識別檢查仍舊有效。重新發行憑證時,憑證會取得新的 RSA 金鑰,但會保留相同的 DNS 或主體名稱,表示用戶端不需要更新與服務相關的用戶端身分識別資訊。 |
憑證:當 ClientCredentialType 設為 Certificate 時的預設值。 |
此項目會指定 Base64 編碼格式的 X.509 憑證值,以便與用戶端進行比較。 如果您使用 CardSpace 做為驗證服務的認證,也要使用此項目。 |
此項目會根據憑證的指紋值將驗證限制為單一憑證,因為指紋值是唯一的,所以這麼做可以讓驗證更加嚴格,同時也要特別注意,如果重新發行的憑證具有相同的主體名稱,也會具有新的指紋。因此,用戶端必須先知道新的指紋,才能驗證服務。如需詳細資訊尋找憑證指紋的詳細資訊,請參閱 HOW TO:擷取憑證的指紋。 |
憑證參考 |
與先前所述之「憑證」選項相同。但是,這個項目可讓您指定憑證名稱與存放區位置,以便從中擷取憑證。 |
與先前所述之「憑證」案例相同。 好處是憑證存放區位置可以變更。 |
RSA |
此項目會指定 RSA 金鑰值,以便與用戶端進行比較。此選項與憑證選項很類似,但不是使用憑證的指紋,而是改為使用憑證的 RSA 金鑰。 |
RSA 檢查可讓您根據憑證的 RSA 金鑰將驗證限制為單一憑證,雖然這個做法可以更嚴格地驗證 RSA 金鑰,但是如果 RSA 金鑰值改變,服務就再也無法與現有的用戶端一起使用。 |
使用者主要名稱 (UPN)。當 ClientCredentialType 設為 Windows,且服務處理序不是以其中一個系統帳戶執行時的預設值。 |
此項目會指定用來執行服務的 UPN。請參閱覆寫服務的身分識別以進行驗證的<Kerberos 通訊協定與身分識別>一節。 |
這樣可確保服務在特定 Windows 使用者帳戶底下執行。使用者帳戶可以是目前登入的使用者或是在特定使用者帳戶底下執行的服務。 如果服務是在 Active Directory 環境中的網域帳戶底下執行,此設定便能充分善用 Windows Kerberos 安全性的優勢。 |
服務主要名稱 (SPN)。當 ClientCredentialType 設為 Windows,且服務處理序在 LocalService、LocalSystem 或 NetworkService 系統帳戶底下執行時的預設值。 |
此項目會指定與服務帳戶關聯的 SPN。請參閱覆寫服務的身分識別以進行驗證的<Kerberos 通訊協定與身分識別>一節。 |
這樣可確保 SPN 及與其關聯之特定 Windows 帳戶都能識別服務。 您可以使用 Setspn.exe 工具讓電腦帳戶與服務的使用者帳戶產生關聯。 如果服務是在其中一個系統帳戶或具有相關 SPN 名稱的網域帳戶底下執行,而且電腦是 Active Directory 環境中的網域成員時,此設定便能充分善用 Windows Kerberos 安全性的優勢。 |
指定服務端的身分識別
一般來說,您不需要設定服務端的身分識別,因為選擇的用戶端認證類型會指定服務中繼資料中公開的身分識別類型。如需詳細資訊如何覆寫或指定服務身分識別的詳細資訊,請參閱覆寫服務的身分識別以進行驗證。
在組態中使用 <identity> 項目
如果您在先前對 Certificate 顯示的繫結中變更用戶端認證類型,則產生的 WSDL 會包含 Base64 序列化 X.509 憑證做為身分識別值,如下列程式碼所示。這是 Windows 以外所有用戶端認證類型的預設值。
<Identity xmlns="https://schemas.xmlsoap.org/ws/2006/02/addressingidentity">
<KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">
<X509Data>
<X509Certificate>MIIBxjCCAXSgAwIBAgIQmXJgyu9tro1M98GifjtuoDAJBgUrDgMCHQUAMBYxFDASBgNVBAMTC1Jvb3QgQWdlbmN5MB4XDTA2MDUxNzIxNDQyNVoXDTM5MTIzMTIzNTk1OVowKTEQMA4GA1UEChMHQ29udG9zbzEVMBMGA1UEAxMMaWRlbnRpdHkuY29tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDBmivcb8hYbh11hqVoDuB7zmJ2y230f/b4e+4P6yXtKKuhUdYcIqc8mAforIM4WWJEVGeJVq9sFEwqrL5Ryid8jMTRwPLvA/x/wvj1gtD1GWJ+aUh2pqieiGL7MWTepHAQBIibUxgOrAOz0j9Xhg0iDFYScdYUjeqI3yZIDC7WbwIDAQABo0swSTBHBgNVHQEEQDA+gBAS5AktBh0dTwCNYSHcFmRjoRgwFjEUMBIGA1UEAxMLUm9vdCBBZ2VuY3mCEAY3bACqAGSKEc+41KpcNfQwCQYFKw4DAh0FAANBADB/J2QjdSPL8Doj3pAveCXd/5fY03eo9kUym/Tmb4ubdqsObri0qnYR/n8Wxsa1yJ4Dks6cNBTPS4l5B7zUeNo=</X509Certificate>
</X509Data>
</KeyInfo>
</Identity>
您可以使用組態中的 <identity> 項目或在程式碼中設定身分識別,變更預設服務身分識別的值或變更身分識別的類型。下列組態程式碼會以 contoso.com
這個值來設定網域名稱系統 (DNS) 身分識別。
以程式設計方式設定身分識別
您的服務不需要明確指定身分識別,因為 WCF 會自動決定。不過,如果有需要,WCF 可讓您指定端點上的身分識別。下列程式碼會新增具有特定 DNS 身分識別的新服務端點。
Dim ep As ServiceEndpoint = myServiceHost.AddServiceEndpoint(GetType(ICalculator), New WSHttpBinding(), String.Empty)
Dim myEndpointAdd As New EndpointAddress(New Uri("https://localhost:8088/calc"), EndpointIdentity.CreateDnsIdentity("contoso.com"))
ep.Address = myEndpointAdd
ServiceEndpoint ep = myServiceHost.AddServiceEndpoint(
typeof(ICalculator),
new WSHttpBinding(),
String.Empty);
EndpointAddress myEndpointAdd = new EndpointAddress(new Uri("https://localhost:8088/calc"),
EndpointIdentity.CreateDnsIdentity("contoso.com"));
ep.Address = myEndpointAdd;
指定用戶端的身分識別
在設計階段,用戶端開發人員一般會使用 ServiceModel 中繼資料公用程式工具 (Svcutil.exe) 來產生用戶端組態。產生的組態檔 (供用戶端使用) 會包含伺服器的身分識別。例如,下列由服務產生的程式碼會指定 DNS 身分識別,如先前範例所示。請注意,用戶端的端點身分識別值符合服務的身分識別值。此時,如果用戶端接收服務的 Windows (Kerberos) 認證,值應該會是 contoso.com
。
<configuration>
<system.serviceModel>
<bindings>
<wsHttpBinding>
<binding name="WSHttpBinding_ICalculator_Windows">
<security>
<message clientCredentialType="Windows"/>
</security>
</binding>
</wsHttpBinding>
</bindings>
<client>
<endpoint address="https://localhost:8003/servicemodelsamples/service/dnsidentity"
binding="wsHttpBinding"
bindingConfiguration="WSHttpBinding_ICalculator_Windows"
contract="ICalculator"
name="WSHttpBinding_ICalculator">
<identity>
<dns value="contoso.com" />
</identity>
</endpoint>
</client>
</system.serviceModel>
</configuration>
如果,服務 (而不是 Windows) 將憑證指定為用戶端認證類型,則憑證的 DNS 屬性應該會是 contoso.com
(或者,如果 DNS 屬性為 null,則憑證的主體名稱必須是 contoso.com
)。
使用特定的身分識別值
下列用戶端組態檔說明服務的身分識別值如何成為所需的特定值。在下列範例中,用戶端可與兩個端點進行通訊。第一個端點是使用憑證指紋進行識別,而第二個則是使用憑證 RSA 金鑰。也就是說,這個憑證只包含公用金鑰/私用金鑰組,不是由受信任的授權單位發行。
<configuration>
<system.serviceModel>
<bindings>
<wsHttpBinding>
<binding name="WSHttpBinding_ICalculator_Anonymous">
<security>
<message clientCredentialType="None" />
</security>
</binding >
</wsHttpBinding>
</bindings>
<client>
<endpoint
address="https://localhost:8003/servicemodelsamples/service/certificateidentity"
binding="wsHttpBinding"
bindingConfiguration="WSHttpBinding_ICalculator_Anonymous"
contract="ICalculator"
name="WSHttpBinding_ICalculator1">
<identity>
<certificate encodedValue="AwAAAAEAAAAUAAAARwEDOI5fk5i0+TbylJ9k8Kljle8gAAAAAQAAAMoBAAAwggHGMIIBdKADAgECAhCZcmDK722ujUz3waJ+O26gMAkGBSsOAwIdBQAwFjEUMBIGA1UEAxMLUm9vdCBBZ2VuY3kwHhcNMDYwNTE3MjE0NDI1WhcNMzkxMjMxMjM1OTU5WjApMRAwDgYDVQQKEwdDb250b3NvMRUwEwYDVQQDEwxpZGVudGl0eS5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMGaK9xvyFhuHXWGpWgO4HvOYnbLbfR/9vh77g/rJe0oq6FR1hwipzyYB+isgzhZYkRUZ4lWr2wUTCqsvlHKJ3yMxNHA8u8D/H/C+PWC0PUZYn5pSHamqJ6IYvsxZN6kcBAEiJtTGA6sA7PSP1eGDSIMVhJx1hSN6ojfJkgMLtZvAgMBAAGjSzBJMEcGA1UdAQRAMD6AEBLkCS0GHR1PAI1hIdwWZGOhGDAWMRQwEgYDVQQDEwtSb290IEFnZW5jeYIQBjdsAKoAZIoRz7jUqlw19DAJBgUrDgMCHQUAA0EAMH8nZCN1I8vwOiPekC94Jd3/l9jTd6j2RTKb9OZvi5t2qw5uuLSqdhH+fxbGxrXIngOSzpw0FM9LiXkHvNR42g==" />
</identity>
</endpoint>
<endpoint address="https://localhost:8003/servicemodelsamples/service/rsaidentity"
binding="wsHttpBinding"
bindingConfiguration="WSHttpBinding_ICalculator_Anonymous"
contract="ICalculator"
name="WSHttpBinding_ICalculator2">
<identity>
<rsa value="<RSAKeyValue><Modulus>wZor3G/IWG4ddYalaA7ge85idstt9H/2+HvuD+sl7SiroVHWHCKnPJgH6KyDOFliRFRniVavbBRMKqy+UconfIzE0cDy7wP8f8L49YLQ9RlifmlIdqaonohi+zFk3qRwEASIm1MYDqwDs9I/V4YNIgxWEnHWFI3qiN8mSAwu1m8=</Modulus><Exponent>AQAB</Exponent></RSAKeyValue>" />
</identity>
</endpoint>
</client>
</system.serviceModel>
</configuration>
執行階段的身分識別檢查
在設計階段,用戶端開發人員會透過伺服器的中繼資料來決定其身分識別。在執行階段,系統會先執行身分識別檢查,然後再呼叫服務的任何端點。
身分識別值與中繼資料指定的驗證類型有關,換句話說,就是服務使用的認證類型。
如果通道已設為使用具有 X.509 憑證的訊息層級或傳輸層級 Secure Sockets Layer (SSL) 來進行驗證,則下列身分識別值有效:
DNS:WCF 可確保在 SSL 交換期間提供的憑證包含 DNS 或 CommonName (CN) 屬性,而此屬性等於在用戶端之 DNS 身分識別中指定的值。請注意,除了判斷伺服器憑證是否有效,系統也會進行這些檢查。根據預設,WCF 會驗證伺服器憑證是由受信任的根授權所發行。
憑證:在 SSL 交換期間,WCF 可確保遠端端點根據身分識別的指定提供正確的憑證值。
憑證參考:與「憑證」相同。
RSA:在 SSL 交換期間,WCF 可確保遠端端點根據身分識別的指定提供正確的 RSA 金鑰。
如果服務使用具有 Windows 認證的訊息層級或傳輸層級 SSL 來進行驗證並交涉認證,則下列身分識別值有效:
DNS:交涉會傳遞服務的 SPN,以便檢查 DNS 名稱。SPN 的形式為
host/<dns name>
。SPN:會傳回明確的服務 SPN,例如
host/myservice
。UPN:服務帳戶的 UPN。UPN 的形式為 username@domain。例如,當服務在使用者帳戶底下執行時,UPN 可能為
username@contoso.com
。
您可以選擇以程式設計方式指定身分識別 (透過 Identity 屬性)。如果未指定任何身分識別,且用戶端認證類型為 Windows,則預設值為 SPN (其值設為服務端點位址的主機名稱部分,並於前面加上 "host/" 常值)。如果未指定任何身分識別,且用戶端認證類型為憑證,則預設為 Certificate,訊息層級與傳輸層級安全性都適用這個預設值。
身分識別與自訂繫結
由於服務的身分識別取決於使用的繫結型別,所以建立自訂繫結時一定要公開適當的身分識別。例如,在下列程式碼範例中,公開的身分識別與安全性類型不相容,因為安全對話啟動安裝繫結的身分識別與端點上的繫結身分識別不符。安全對話繫結會設定 DNS 身分識別,而 WindowsStreamSecurityBindingElement 則會設定 UPN 或 SPN 身分識別。
Dim binding As New CustomBinding()
' The following binding exposes a DNS identity.
binding.Elements.Add(SecurityBindingElement.CreateSecureConversationBindingElement(SecurityBindingElement.CreateIssuedTokenForSslBindingElement(New IssuedSecurityTokenParameters())))
' The following element requires a UPN or SPN identity.
binding.Elements.Add(New WindowsStreamSecurityBindingElement())
binding.Elements.Add(New TcpTransportBindingElement())
CustomBinding binding = new CustomBinding();
// The following binding exposes a DNS identity.
binding.Elements.Add(SecurityBindingElement.
CreateSecureConversationBindingElement(
SecurityBindingElement.
CreateIssuedTokenForSslBindingElement(
new IssuedSecurityTokenParameters())));
// The following element requires a UPN or SPN identity.
binding.Elements.Add(new WindowsStreamSecurityBindingElement());
binding.Elements.Add(new TcpTransportBindingElement());
如需詳細資訊如何針對自訂繫結正確堆疊繫結項目的詳細資訊,請參閱建立使用者定義繫結。如需詳細資訊使用 SecurityBindingElement 建立自訂繫結的詳細資訊,請參閱 HOW TO:為指定的驗證模式建立 SecurityBindingElement。
另請參閱
工作
HOW TO:為指定的驗證模式建立 SecurityBindingElement
HOW TO:建立自訂用戶端身分識別驗證器
HOW TO:擷取憑證的指紋
概念
HOW TO:使用 SecurityBindingElement 建立自訂繫結
選取認證類型
使用憑證
ServiceModel 中繼資料公用程式工具 (Svcutil.exe)
建立使用者定義繫結