.Stat Data WareHouse Exit Gate - Authentication
Use this service to authenticate yourself and initialize or refresh a session for accessing .Stat
The following operations are supported. For a formal definition, please review the Service Description.
-
Authenticate
WARNING: This method is obsolete! Please use AuthenticateWithLogonUpdate instead!
For authentication of external users (step n° 2)
This method must be called right after the 'GetPublicKey' method and BEFORE any other .Stat web service method is used.
Please provide the user name, domain and encrypted password as method parameters.
Use the public encryption key as returned by the 'GetPublicKey' method to encrypt the password.
.NET Example:
using System.Security.Cryptography;
RSACryptoServiceProvider rsa = new RSACryptoServiceProvider();
rsa.FromXmlString(publickey);
string encryptedpassword = Convert.ToBase64String(rsa.Encrypt(System.Text.Encoding.Unicode.GetBytes(password), false));
If you have been successfully authenticated then the method returns a string with your session ID, otherwise an exception.
Provide this session ID, your user name and the domain to all other .Stat web service methods as parameters in the SOAP header.
-
AuthenticateWithLogonUpdate
For authentication of external users (step n° 2)
This method must be called right after the 'GetPublicKey' method and BEFORE any other .Stat web service method is used.
Please provide the user name, domain and encrypted password as method parameters.
Use the public encryption key as returned by the 'GetPublicKey' method to encrypt the password.
.NET Example:
using System.Security.Cryptography;
RSACryptoServiceProvider rsa = new RSACryptoServiceProvider();
rsa.FromXmlString(publickey);
string encryptedpassword = Convert.ToBase64String(rsa.Encrypt(System.Text.Encoding.Unicode.GetBytes(password), false));
If you have been successfully authenticated then the method returns a string with your session ID and updates the username, otherwise an exception is thrown.
Provide this session ID, your updated user name and the domain to all other .Stat web service methods as parameters in the SOAP header.
-
GetPublicKey
For authentication of external users (step n° 1)
This method must be called once BEFORE any other method is used.
The method returns a string with the public key used to encrypt the password needed for the 'Authenticate' method.
-
Ping
For all users (optional step n° 3)
This method tests if your session for accessing .Stat web services is still open.
If successful, the expiration time counter is reinitialized and the method returns the string 'Pong'.
Provide the session ID, your user name and the domain as parameters in the SOAP header.
-
SSOAuthenticate
For authentication of external SSO users of OECD applications
This method must be used only be OECD applications.
Provide the SSO token ID (as retrieved from the SSO ServiceLogin method) as method parameter.
If the SSO token ID has been successfully verified then the method returns a string with your .Stat session ID, otherwise an exception.
Provide this session ID, the user ID and the corresponding domain to all other .Stat web service methods as parameters in the SOAP header.
-
WindowsAuthenticate
For authentication of internal users (step n° 1+2)
This method must be called BEFORE any other .Stat web service method is used.
Make sure to explicitely provide the user credentials to this web service.
.NET Example:
WebService.Credentials = System.Net.CredentialCache.DefaultCredentials;
OR:
WebService.Credentials = new System.Net.NetworkCredential(username,password,domain);
If you have been successfully authenticated (using Integrated Windows Authentication) then the method returns a string with your session ID, otherwise an exception.
Provide this session ID, your user name and the domain to all other .Stat web service methods as parameters in the SOAP header.