Как добавить собственный заголовок HTTP к каждому вызову WCF?

162

У меня есть служба WCF, которая размещена в службе Windows. Клиенты, которые используют эту службу, должны передавать идентификатор каждый раз, когда они вызывают методы службы (потому что этот идентификатор важен для того, что должен делать вызываемый метод). Я подумал, что это хорошая идея - как-то поместить этот идентификатор в информацию заголовка WCF.

Если это хорошая идея, как я могу автоматически добавить идентификатор к информации заголовка. Другими словами, всякий раз, когда пользователь вызывает метод WCF, идентификатор должен автоматически добавляться в заголовок.

ОБНОВЛЕНИЕ: Клиенты, которые используют службу WCF, являются приложениями Windows и Windows Mobile (используя Compact Framework).

mrtaikandi
источник
1
Вы смогли решить свою проблему?
Марк Хороший
Вы в конечном итоге заставили это работать на Compact Framework?
Ваккано
Смотрите: blogs.msdn.microsoft.com/wsdevsol/2014/02/07/…an
Иан Кемп

Ответы:

185

Преимущество этого заключается в том, что он применяется к каждому вызову.

Создайте класс, который реализует IClientMessageInspector . В методе BeforeSendRequest добавьте свой пользовательский заголовок к исходящему сообщению. Это может выглядеть примерно так:

    public object BeforeSendRequest(ref System.ServiceModel.Channels.Message request,  System.ServiceModel.IClientChannel channel)
{
    HttpRequestMessageProperty httpRequestMessage;
    object httpRequestMessageObject;
    if (request.Properties.TryGetValue(HttpRequestMessageProperty.Name, out httpRequestMessageObject))
    {
        httpRequestMessage = httpRequestMessageObject as HttpRequestMessageProperty;
        if (string.IsNullOrEmpty(httpRequestMessage.Headers[USER_AGENT_HTTP_HEADER]))
        {
            httpRequestMessage.Headers[USER_AGENT_HTTP_HEADER] = this.m_userAgent;
        }
    }
    else
    {
        httpRequestMessage = new HttpRequestMessageProperty();
        httpRequestMessage.Headers.Add(USER_AGENT_HTTP_HEADER, this.m_userAgent);
        request.Properties.Add(HttpRequestMessageProperty.Name, httpRequestMessage);
    }
    return null;
}

Затем создайте поведение конечной точки, которое применяет инспектор сообщений к среде выполнения клиента. Вы можете применить поведение через атрибут или через конфигурацию, используя элемент расширения поведения.

Вот отличный пример того, как добавить заголовок агента пользователя HTTP ко всем сообщениям запроса. Я использую это в некоторых из моих клиентов. Вы также можете сделать то же самое на стороне службы, реализовав IDispatchMessageInspector .

Это то, что вы имели в виду?

Обновление: я нашел этот список функций WCF, которые поддерживаются компактной структурой. Я считаю , что сообщение инспекторов классифицируемых как «Channel расширяемость» , который, согласно этому сообщению, которые поддерживаются в компактной структуре.

Марк Хороший
источник
2
@ Марк, это действительно отличный ответ. Спасибо. Я пробовал это через net.tcp, но я использую коллекцию заголовков напрямую (заголовки Http не работали). Я получаю Заголовок с моим токеном (Name) в событии ServiceHost AfterReceiveRequest, но не со значением (там даже не существует свойства для значения?). Есть что-то, чего мне не хватает? Я ожидал бы пару имя / значение, поскольку при создании заголовка он запрашивает у меня: request.Headers.Add (MessageHeader.CreateHeader (name, ns, value));
Program.X
13
+1 OutgoingMessageProperties- это то, что вам нужно для доступа к заголовкам HTTP, а не к OutgoingMessageHeadersзаголовкам SOAP.
SliverNinja - MSFT
1
Просто классный код! :)
abhilashca
3
Это позволяет только жестко закодированный пользовательский агент, который - согласно приведенному примеру - жестко запрограммирован в web.config!
KristianB
1
Это отличный ответ. Он также обрабатывает случай, когда HttpRequestMessageProperty.Name еще не доступен в свойствах сообщения. По какой-то причине, отлаживая мой код, я понял, что в зависимости от некоторых проблем синхронизации это значение не всегда было. Спасибо Марк!
carlos357
80

Вы добавляете это к звонку используя:

using (OperationContextScope scope = new OperationContextScope((IContextChannel)channel))
{
    MessageHeader<string> header = new MessageHeader<string>("secret message");
    var untyped = header.GetUntypedHeader("Identity", "http://www.my-website.com");
    OperationContext.Current.OutgoingMessageHeaders.Add(untyped);

    // now make the WCF call within this using block
}

И затем, на стороне сервера вы берете его, используя:

MessageHeaders headers = OperationContext.Current.IncomingMessageHeaders;
string identity = headers.GetHeader<string>("Identity", "http://www.my-website.com");
AgileJon
источник
5
Спасибо за ваш фрагмент кода. Но с этим я должен добавить заголовок каждый раз, когда я хочу вызвать метод. Я хотел сделать этот процесс прозрачным. Я имею в виду, что при реализации один раз, каждый раз, когда пользователь создает клиент службы и использует метод, заголовок клиента автоматически добавляется в сообщение.
mrtaikandi
Это хорошая ссылка MSDN с примером для расширения предложения, представленного в этом ответе: msdn.microsoft.com/en-us/library/…
atconway
1
Спасибо, это отличный кусок кода, если вы используете пользовательскую клиентскую библиотеку. Таким образом, вам не нужно реализовывать messageinspector. Просто создайте общий метод-обертку, который оборачивает каждый клиентский вызов в OperationContextScope.
JustAMartin
3
Как примечание, это проблематично, если вы выполняете какие-либо асинхронные действия с вашими вызовами, потому что OperationContextScopeOperationContext) ответ ThreadStatic- Марк Гуд будет работать, не полагаясь на ThreadStaticэлементы.
Зимданен
2
Это не добавляет заголовок HTTP! Он добавляет заголовки в конверт SOAP.
br3nt
32

Если вы просто хотите добавить один и тот же заголовок ко всем запросам к сервису, вы можете сделать это без любой кодировки!
Просто добавьте узел заголовков с необходимыми заголовками под узлом конечной точки в файле конфигурации клиента

<client>  
  <endpoint address="http://localhost/..." >  
    <headers>  
      <HeaderName>Value</HeaderName>  
    </headers>   
 </endpoint>  
Нимеш Мадхаван
источник
18
Это заголовки SOAP ( alaMessageHeader ), а не заголовки HTTP.
SliverNinja - MSFT
18

Вот еще одно полезное решение для ручного добавления пользовательских заголовков HTTP в ваш клиентский запрос WCF с использованием в ChannelFactoryкачестве прокси. Это должно быть сделано для каждого запроса, но достаточно просто для демонстрации, если вам просто нужно выполнить юнит-тестирование вашего прокси при подготовке к платформам, отличным от .NET.

// create channel factory / proxy ...
using (OperationContextScope scope = new OperationContextScope(proxy))
{
    OperationContext.Current.OutgoingMessageProperties[HttpRequestMessageProperty.Name] = new HttpRequestMessageProperty()
    {
        Headers = 
        { 
            { "MyCustomHeader", Environment.UserName },
            { HttpRequestHeader.UserAgent, "My Custom Agent"}
        }
    };    
    // perform proxy operations... 
}
SliverNinja - MSFT
источник
1
Я перепробовал 4 других похожих друг на друга предложения, и это единственное, что сработало для меня.
JohnOpincar
Это фактически добавляет заголовки HTTP, спасибо! :) Но, боже, это уродливый код.
br3nt
11

Это похоже на ответ NimsDotNet, но показывает, как это сделать программно.

Просто добавьте заголовок к привязке

var cl = new MyServiceClient();

var eab = new EndpointAddressBuilder(cl.Endpoint.Address);

eab.Headers.Add( 
      AddressHeader.CreateAddressHeader("ClientIdentification",  // Header Name
                                         string.Empty,           // Namespace
                                         "JabberwockyClient"));  // Header Value

cl.Endpoint.Address = eab.ToEndpointAddress();
ΩmegaMan
источник
Я получил этот код, добавленный к моему текущему вызову (на стороне клиента). Как мне получить это значение заголовка в System.ServiceModel.OperationContext? (серверная часть) (я скрещиваю пальцы, чтобы это мне помогло)
granadaCoder
1
Понял ! System.ServiceModel.Channels.MessageHeaders headers = operationContext.RequestContext.RequestMessage.Headers; int headerIndex = headers.FindHeader ("ClientIdentification", string.Empty); var requestName = (headerIndex <0)? "НЕИЗВЕСТНО": headers.GetHeader <string> (headerIndex);
granadaCoder
1
@granadaCoder Мне нравится этот сайт! ;-)
ΩmegaMan
Это добавляет заголовок к конверту SOAP, а не заголовок HTTP
br3nt
5
var endpoint = new EndpointAddress(new Uri(RemoteAddress),
               new[] { AddressHeader.CreateAddressHeader(
                       "APIKey", 
                       "",
                       "bda11d91-7ade-4da1-855d-24adfe39d174") 
                     });
shepcom
источник
12
Это заголовок сообщения SOAP, а не заголовок HTTP.
Рене
3

Это то, что сработало для меня, адаптировано от добавления заголовков HTTP к вызовам WCF

// Message inspector used to add the User-Agent HTTP Header to the WCF calls for Server
public class AddUserAgentClientMessageInspector : IClientMessageInspector
{
    public object BeforeSendRequest(ref System.ServiceModel.Channels.Message request, IClientChannel channel)
    {
        HttpRequestMessageProperty property = new HttpRequestMessageProperty();

        var userAgent = "MyUserAgent/1.0.0.0";

        if (request.Properties.Count == 0 || request.Properties[HttpRequestMessageProperty.Name] == null)
        {
            var property = new HttpRequestMessageProperty();
            property.Headers["User-Agent"] = userAgent;
            request.Properties.Add(HttpRequestMessageProperty.Name, property);
        }
        else
        {
            ((HttpRequestMessageProperty)request.Properties[HttpRequestMessageProperty.Name]).Headers["User-Agent"] = userAgent;
        }
        return null;
    }

    public void AfterReceiveReply(ref System.ServiceModel.Channels.Message reply, object correlationState)
    {
    }
}

// Endpoint behavior used to add the User-Agent HTTP Header to WCF calls for Server
public class AddUserAgentEndpointBehavior : IEndpointBehavior
{
    public void ApplyClientBehavior(ServiceEndpoint endpoint, ClientRuntime clientRuntime)
    {
        clientRuntime.MessageInspectors.Add(new AddUserAgentClientMessageInspector());
    }

    public void AddBindingParameters(ServiceEndpoint endpoint, BindingParameterCollection bindingParameters)
    {
    }

    public void ApplyDispatchBehavior(ServiceEndpoint endpoint, EndpointDispatcher endpointDispatcher)
    {
    }

    public void Validate(ServiceEndpoint endpoint)
    {
    }
}

После объявления этих классов вы можете добавить новое поведение к вашему клиенту WCF следующим образом:

client.Endpoint.Behaviors.Add(new AddUserAgentEndpointBehavior());
paulwhit
источник
Это не скомпилируется: Ошибка CS0136 Локальный или параметр с именем 'property' не может быть объявлен в этой области, поскольку это имя используется во внешней локальной области для определения локального или параметра.
Leszek P
просто удалите тот, который не использовался
kosnkov
3

Это работает для меня

TestService.ReconstitutionClient _serv = new TestService.TestClient();

using (OperationContextScope contextScope = new OperationContextScope(_serv.InnerChannel))
{
   HttpRequestMessageProperty requestMessage = new HttpRequestMessageProperty();

   requestMessage.Headers["apiKey"] = ConfigurationManager.AppSettings["apikey"]; 
   OperationContext.Current.OutgoingMessageProperties[HttpRequestMessageProperty.Name] = 
      requestMessage;
   _serv.Method(Testarg);
}
Таран
источник
2

Контекстные привязки в .NET 3.5 могут быть именно тем, что вы ищете. Есть три из коробки: BasicHttpContextBinding, NetTcpContextBinding и WSHttpContextBinding. Протокол контекста в основном передает пары ключ-значение в заголовок сообщения. Ознакомьтесь со статьей « Управление состоянием с помощью Durable Services» в журнале MSDN.

Мехмет Арас
источник
Также обратите внимание, что вы устанавливаете контекст только один раз перед установкой сеанса с сервером. Тогда контекст становится доступным только для чтения. Если вы хотите, чтобы настройка контекста была прозрачной на стороне клиента, вы можете получить из класса клиента proxt и в конструкторе вы можете добавить информацию, которая составляет ваш контекст. Затем каждый раз, когда клиент создает экземпляр клиентского прокси, контекст автоматически создается и добавляется в экземпляр клиентского прокси.
Мехмет Арас
2

Если я правильно понимаю ваше требование, простой ответ: вы не можете.

Это связано с тем, что клиент службы WCF может быть создан любой третьей стороной, которая использует ваш сервис.

ЕСЛИ у вас есть контроль над клиентами вашего сервиса, вы можете создать базовый класс клиента, который добавляет желаемый заголовок и наследует поведение рабочих классов.

Пауло Сантос
источник
1
согласен, если вы действительно строите SOA, вы не можете предполагать, что все клиенты основаны на .NET. Подождите, пока ваш бизнес не будет приобретен.
SliverNinja - MSFT
2
Это правда? Клиенты веб-службы Java не имеют возможности добавлять имя / значения в заголовки SOAP? Я считаю, что трудно поверить. Конечно, это будет другая реализация, но это совместимое решение
Адам
2

Вы можете указать пользовательские заголовки в MessageContract .

Вы также можете использовать заголовки <endpoint> , которые хранятся в файле конфигурации и будут скопированы в заголовок всех сообщений, отправленных клиентом / службой. Это полезно, чтобы легко добавить статический заголовок.

Philippe
источник
3
Это заголовки SOAP ( alaMessageHeader ), а не заголовки HTTP.
SliverNinja - MSFT
0

Если вы хотите добавить пользовательские заголовки HTTP к каждому вызову WCF объектно-ориентированным способом, не смотрите дальше.

Как и в ответе Марка Гуда и Пола, нам нужно создать подкласс IClientMessageInspectorдля вставки пользовательских заголовков HTTP в запрос WCF. Однако давайте сделаем инспектор более общим, приняв словарь, содержащий заголовки, которые мы хотим добавить:

public class HttpHeaderMessageInspector : IClientMessageInspector
{
    private Dictionary<string, string> Headers;

    public HttpHeaderMessageInspector(Dictionary<string, string> headers)
    {
        Headers = headers;
    }

    public object BeforeSendRequest(ref Message request, IClientChannel channel)
    {
        // ensure the request header collection exists
        if (request.Properties.Count == 0 || request.Properties[HttpRequestMessageProperty.Name] == null)
        {
            request.Properties.Add(HttpRequestMessageProperty.Name, new HttpRequestMessageProperty());
        }

        // get the request header collection from the request
        var HeadersCollection = ((HttpRequestMessageProperty)request.Properties[HttpRequestMessageProperty.Name]).Headers;

        // add our headers
        foreach (var header in Headers) HeadersCollection[header.Key] = header.Value;

        return null;
    }

    // ... other unused interface methods removed for brevity ...
}

Как и в ответе Марка Гуда и Пола, нам нужно создать подкласс, IEndpointBehaviorчтобы внедрить HttpHeaderMessageInspectorнаш клиент в WCF.

public class AddHttpHeaderMessageEndpointBehavior : IEndpointBehavior
{
    private IClientMessageInspector HttpHeaderMessageInspector;

    public AddHttpHeaderMessageEndpointBehavior(Dictionary<string, string> headers)
    {
        HttpHeaderMessageInspector = new HttpHeaderMessageInspector(headers);
    }

    public void ApplyClientBehavior(ServiceEndpoint endpoint, ClientRuntime clientRuntime)
    {
        clientRuntime.ClientMessageInspectors.Add(HttpHeaderMessageInspector);
    }

    // ... other unused interface methods removed for brevity ...
}

Последняя часть, необходимая для завершения нашего объектно-ориентированного подхода, заключается в создании подкласса нашего автоматически сгенерированного клиента WCF (для создания клиента WCF я использовал справочное руководство по веб-сервисам WCF от Microsoft ).

В моем случае мне нужно прикрепить ключ API к x-api-keyзаголовку HTML.

Подкласс делает следующее:

  • вызывает конструктор базового класса с необходимыми параметрами (в моем случае EndpointConfigurationсгенерировано перечисление для передачи в конструктор - возможно, ваша реализация не будет иметь этого)
  • Определяет заголовки, которые должны быть присоединены к каждому запросу
  • Присоединяется AddHttpHeaderMessageEndpointBehaviorк Endpointповедению клиента
public class Client : MySoapClient
{
    public Client(string apiKey) : base(EndpointConfiguration.SomeConfiguration)
    {
        var headers = new Dictionary<string, string>
        {
            ["x-api-key"] = apiKey
        };

        var behaviour = new AddHttpHeaderMessageEndpointBehavior(headers);
        Endpoint.EndpointBehaviors.Add(behaviour);
    }
}

Наконец, используйте ваш клиент!

var apiKey = 'XXXXXXXXXXXXXXXXXXXXXXXXX';
var client = new Client (apiKey);
var result = client.SomeRequest()

Полученный HTTP-запрос должен содержать ваши HTTP-заголовки и выглядеть примерно так:

POST http://localhost:8888/api/soap HTTP/1.1
Cache-Control: no-cache, max-age=0
Connection: Keep-Alive
Content-Type: text/xml; charset=utf-8
Accept-Encoding: gzip, deflate
x-api-key: XXXXXXXXXXXXXXXXXXXXXXXXX
SOAPAction: "http://localhost:8888/api/ISoapService/SomeRequest"
Content-Length: 144
Host: localhost:8888

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <SomeRequestxmlns="http://localhost:8888/api/"/>
  </s:Body>
</s:Envelope>
br3nt
источник
-1

Немного опоздал на вечеринку, но Юваль Лоуи рассматривает этот точный сценарий в своей книге и связанной библиотеке ServiceModelEx .

В основном он определяет специализации ClientBase и ChannelFactory, которые позволяют указывать типобезопасные значения заголовков. Я предлагаю загрузить исходный код и посмотреть на классы HeaderClientBase и HeaderChannelFactory.

Джон

BrizzleOwl
источник
1
Это в значительной степени ничего, кроме продвижения чьей-то работы. Не могли бы вы добавить соответствующий отрывок / алгоритм - т.е. ответить на вопрос - или раскрыть любую принадлежащую вам принадлежность? В противном случае это просто вымышленный спам.
Фонд Моника иск
Я бы сказал, что он дает кому-то ответ посредством указателя на подход, о котором он может не знать. Я дал соответствующую ссылку, почему я должен добавить больше? это все в ссылках. И я уверен, что Юваль Лоуи мог бы описать это лучше, чем я мог бы :-) Что касается моей принадлежности - я купил книгу! Вот и все. Я никогда не встречал мистера Лоуи, но уверен, что он отличный парень. Видимо, много знает о WCF ;-)
BrizzleOwl
Вы должны добавить больше, потому что, по-видимому, вы прочитали, как ответить, прежде чем ответить, и вы отметили раздел, который гласит: «Всегда указывайте наиболее релевантную часть важной ссылки, если целевой сайт недоступен или постоянно отключен». Ваша принадлежность не важна. Только качество ответа есть.
Фонд Моника иск
Хорошо. Я не в этом для очков - как вы, вероятно, можете сказать из моего счета! Просто подумал, что это может быть полезным указателем.
BrizzleOwl
1
Я не говорю, что это плохой указатель. Я говорю, что сам по себе это не очень хороший ответ. Это может очень хорошо помочь людям, и это хорошо, но ответ будет лучше, если вы сможете описать метод, который он использует, вместо того, чтобы дать очень краткое описание участвующих классов. Таким образом, в случае невозможности доступа к сайту - по любой причине - ваш ответ по-прежнему помогает.
Фонд Моника иск