Skip to content

Service Endpoints

Service Endpoints allow Neuron to receive messages from and send messages to web services. This capability leverages Neuron’s native publish subscribe infrastructure making Neuron an extremely potent services intermediary.

Connections Tab

Service Connectors Tab.png

Service Endpoints are accessed in Neuron explorer by first clicking the Connections Tab and then selecting Service Endpoints. The Service Endpoint Details grid provides a summary view of all of the Endpoints. The Details Grid Menu provides the following functionality

Menu ItemFunctionality
NewCreates a new service endpoint
CopyCopies the selected service endpoint and appends “Copy” to the original name
DeleteRemoves the Service Endpoint
Show DetailShows the currently selected endpoints details when expanded. Shows list of service endpoints when collapsed.

Service Endpoint Editor

The Service Endpoint Editor is activated by selecting a Service Endpoint in the Service Endpoint Details Grid, Clicking the Show Detail button in the Service Endpoint Details Grid Menu or by using the Copy or New button.

Tab or ButtonFunctionality
Apply ButtonApplies changes to the .esb file in memory.
Cancel ButtonCancels changes
GeneralContains settings that apply to both Client Connectors and Service Connectors
BindingContains messaging pattern and advanced binding configuration options
SecurityContains Security options available to the Binding selected in the General Tab
Client<T>Contain properties Neuron’s Client<T> proxy can use to locate the service. Only applies to users who are using the Client<T> proxy in place of their own Web Service proxy
Client ConnectorContains settings that apply to the hosted endpoint that clients connect to
Service ConnectorContains settings specific to the target service Neuron will connect to
Proxy settingsContains settings to configure for utilizing a web proxy. Only applies to Service Connectors that must pass through web proxies to function.

General Tab

SettingFunctionality
Enabled CheckboxEnables or disables the endpoint functionality
NameThis is the unique name of the service endpoint.
DescriptionOptional description
CategorySets the category the service is cataloged with. Default is General.
ZoneSets the zone the endpoint belongs to.
BindingDetermines the WCF binding that is used. This can be overridden  by choosing to use a custom configuration file in the Binding tab.

Binding Tab

Binding.png
SettingFunctionality
Messaging PatternMay be either Request-Reply or Datagram. Datagram has the effect of using the WCF IsOneWay attribute on a OperationContractAttribute. Request-Reply publishes the message to Neuron with a Request Semantic. Datagram publishes the message with a Multicast Semantic  
Custom Configuration FileA custom configuration file may be used by clicking the associated ellipses button and choosing a file. The name of the WCF endpoint must match the endpoint in the General tab. The contract in the WCF file must be Neuron.Esb.EsbService.IOneWayService or Neuron.Esb.EsbService.ITwoWayService depending on Messaging pattern desired.
Max Message SizeSets the maximum message size up to 2147483647  
Reliable SessionsBinding in General Tab must support sessions for this setting to activate
TransactionsControls whether or not Neuron transitionally publishes the message. Transport must support Transactions for this to be effective.
Use Raw BodyThis writes the message as raw xml. Useful in situations when interacting with services that do not conform to WS* standards.

Security

SettingFunctionality
Security ModelBinding specific security model. The binding choice in General tab determines available options.
Service Identity TypeCorresponds to WCF setting.
Service Identity ValueCorresponds to WCF setting.
Negotiate Service CredentialCorresponds to WCF setting. Enabled by choosing Binding and Security mode that exposes option
Establish Security ContextCorresponds to WCF setting. Enabled by choosing Binding and Security mode that exposes option
Enable impersonationEnables protocol transition. A Binding that provides a windows identity as well as Kerberos must be configured for this to have the intended effect.

Client<T>

ClientT.png

The Client<T> tab is only used by users who are using the Neuron Client<T> API and want to locate the Service Endpoint dynamically using the property based constructor in place of a traditional Web Service proxy. This Tab contains a text box and a grid to enter name value pairs.

  • Contract – This must match the type of the Contract T
  • Search Grid-This gird is used to implement name value pairs in to allow for customizing locating the Service Endpoint.

Client Connector

ClientConnectorTab.png
SettingFunctionality
Enable Client Connector checkboxSpecifies whether the client connector functionality should be enabled.
Capture custom headersSpecifies whether Neuron should serialize SOAP Headers as ESBMessage custom properties.
Publisher IdUsed to select the Party messages will be published as.
TopicUsed to select the Topic the message will be published on.
URLUsed to set the address the host will listen on
Service CredentialsUsed to type the name of a matching certificate credential created in the Security Tab. Appears to be a drop down but is in fact a text box.
Issuer CredentialUsed to type issuer certificate credential. Only used in federated Binding.
Access Control ListUsed to select an ACL created in the Security tab

Service Connector

ServiceConnector.png
SettingFunctionality
Enable Service ConnectorThis must be enabled for the Service Connector to receive messages. A Service Connector with a Messaging Pattern set to Request-Reply will only deliver messages to the target service if the Semantic on the received ESBMessage is Request. A Service Connector with a Datagram Messaging Pattern will only deliver messages to the target Service if the Semantic is Multicast.
Single InstanceUsed in farm configuration to prevent sending duplicate messages to the target service.  
Restore Custom HeadersChecking this enables the restoration of custom soap headers serialized as ESBMessage properties.
Subscriber IdThis is the Party that will Receive messages from the bus and publish replies from the target service.
PolicyUse this to select a Service Policy configured in the Policies section of Connections to apply to the Service Connector.
Service CredentialsUsed to type the name of the certificate credential created in the Security tab
URLURL of the target service
Failover URL(s)-Use to create list of failover URLS that will be invoked in order if target service is unavailable  

Proxy

ProxyTab.png
SettingFunctionality
System DefaultUse this radio button to transparently inherent Default proxy settings from Windows.  
CustomUse this radio button to set Proxy properties explicitly
  • Host – Proxy host
  • Port – Proxy port
  • Bypass Proxy for local address – Use this to bypass the proxy for services hosted on the same server as Neuron
Use custom credentials  Allows selecting user name / password or windows domain credential previously created in Security tab under the credentials section. This is a drop down and does not require typing.  
Was this article helpful?
Dislike 0
Next: Communicating With REST Services