Developer's Guide

Sample Documents

Web Service Operations

 

URL Linking Package

Purpose

This interface allows you to link directly to the ELSonline.net web site and automatically login. By using the procedure described below, your users may seemlessly get to our web site from your programs without ever needing to know a username or password. This is beneficial when security prevents your end-user from knowing a username/password.

General Notes

  1. The URL linking package accepts only the HTTP POST method. GET, HEAD, etc are not supported. This is for security so that sensitive data is not seen as part of a URL in a browser.
  2. HTTPS is available where maximum security is desired (simply replace the http in any URL listed in this document with https).
  3. At a minimum, requestType, username, and password are required for each linking action desired. The value of requestType specifies which part of the ELSonline.net site you wish to link to. The username and password values will be supplied by an ELS representative.
  4. All pages of the ELSonline.net site are designed for an 800 x 600 full-screen browser window. Please keep this in mind when providing space in you web site if you wish to place our pages within a frame.
  5. To view completed products, your users will need to have Adobe Acrobat Reader installed on their computers.

Information Your Need from ELS

Name Purpose Your Value (provided by ELS sales rep)
URL Accepts your login request and, upon validation of the data elements, provides access to ELSonline.net https://www.elsonline.net/lalogin.aspx
username Identifies your account provided by ELS
Password Secures your username Provided by ELS
contactID Identifies a specific individual from your organization. If supplied, then specific settings based on just this user are applied. Provided by ELS (based on your username's setup)
Hash Provides an extra layer of security. This is a code generated from data based on your login information that must be sent with your login request to verify that the request is valid. Provided by ELS (generated from your username)

Testing Your Login

This is a sample HTML document you can use to test your login:

<html>
<head>
<title>ELSonline.net Login Form POST Test</title>
</head>
<body>
<h1>ELSonline.net Login Test</h1>
<form name="login" id="login" action="https://www.elsonline.net/lalogin.aspx" method="post">
<p>Username: <input type="text" name="username" id="username"></p>
<p>Password: <input type="password" name="password" id="password"></p>
<p>Hash: <input type="text" name="hash" id="hash"></p>
<p>Contact ID: <input type="text" name="contactID" id="contactID"></p>
<p><input type="submit" value="Test Login" id="Submit1" name="Submit1"></p>
</form>
</body>
</html>