Browse
 
Tools
Rss Categories

VTCTIManagerService.exe.config

Reference Number: AA-02246 Views: 240 0 Rating/ Voters

The CTI Service is configured using the VTCTIManagerService.exe.config file, which contains various settings in XML format. The important sections within this file are described below. Any settings that are not explicitly mentioned here should not be adjusted unless directed to do so by LumenVox support personnel.

The most important configurations to provide in this file are basically the certificate thumbprint and the client end point in case of using VTassure.


Configure SSL Connections

Add or modify a service behavior configured for SSL connections, for instance "CTIManagerWebServiceBehavior" below (to retrieve the proper certificate thumbprint, see below):

 

    <behaviors>
      <serviceBehaviors>
        <behavior name="CTIManagerWebServiceBehavior">
          <serviceCredentials>
            <clientCertificate>
              <authentication certificateValidationMode="ChainTrust" revocationMode="NoCheck"
              trustedStoreLocation="LocalMachine" />
            </clientCertificate>
            <serviceCertificate findValue="c44d49af40a47f75fb335e1f15982bff92be11b1"
                    storeLocation="LocalMachine" storeName="My" x509FindType="FindByThumbprint" />
          </serviceCredentials>
          <serviceMetadata httpsGetEnabled="true"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>


Configure HttpBinding

Add a new binding under <wsHttpBinding> configured for security mode Transport:

<bindings>
    <wsHttpBinding>
        <binding name="wsHttpBindingSecurity" maxReceivedMessageSize="2147483647">
            <security mode="Transport">
                <transport clientCredentialType="Basic"/>
            </security>
        </binding>


        ...


    </wsHttpBinding>
</bindings>


Configure binding:  

Configure the service to use the previous behavior and binding:

<services>
    <service name="VTCTIManager.WebService.CTIManagerWebService" behaviorConfiguration="CTIManagerWebServiceBehavior">
        <endpoint address="" binding="wsHttpBinding" bindingConfiguration="wsHttpBindingSecurity" contract="VTCTIManager.WebService.ICTIManagerWebService"/>
        <endpoint address="mex" binding="mexHttpsBinding" contract="IMetadataExchange"/>
    </service>
</services>

 


 To retrieve a certificate's thumbprint

  1. Open the Microsoft Management Console (MMC) snap-in for certificates. (See How to: View Certificates with the MMC Snap-in.)
  2. In the Console Root window's left pane, click Certificates (Local Computer).
  3. Click the Personal folder to expand it.
  4. Click the Certificates folder to expand it.
  5. In the list of certificates, find a server certificate (can be a wild card server certificate, or a self signed server certificate..).
  6. Double-click the certificate.
  7. In the Certificate dialog box, click the Details tab.
  8. Scroll through the list of fields and click Thumbprint.
  9. Copy the hexadecimal characters from the box. If this thumbprint is used in code for the X509FindType, remove the spaces between the hexadecimal numbers. For example, the thumbprint "a9 09 50 2d d8 2a e4 14 33 e6 f8 38 86 b0 0d 42 77 a3 2a 7b" should be specified as "a909502dd82ae41433e6f83886b00d4277a32a7b" in code.