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

Enable the use of SSL with the DX API

  • Dark
    Light
  • PDF

Article Summary

For versions of Analytics greater than 9.5.1

  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_http.config: \Webtrends\Data Extraction Website\v2_1\web.config.
  4. Rename the following file to web.config: \Webtrends\Data Extraction Website\v2_1\web_ssl.config.
  5. Restart the site in IIS Manager and attempt to access it via https..

For versions of Analytics prior to 9.5.1

Note: Configuration and implementation of SSL in OnPremises installations is outside of the normal bounds of Webtrends Technical Support. As environments may vary, 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?