Протоколы веб-служб, поддерживаемые предоставляемыми системой привязками

Статья
03/01/2024

Windows Communication Foundation (WCF) создается для взаимодействия с веб-службами, поддерживающими набор спецификаций, известных как спецификации веб-служб. Чтобы упростить настройку службы для рекомендаций по взаимодействию, WCF представляет три привязки, предоставляемые системой взаимодействия: System.ServiceModel.BasicHttpBinding, System.ServiceModel.WSHttpBindingи System.ServiceModel.WSDualHttpBinding. Для взаимодействия со стандартами организации по улучшению структурированных информационных стандартов (OASIS) WCF включает одну привязку, предоставляемую системой взаимодействия: System.ServiceModel.WS2007HttpBinding Для публикации метаданных WCF включает две совместимые системные привязки: mexHttpBinding и< mexHttpsBinding>>.< В этом разделе перечислены спецификации, поддерживаемые предоставляемыми системой привязками с возможностью взаимодействия.

Протоколы веб-служб, поддерживаемые привязками basicHttpBinding, wsHttpBinding, ws2007HttpBinding и wsDualHttpBinding

Все привязки

Привязки basicHttpBinding>,< wsHttpBinding и <ws2007HttpBinding>> поддерживают следующие протоколы.<

Примечание.

Сведения о привязках, используемых для публикации метаданных, см. в разделе "Предоставляемые системой привязки метаданных" ниже.

Категория	Протокол	Спецификация и использование
Транспорт	HTTP 1.1	HTTP 1.1 `BasicHttpBinding`, `WSHttpBinding`, и `WS2007HttpBinding` используют протоколы HTTP и HTTPS.
Обмен сообщениями	MTOM	MTOM `basicHttpBinding`, `wsHttpBinding` и `ws2007HttpBinding` поддерживают механизм оптимизации передачи сообщений (MTOM). По умолчанию не используется. Чтобы использовать MTOM, присвойте атрибуту `messageEncoding` значение `"Mtom"`. Пример: `<wsHttpBinding> <binding messageEncoding="Mtom"/> </wsHttpBinding>`
Метаданные	WSDL 1.1	WSDL 1.1 WCF использует язык описания веб-служб (WSDL) для описания служб.
Метаданные	WS-Policy	Политика WS WCF использует спецификацию WS-Policy вместе с утверждениями конкретного домена для описания требований и возможностей службы.
Метаданные	WS-Policy 1.5	WS-Policy 1.5 WCF использует спецификацию WS-Policy вместе с утверждениями конкретного домена для описания требований и возможностей службы.
Метаданные	WS-PolicyAttachment	WS-PolicyAttachment WCF реализует WS-PolicyAttachment для присоединения выражений политики на различных область в языке описания веб-служб (WSDL).
Метаданные	WS-MetadataExchange	WS-MetadataExchange WCF реализует WS-MetadataExchange для получения XML-схемы, WSDL и WS-Policy.

basicHttpBinding

Категория	Протокол	Спецификация и использование
Обмен сообщениями	SOAP 1,1	SOAP 1.1 В соответствии со спецификацией Basic Profile 1.1 элемент `basicHttpBinding` реализует протокол обмена сообщениями SOAP 1.1.
Безопасность	WSS SOAP Message Security 1.0	Windows SharePoint Services SOAP Message Security 1.0 В соответствии со спецификацией Basic Security Profile элемент `basicHttpBinding` реализует спецификацию Web Services Security (WSS) SOAP Message Security 1.0 для имени пользователя/пароля и безопасности на основе сертификатов X.509. `<basicHttpBinding> <binding name="Binding1"> <security mode="TransportWithMessageCredential \| "Message" .../> </binding> </basicHttpBinding>`
Безопасность	WSS SOAP Message Security UsernameToken Profile 1.0	Windows SharePoint Services профилей пользователя UsernameToken для безопасности сообщений SOAP 1.0 `<basicHttpBinding> <binding name="Binding1"> <security mode="TransportWithMessageCredential"> <transport clientCredentialType="Basic"/> </security> </basicHttpBinding>`
Безопасность	Windows SharePoint Services профиле маркера сертификата X.509 SOAP Для безопасности сообщений SOAP 1.0	Windows SharePoint Services профиле маркера сертификата X.509 SOAP Для безопасности сообщений SOAP 1.0 `<basicHttpBinding> <security mode="Message"> <message clientCredentialType="Certificate"/> </security> </basicHttpBinding>`

wsHttpBinding, ws2007HttpBinding и wsDualHttpBinding

Категория	Протокол	Спецификация и использование
Обмен сообщениями	SOAP 1.2	Руководство Платформа обмена сообщениями Адъюнкты (включая привязку HTTP)
Обмен сообщениями	WS-Адресация 2005/08	Адресация веб-служб 1.0 — core Адресация веб-служб 1.0 — SOAP Привязки `wsHttpBinding`, `ws2007HttpBinding` и `wsDualHttpBinding` реализуют рекомендацию спецификации WS-Addressing консорциума W3C (включение асинхронного обмена сообщениями, корреляции сообщений и механизмов адресации без привязки к конкретному транспортному протоколу). WCF не поддерживает шифрование заголовков WS-Addressing, хотя это допускается спецификациями WS-*.
Обмен сообщениями	WS-Addressing 1.0 ― метаданные	Поддержка метаданных WS-Адресации 1.0 для этого протокола включена, задав версию политики в поведении ServiceMetadata — с параметром policyversion задано значение 1.2 (по умолчанию), описание wsdl соответствует WS-Адресации wsdl, при этом для параметра policyversion задано значение 1.5, описание wsdl соответствует метаданным ws-адресации. WCF не поддерживает шифрование заголовков WS-Addressing, хотя это допускается спецификациями WS-*.
Безопасность	WSS SOAP Message Security 1.0	Windows SharePoint Services SOAP Message Security 1.0 Используется, когда атрибуту `securityMode` присвоено значение "wsSecurityOverHttp" (по умолчанию) и параметры настроены с использованием дочернего элемента `wsSecurity`. `<wsHttpBinding> <binding name="myBinding"> <security mode="Message" .../> </binding> </wsHttpBinding>`
Безопасность	Windows SharePoint Services профиль 1.1.1 для безопасности сообщений SOAP	Windows SharePoint Services профилей пользователя UsernameToken для безопасности сообщений SOAP 1.0 Используется, когда атрибуту `wsSecurity` элемента `authenticationMode` присвоено значение "Username". `<wsHttpBinding> <binding name="MyBinding"> <security mode="Message> <message clientCredentialType="UserName negotiateServiceCredential="false" establishSecurityContext="false"/> </security> </binding> </wsHttpBinding>`
Безопасность	WSS SOAP Message Security X.509 Certificate Token Profile 1.1	Windows SharePoint Services профиль маркера сертификата 1.1.1 по протоколу SOAP Message Security X.509 Используется для защиты сообщений, когда атрибуту `wsSecurity` элемента `authenticationMode` присвоено значение "Username", "Certificate" или "None". Кроме того, используется для проверки подлинности клиентов, когда атрибуту `wsSecurity` элемента `authenticationMode` присвоено значение "Certificate". `<wsHttpBinding> <binding name="MyBinding"> <security mode="Message> <message clientCredentialType="Certificate" negotiateServiceCredential="false" establishSecurityContext="false"/> </security> </binding> </wsHttpBinding>`
Безопасность	WSS SOAP Message Security Kerberos Token Profile 1.1	Windows SharePoint Services профиль маркера Kerberos для безопасности сообщений SOAP 1.1 Используется для проверки подлинности и защиты сообщений, когда атрибуту `wsSecurity` элемента `authenticationMode` присвоено значение "Windows". `<wsHttpBinding> <binding name="MyBinding"> <security mode="Message> <message clientCredentialType="Windows" negotiateServiceCredential="false" establishSecurityContext="false"/> </security> </binding> </wsHttpBinding>`
Безопасность	WS-SecureConversation	WS-SecureConversation Используется для обеспечения безопасного сеанса, когда атрибуту `security/@mode` присвоено значение "Message", а атрибуту `message/@establishSecurityContext` присвоено значение "true" (по умолчанию).
Безопасность	WS-Trust	WS-Trust Используется в спецификации WS-SecureConversation (см. выше).
Надежный обмен сообщениями	WS-ReliableMessaging	WS-ReliableMessaging Используется, когда привязка настроена на использование свойства `reliableSession`. `<wsHttpBinding> <binding name="myBinding"> <reliableSession/> </binding> </wsHttpBinding>`
Транзакции	WS-AtomicTransaction	WS-AtomicTransaction Используется для обмена данными между диспетчерами транзакций. Клиенты и службы WCF всегда используют локальные диспетчеры транзакций.
Транзакции	WS-Coordination	WS-Координация Используется для передачи контекста транзакций, когда атрибуту `flowTransactions` присвоено значение Allowed или Required. `<wsHttpBinding> <binding transactionFlow="true"/> </wsHttpBinding>`

wsFederationHttpBinding и ws2007FederationHttpBinding

Элементы wsFederationHttpBinding и <ws2007FederationHttpBinding>> представлены для поддержки федеративных сценариев, где сторонний поставщик выдает маркер, используемый для проверки подлинности клиента.< В дополнение к протоколам, используемым привязкой wsHttpBinding, привязка wsFederationHttpBinding позволяет использовать следующие спецификации:

WS-Trust для выдачи маркеров.
WSS Security Assertions Markup Language (SAML) Token Profile 1.0 и 1.1 для наиболее часто выдаваемого формата маркеров.

Пример:

<wsFederationHttpBinding>
  <binding name="myBinding">
     <security mode="Message">
       <message issuedKeyType="Symmetric"
                issuedTokenType="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1">
         <issuerMetadata address =
         'http://localhost/FederationSample/HomeRealmSTS/STS.svc/mex'/>
       </message>
     </security>
  </binding>
</wsFederationHttpBinding>

Дополнительные сведения см. в разделе "Федерация".

Предоставляемые системой привязки метаданных

В следующих таблицах приведены протоколы, поддерживаемые предоставляемыми системой привязками метаданных, которые предоставляются классом System.ServiceModel.Description.MetadataExchangeBindings.

mexHttpBinding

Привязка <mexHttpBinding> поддерживает следующие протоколы. Дополнительные сведения об использовании этой привязки см. в разделе "Публикация метаданных".

Категория	Протокол	Спецификация и использование
Транспорт	HTTP 1.1	HTTP 1.1
Обмен сообщениями	SOAP 1.2	Руководство Платформа обмена сообщениями Адъюнкты (включая привязку HTTP)
Обмен сообщениями	WS-Адресация 2005/08	Адресация веб-служб 1.0 — core Адресация веб-служб 1.0 — SOAP
Метаданные	WS-MetadataExchange	WS-MetadataExchange WCF реализует WS-MetadataExchange для получения XML-схемы, WSDL и WS-Policy.

mexHttpsBinding

<mexHttpsBinding> поддерживает следующие протоколы. Дополнительные сведения об использовании этой привязки см. в разделе "Публикация метаданных".

Категория	Протокол	Спецификация и использование
Транспорт	HTTP 1.1	HTTP 1.1 Безопасность транспорта включена.
Обмен сообщениями	SOAP 1.2	Руководство Платформа обмена сообщениями Адъюнкты (включая привязку HTTP)
Обмен сообщениями	WS-Адресация 2005/08	Адресация веб-служб 1.0 — core Адресация веб-служб 1.0 — SOAP
Метаданные	WS-MetadataExchange	WS-MetadataExchange WCF реализует WS-MetadataExchange для получения XML-схемы, WSDL и WS-Policy.