Install Interceptor

Note

An Enterprise license or higher is required to access these features.

Preparation

Before starting the installation, make sure the following preparations are taken on the device that will run the :

  • Windows features installed

    • .NET Framework 4.6.2
  • 1 service account with the following rights

    • Member of Local Administrator group on the server
    • Member of the RTCUniversalReadOnlyAdmins group in the domain
    • Provided “Log on as a batch job” rights
    • Provided “Log on as a service” rights
    • Optionally, provided “Protect object from accidental deletion” rights
  • Open port you use in AgentProviderPort (default 10000) of the firewall between the FE and AnywhereNow server.

When the above preparations are completed, the installation can be continued.

Installing the Interceptor

  1. Copy files to the Front End Server(s)

  2. Make sure that the .zip package is unblocked.

    1. Right click on the .zip file and choose ‘properties’
    2. Then click Unblock and Apply
  3. Unpack the Interceptor zip

  4. Open PowerShell as administrator

  5. Navigate to the directory

  6. Run “install.ps1”

    1. Optional:

      1. Use parameter: install.ps1 -UPN "serviceaccount@domain.com"
      2. Use SamAccount parameter: install.ps1 -samAccountName "serviceaccount"
  7. Enter the password of the given service account

  8. Enter the of the AnywhereNow Server (not the pool)

(Optional) Add more AnywhereNow Servers

Note

Additional AnywhereNow servers can be Passive Failover AnywhereNow servers or other Active AnywhereNow servers. For example an Active AnywhereNow server servicing another regions like EMEA/US/ASIA.

  1. Navigate to Install directory

    1. C:\Program Files\SipInterceptor
  2. Open the config:

    1. Wsp.Anywhere365.SipInterceptor.Service.exe.config
  3. The config should look like:

    XML
    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
    <startup useLegacyV2RuntimeActivationPolicy="true">
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
    </startup><appSettings>
    <add key="urls" value="," />
    </appSettings>
    </configuration>
  4. Add the FQDN of the server

    Note

    Port should be the same as AgentProviderPort in the UCC config.xml (Default 10000), see: Agent Provider Port (Interceptor)

    1. One UCC server:

      XML
      <?xml version="1.0" encoding="utf-8" ?>
      <configuration>
      <startup useLegacyV2RuntimeActivationPolicy="true">
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
      </startup>
      <appSettings>
      <add key="urls" value="http://fqdn1.domain.net:10000" /></appSettings>
      </configuration>
    2. Multiple UCC servers:

      XML
      <?xml version="1.0" encoding="utf-8" ?>
      <configuration>
      <startup useLegacyV2RuntimeActivationPolicy="true">
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
      </startup>
      <appSettings>
      <add key="urls" value="http://fqdn1.domain.net:10000, http://fqdn2.domain.net:10000," />
      </appSettings>
      </configuration>
  5. Open the Services

  6. Start the Interceptor Service

    1. Sip Interceptor Service

(Optional) Configure update interval

  1. Navigate to Install directory

    1. C:\Program Files\SipInterceptor
  2. Open the config:

    1. SipInterceptor.Service201x.exe.config
  3. The config should look like:

    XML
    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
    <startup useLegacyV2RuntimeActivationPolicy="true">
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
    </startup>
    <appSettings>
    <add key="urls" value="," />
    </appSettings>
    </configuration>
  4. Add the following line between <appSettings></appSettings>

    XML
    <add key="updateInterval" value="120" />
  5. The value is in minutes, 60 is each hour, 120 every 2 hours, 1440 is once every day.

Configure the UCC

When the Interceptor is installed each UCC needs to be configured to use the Interceptor.

Skype for Business Application Endpoint

  1. Create a new Skype for Business Application Endpoint for the UCC where the Interceptor is going to be used.
    1. More information about creating a new Application Endpoint, see: Create extra Endpoint.
  2. Name the Endpoint: sip:[uccname]_dr@[domain]

Warning

Make sure the UCC Endpoint have the correct VoicePolicies. If you limit your Global VoicePolicies, the UCC cannot call to PSTN.

SharePoint Configuration - Endpoints

  1. Navigate to the SharePoint Configuration Page of the UCC

  2. Open Endpoint List

  3. Switch to the "DefaultRoutingEndpointView"

  4. Add new DefaultRoutingEndpoint Item

    1. Title = The address of the newly created endpoint (which you have created in part 1)

  5. Restart the UCC

SharePoint Configuration - Settings

  1. Navigate to the SharePoint Configuration Page of the UCC

  2. Open the Settings List

  3. (Optional) Add new Item for Outbound Interception

    Note

    Prior to the DC2024.01 update, the setting was referred to as UseOutboundAudioRecording

    1. Key =EnableOutboundInterception
    2. Value = true
  4. (Optional) Add new Item for Inbound Interception

    Note

    Prior to the DC2024.01 update, the setting was referred to as UseInboundAudioRecording

    1. Key = EnableInboundInterception
    2. Value = true
  5. (Optional) Add new Item to show Agent identity when calling outbound

    1. Key =UseOriginalIdentityWithOutbound
    2. Value = true
  6. (Optional) Add new Item to show Caller identity directly with inbound calls

    1. Key =UseOriginalIdentityWithInbound
    2. Value = true
  7. (Optional) Add new Item to ignore internal calls (same domain)

    1. Key = InterUserRecordingDisabled
    2. Value = true

The Interceptor always needs setting 'EnableOutboundInterception' or 'EnableInboundInterception' (or before DC2024.01, 'UseOutboundAudioRecording' or 'UseInboundAudioRecording') . With both on false, the Interceptor won't intercept any calls going in or out the UCC.

When the Interceptor is installed and configured correctly, you will see the following lines within the log of the UCC:

Logs
DEBUG ApplicationBootStrapper - ApplicationBootStrapper AgentProvider. Connected: 10.0.0.0 : frontendserver.fqdn.local
DEBUG ApplicationBootStrapper - ApplicationBootStrapper AgentProvider. Register: , 10.0.0.0 : frontendserver.fqdn.local

If you don't see these lines, please make sure the correct Firewall settings are applied on the AnywhereNow UCC server.