Publisher Site Login

Last modified March 25, 2020

For Web

Publisher Site Login authentication restricts access to a digital issue or archive to users who access the magazine via link in a specified web site or sites, the “referrer URL.” The referring url would contain links to the magazine, and be a page that is only accessible to logged-in members.

Multiple referrer urls may be specified for a given title. But, if multiple titles are accessible via the same referring page, GTxcel can not distinguish access restriction for each title, so users would have access to all titles listed on that referring page.

If a user tries to view the digital magazine without having come first from the referring url, he/she will be redirected to a specified alternative URL. We suggest setting the redirect to an error message page with instructions or a login to the required referrer site.

Note 1: A referrer URL is considered a “match” if it matches the first “base” part of the specified referring url.

For example, if the specified referrer URL is: http://www.url1.com/

then: http://www.url1.com/foo/  would also be considered a valid referrer, because the first part of the url matches one of the specified referrer URL values.

However, if the specified referring url is http://www.url1.com/foo/

then http://www.url1.com/ would not be a valid referrer.

Note 2: In order for the referring url to be preserved, the calling page can’t use a javascript window.open call to open the magazine url since that causes the referrer to be dropped in Internet Explorer. Also, the calling page must call the magazine url directly and can’t use a redirect or the referrer may get dropped.

Note 3: Referring URL should be HTTP. If digital edition domain is HTTPS, referring URL may also be HTTPS.

For Apps

Definition

Publisher Site Login Access is ideal for those publishers who already have a log in feature on their website and wish for people to access the digital edition through the publisher’s log in page.  In addition, publishers who do not wish to or are not able to provide subscriber email addresses to GTxcel can create a mobile version of their sign-on page that GTxcel will use in the app to grant access.

Using this mechanism provides users with access to all issues available in the app; there is no ability to restrict access to specific issues that have been converted for the app.

Recommended for:

  • Association publishers
  • Publishers using their own user authentication access to the web digital edition

Publisher Setup/Requirement:

  • Publisher login URL – Must be secure (https) & mobile optimized and must NOT contain any methods of subscribing or registration. (sign-in only) – Here is an example of an acceptable login page: https://watermelon.ag/vinelinelogin/
  • Success URL  (This page will not actually be displayed to the app reader, but will be used by the app to recognize that the publisher has verified this reader.)
  • Test account, including username and password. This is required to provide to Apple as part of the submission process in order for the app to be approved

Guidelines for Mobile Optimized Sign-In Page:

Mobile browsers require simple and clean HTML in order for the page to display and function properly.  Often times, the sign in page that is used for standard web browsing will not render on mobile devices. Some publishers choose to create a new sign in page specifically for mobile devices, per our recommendation.  This alleviates the need to try to balance the elaborate HTML that many publishers prefer to have on a standard web browser with the limitations of mobile browsers.

Here are some guidelines for creating your mobile optimized sign-in page:

  • Create simple HTML.
  • Remove any extra or unneeded div tags and tables.
  • Do not use HTML that is created from programs such as Microsoft Word or Dreamweaver as these tend to create HTML that is not clean and simple.
  • Do not include Flash on this page, as it will not display on mobile devices
  • Test the sign in page on both a mobile Safari browser and a mobile Android browser to confirm that the page displays and functions as expected.
  • Must be secure (https)
  • May NOT  contain methods for subscribing or registering.
  • Should only contain option to log in (per Apple & Amazon policies).
  • Example of a good sign in page:
    • If you are using the user agent as part of the login page, be lenient about how you grant access. The internal webview used by the app is a slightly different browser string than mobile safari. Please consult a resource like http://www.useragentstring.com/pages/Safari/ to determine the appropriate user agent specifications to use. At the time of this writing, the user agent for mobile safari and the internal webview are similar to:

Mobile Safari: Mozilla/5.0 (iPod; U; CPU iPhone OS 4_3_5 like Mac OS X; ja-jp) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8J2 Safari/6533.18.5

Internal iOS Webview: Mozilla/5.0 (iPod; U; CPU iPhone OS 4_3_5 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Mobile/8L1

Guidelines for Success URL:

The success URL is a critical piece to making the Publisher Site Login Access work correctly.  Here are some items to consider when providing the success URL:

Flow:

User installs app with an immediate view of all cover images.  Each cover image will display a preview button.

Technical Explanation:

From a technical standpoint, the way our apps determine login success is as follows:

  1.  When a user attempts to access any portion of the app that contains restricted content, the app opens a web view containing the login URL
  2. Every time the user visits a new page within the web view, the app reads the URL
  3. If the URL matches the success URL using the regular expression ~ /^$success_url/   we immediately close the window and grant access to all restricted content within the app. Note that we only check that the URL visited by the user starts with the success URL that was provided. So if your success URL is http://website.org/success, we will still grant access to http://website.org/success/myaccounthttp://website.org/success.html or http://website.org/success?key=value&key2=value
Need Help?
The Digital Help Desk is the process for communicating with GTxcel regarding new title setups, questions, and technical issues for the Web Reader and/or Apps.

You can submit a request to us through the Request Help button located in the Publisher Dashboard or call the support number: 800-609-8994, option 3.
Contact Us GraphicContact Support
8AM - 5PM EST
Monday to Friday
800-609-8994, option 3
Response Times
General Question/Requests – A Customer Success team Member will begin working on your request within one to two hours of receipt. We will complete the request as soon as possible; we aim to have all requests completed within 24 hours.