UNIFYBroker Agent

Overview

A UNIFYBroker agent encapsulates the connection details to a single instance of UNIFYBroker v3.0 or above. This agent is responsible for WCF based connections to UNIFYBroker (such as checking for changes). For RESTful connections see Rest API agent (e.g. trigger connector import).

Operational Considerations

An incorrect configured UNIFYBroker agent will affect every operation attached to it.

Usages

The UNIFYBroker agent is used by the following Operations:

Configuration

In addition to the common agent configuration settings shared by all agents, the UNIFYBroker agent requires the following by way of configuration:

Name Description
Endpoint Address The base URI of the UNIFYBroker service. In a standard installation, this will be of the format: http://IdentityBrokerServer:59990/
Studio Configuration The UNIFYBroker endpoint configuration name for the UNIFYBroker service, used by the UNIFYBroker Changes operation to retrieve a list of adapters - this corresponds to the UNIFYBroker endpoint configuration details specified in the UNIFYBroker service configuration, and related UNIFYNow configuration. In a standard installation, this is set to IdentityBroker. This value should match the name attribute of the endpoint element with the contract IIdentityBrokerEngineNotificationCollector in the Unify.Service.Event.exe.config file (see below).
Changes Configuration The UNIFYBroker endpoint configuration name for the UNIFYBroker changes service, used by the UNIFYBroker Changes operation to check for changes - this corresponds to the UNIFYBroker endpoint configuration details specified in the UNIFYBroker configuration, and related UNIFYNow configuration. In a standard installation, this is usually IdentityBroker. This should match the name attribute of the endpoint element with the contract Unify.Framework.IChangesAvailableAdapter in the Unify.Service.Event.exe.config file (see below).
Version

The target version of UNIFYBroker.

In order to successfully communicate with an UNIFYBroker instance, the following configuration must first be correct in the Unify.Service.Event.exe.config file (located in the Event Broker/Services directory). This defines the Microsoft Windows Communication Foundation (WCF) client end-point configuration used to contact the UNIFYBroker service. This can be found within the system.serviceModel element in the configuration.

<client>
  <endpoint
   binding="basicHttpBinding"
   contract="IIdentityBrokerEngineNotificationCollector"
   bindingConfiguration="StreamingFileTransferServicesBinding"
   name="IdentityBroker" />
  <endpoint
   binding="basicHttpBinding"
   contract="Unify.Framework.IChangesAvailableAdapter"
   bindingConfiguration="StreamingFileTransferServicesBinding"
   name="IdentityBroker" />
</client>

Note that the above endpoint information should be correctly configured for each instance of UNIFYBroker that is required. Following changes to this configuration, the UNIFYNow service must be restarted.


Notes

For more information, review the UNIFYBroker Documentation.

Agent UNIFYBroker

Is this article helpful for you?