Enable the use of SSL with the DX API
  • 27 Apr 2021
  • 1 Minute to read
  • Contributors
  • Dark
    Light
  • PDF

Enable the use of SSL with the DX API

  • Dark
    Light
  • PDF

Note: Configuration and implementation of SSL in OnPremises installations is outside of the normal bounds of Webtrends Technical Support. The following is provided 'AS IS' to allow customers to compy with security requirements within their organization. Make sure that the site is operating properly with http before attempting to implement https.

  1. Add an SSL certificate to your DX API site using IIS documentation
  2. After the site is configured for SSL, go to the Webtrends installation directory on the DX API server
  3. Make a copy of the following file and rename it to web_orig.config: \Webtrends\Data Extraction Website\v2_0\web.config
  4. Open the \Webtrends\Data Extraction Website\v2_0\web.config file
  5. Find the following lines:
        <binding name="RawMapper">
			<webMessageEncoding webContentTypeMapperType="Webtrends.DataExchange.WebServices.RawMapper, Webtrends.WebServices" />
			<httpTransport manualAddressing="true" /> 
        </binding>
  1. Change the httpTransport to httpsTransport.
        <binding name="RawMapper">
			<webMessageEncoding webContentTypeMapperType="Webtrends.DataExchange.WebServices.RawMapper, Webtrends.WebServices" />
			<httpsTransport manualAddressing="true" /> 
        </binding>
  1. Find the following lines:
      <serviceBehaviors>
        <behavior name="WebtrendsAuth" />
        <behavior name="Webtrends.Webservices.SyndicationServiceBehavior">
          <serviceMetadata httpGetEnabled="true" />
          <serviceDebug includeExceptionDetailInFaults="false" />
        </behavior>
        <behavior name="Webtrends.Webservices.ImageServiceBehavior">
          <serviceMetadata httpGetEnabled="true" />
          <serviceDebug includeExceptionDetailInFaults="false" />
        </behavior>
      </serviceBehaviors>
  1. Change the serviceMetadata to include httpsGetEnabled="true".
      <serviceBehaviors>
        <behavior name="WebtrendsAuth" />
        <behavior name="Webtrends.Webservices.SyndicationServiceBehavior">
          <serviceMetadata httpGetEnabled="true" httpsGetEnabled="true" />
          <serviceDebug includeExceptionDetailInFaults="false" />
        </behavior>
        <behavior name="Webtrends.Webservices.ImageServiceBehavior">
          <serviceMetadata httpGetEnabled="true" httpsGetEnabled="true" />
          <serviceDebug includeExceptionDetailInFaults="false" />
        </behavior>
      </serviceBehaviors>
  1. Restart the site in IIS Manager and attempt to access it via https.

Was this article helpful?