Send an IM with UCWA - Step 1 - Prerequisites

Learn some of the important prerequisites for installing and configuring UCWA on your Lync 2013 environment.

Wednesday, 28 January 2015


Installing and Configuring UCWA

Before you can install and configure UCWA, ensure that all nodes in your Lync environment (Front End, Edge, Director, etc.) are fully patched and up to date with the latest Cummulative Updates.

Microsoft have a great resource that summarizes the updates available, which you should check regularly.


Bootstrapping the Environment

Once up-to-date, you need to run the Bootstraper application on each Edge, Front-End and Director server in your environment, from the Lync Server Management Shell (not Powershell).

%ProgramFiles%\Microsoft Lync Server 2013\Deployment\Bootstrapper.exe


Configuring "Allowed Domains"

UCWA controls access by only permitting access from a set of domain names that you specify, to help avoid Cross Domain exploits.

Your UCWA application or handler needs to be hosted on an IIS site with a fully qualified domain (FQDN), such as Contoso is regularly used by Microsoft for examples and tutorials, so we'll use it here .

Every variation of the FQDN (http, https, different ports, etc.) must be added to the internal list of Allowed Domains.

Again, using the Lync Server Managed Shell, kick off the following commands on each and every Front End, Edge and Director server you have. The 2nd line is wrapped for readability.

$x = New-CsWebOrigin -Url "{}"
Set-CsWebServiceConfiguration -Identity "My UCWA Application" 
        -CrossDomainAuthorizationList @{Add=$x}
Handy Hint: Use the command "Get-CsWebServiceConfiguration | select identity" to validate the Allow Domains have been successfully added.
Information: A unique -Identity value must be used for each unique URL.





Lync, UCWA, IM, Instant Message, Office 365, Skype for Business, Lync API, Lync SDK
Share with: 

Learn some of the important prerequisites for installing and configuring UCWA on your Lync 2013 environment.

Support this Site

Buy me a coffeeBuy me a coffee

Popular Articles

What is Kutamo?
Kilimanjaro 2020
Kilimanjaro 2015
Australian Postcodes
Worldwide City Database
Exchange 2013 in 60 minutes

Recent Articles

Australian Post Codes
Worldwide City Data
Skype Web SDK
Using the Skype Web SDK from any language or framework
Building a Skype for Business Auto Responder using the Skype Web SDK

Favourite Links

Kutamo Studios
Cloud on Kilimanjaro