Data Quality user documentation
home/Address validation/Address Validate SOAP/Get started/Prerequisites

Prerequisites

In order to access address searching and verification functionality, the request has to be authenticated.

New user?

You have to use the provided token:

  1. Retrieve your token from Self Service Portal > Licenses.
    If you don't have one yet, go to Self Service Portal > Licenses, click Add a Token and enter the required details.
  2. Enter your token as the value for auth-token field under the HTTP Header.

Migrating from On Demand?

Use your current integration username and password or the SAML header. Refer to Ways to integrate for details.

Authentication sample code

/// <summary>
/// This class inheriting System.Web.Services.Protocols.SoapHttpClientProtocol
/// </summary>
protected override System.Net.WebRequest GetWebRequest(Uri uri)
{
    System.Net.HttpWebRequest request = (System.Net.HttpWebRequest)base.GetWebRequest(uri);
    request.Headers.Add("Auth-Token", this.AuthToken);
    return request;
}

$str_auth_header = "Auth-Token:" . AUTH_TOKEN;
$arr_context = array('http' => array('header' => $str_auth_header));
$obj_context = stream_context_create($arr_context);

$this->soap = new SoapClient($endpointURL,
                             array('soap_version' => SOAP_1_2,
                                   'exceptions' => 0,
                                   'classmap' => array('QAAuthentication' => 'QAAuthentication',
                                                       'QAQueryHeader' => 'QAQueryHeader'),
                                   'stream_context' => $obj_context));

Software

Component Recommended Other Options
Operating System Windows Server 2008 R2 SP1 (64 bit) Other Windows operating system (32 or 64 bit) which supports .NET
Web Server C# and PHP: IIS version 7.5 or later IIS versions 5.1, 6 or 7
Web Browser Internet Explorer versions 8
Chrome v43.0.2357.132 and later
Firefox v38.0.5 or later		 Internet Explorer versions 6, 9 or 10
Software Framework C#: .NET 4.5.2 or later .NET 2.0 SP2 (ASP.NET)
PHP: PHP 5.5, with FastCGI installed, and SOAP and OpenSSL extensions enabled. PHP 5.2 or later, with FastCGI installed, and SOAP and OpenSSL extensions enabled.
Token authentication is not supported for this PHP version.

Hardware

Component Recommended Other Options
CPU Intel Core Duo Other dual-core processor
RAM 2 GB 1 GB or more
Hard disk Approximately 30 MB N/A
Address Validate SOAP

Get started