How to use our Knowledge BaseAccess Custom Registration URLCustom Registration URL Technical Details

Custom Registration URL Technical Details

When directed to your custom registration URL, the user will be passed with three additional variables:

 

btx_i - Issue ID
btx_pub_id - Publisher ID
btx_m - Publication ID

Your URL should have two fields for login: one for login name and another for password. This form should submit to the desired domain + "/publication/logincheck.php" (e.g., http://www.mydigitalpublication.com/publication/logincheck.php).

The fields should be named reader_login for the entered login, reader_password for the entered password, pub_id for the Publisher ID, and either "i" for the Issue ID (if a specific issue ID is requested) or "l" set to 1 and "m" set to the desired Publication ID (if the latest issue of a publication is desired).

1. Here is an example of an HTML form for a specific issue ID:

<form action="http://www.mydigitalpublication.com/publication/logincheck.php" method="post">
  Username: <input type="text" name="reader_login" />
  Password: <input type="password" name="reader_password" />
  <input type="hidden" name="pub_id" value="9999" />
  <input type="hidden" name="i" value="99999" />
  <input type="submit" value="Submit" />
</form> 

2. Here is an example of an HTML form for the latest issue for a specific publication ID:

<form action="http://www.mydigitalpublication.com/publication/logincheck.php" method="post">
  Username: <input type="text" name="reader_login" />
  Password: <input type="password" name="reader_password" />
  <input type="hidden" name="pub_id" value="9999" />
  <input type="hidden" name="m" value="9999" />
  <input type="hidden" name="l" value="1" />
  <input type="submit" value="Submit" />
</form> 

3. You can also pass the reader to a custom authentication failure page by specifying the parameter "err" whose value should be set to the full URL of the custom page:

 <input type="hidden" name="err" value="http://www.somedomain.com/path_to_error_page.html" />

Note: SSL security for authentication is available using the method below.

An alternate method is available if you require a secure method for login that does not transmit username and password except using an SSL-encrypted connection. The form structure is exactly the same as that described above, with two exceptions:

 

1. The "action" must be set to "https://www.mydigitalpublication.com/publication/logincheck.php" (note the "s" in "https") regardless of the desired target domain.

 

2. Another hidden field for the target domain (targ_dom) must be set:

 

<input type="hidden" name="targ_dom" value="somedomain.com"/>

Note: Using this method, login credentials are passed securely, but the digital edition itself is served up on an insecure connection. Serving up the digital edition completely under an SSL connection is unavailable as a hosted service.