LoginTC Chrome App (Legacy) Guide

Important: LoginTC Chrome App End-of-life

Google has announced that starting in 2018, Chrome Apps will no longer be supported. In preparation for this change, we have converted the LoginTC Chrome App into the LoginTC Chrome Extension. To migrate your LoginTC tokens from the LoginTC Chrome App to the LoginTC Chrome Extension, ask your administrator to re-issue you your LoginTC tokens. Please see the LoginTC Chrome Extension Guide for more information on how to use and install the LoginTC Chrome Extension.

Overview

This guide covers the installation and usage of the LoginTC app for Chrome. The LoginTC desktop application for Chrome browsers acts as a credential to the LoginTC platform. It uses Google’s secure Push Notification Service to notify you of LoginTC requests.

Requirements

  • Chrome 37+
  • A Google account
  • A working Internet connection

Installation

  1. Sign in to Chrome if you are not already signed in. Go to the Chrome Settings page (click on the Settings menu or type in chrome://settings and click on the Sign in to Chrome button. Sign in using your Google (e.g. Gmail) account. If you do not have a Google account, you can create one on the sign in page.
  2. Go to LoginTC page at the Chrome Web Store: https://chrome.google.com/webstore/detail/logintc/kkaagmbfdmbmigppggbijiohfcphecli
  3. Press the + FREE button
  4. Confirm. LoginTC requires a permission to know your email address. Press the Add button

Usage

Note: Chrome Must Be Running And User Must Be Signed In

The Chrome browser must be running and you must be signed into Chrome for you to receive push notifications. If Chrome is not running, you will receive the notification the next time you open and sign into Chrome. To check if you are signed in navigate to chrome://settings and under Sign in section it should display Signed in as . Click Sign in to Chrome button if not signed in. A signed in user will only have access to their LoginTC tokens.

Launching App

Once installed, LoginTC can be launched by entering chrome://apps into the Chrome navigation bar and clicking on the LoginTC icon.

Adding Token

Adding a token to the LoginTC app enables you to use your desktop as a credential to log into LoginTC-enabled services. The LoginTC app can hold one or more tokens – one for each LoginTC-enabled service.

  1. Open the LoginTC app
  2. Press the Add Token button. You will see a brief tutorial if this is the first time you’ve opened the app.
  3. Enter the 10-character alphanumeric activation code provided to you by your administrator
  4. Press Enter
  5. Press Next
  6. Choose a 4-digit PIN. You will enter this PIN to approve LoginTC requests. You may choose a different PIN for each LoginTC-enabled service.
  7. Confirm the 4-digit PIN by entering it in again
  8. Press Enter
  9. Your token is loaded on your app and you may now log in using LoginTC

Revoking Token

Tokens are generally revoked on the server-side by your administrator, but you may also revoke the token directly from the app. Follow these instructions to revoke your token:

  1. Open the LoginTC app
  2. Click on your token in the token list
  3. Click on Revoke Token from the menu
  4. Click on Revoke Token to confirm

Request Notifications

You will receive a push notification to your desktop when you attempt to log into a LoginTC-enabled service with the credential installed in your LoginTC Chrome app. Click on the notification to open it and view the LoginTC Request.

Note: Chrome Must Be Running And User Must Be Signed In

The Chrome browser must be running and you must be signed into Chrome for you to receive push notifications. If Chrome is not running, you will receive the notification the next time you open and sign into Chrome. To check if you are signed in navigate to chrome://settings and under Sign in section it should display Signed in as . Click Sign in to Chrome button if not signed in. A signed in user will only have access to their LoginTC tokens.

Note: Signing Out of Chrome

If you sign out of Chrome and then sign back in, you will receive an email asking you to click on a link to confirm your session. You will not receive push notifications until you click on this link.

Request Polling

If your administrator has Request Polling enabled for your domain, you can launch pending LoginTC requests directly from the token list by pressing the refresh button in the top toolbar. If there’s a pending request for your token it will pop up a new window for that request.

Approving Request

When you receive and open a LoginTC Request, you will be presented with contextual information about the request to help you decide if it’s legitimate or not and two buttons: Approve and Deny. Press one of the buttons to approve or deny the request.

Press the Approve button and enter your 4-digit PIN to approve.

Upon successful approval, the window will close and you will briefly see a notification informing you of the success:

Denying Request

You can also deny the request if you did not initiate it. Select a reason for the denial:

Diagnostics

If you are having trouble receiving push notifications, go to to the Diagnostics page to perform an end-to-end test of the LoginTC push notification system:

  1. Open the LoginTC Chrome app
  2. Click on the menu in the left-hand corner and select Settings
  3. Under General, click Diagnostics
  4. Press the Perform Test button

Test 1: Connecting to LoginTC Server

If this step fails then there is a problem with your Internet connection. Double check your computer’s network configurations to ensure that you are connected. You can also try restarting your router.

If this does not resolve the problem, then most likely your network connection is not sufficiently strong. Try a different network or contact your internet service provider.

Test 2: Issuing remote push notification

If this step fails it is most likely fail a server side issue. Wait a few minutes and try the Diagnostics test again.

Test 3: Receiving push notification

If this step fails, make sure that the necessary ports are unblocked - you can find out more about this in the Port Unblocking section.

Test 4: Verifying push notification

If this fails it is most likely fail a server side issue. Wait a few minutes and try the Diagnostics test again.

Visit the Help Page if you require further assistance resolving the problem.

Troubleshooting

Not Receiving LoginTC Requests

Use the Diagnostics Tool to help determine why you are not receiving LoginTC requests. Most likely it is a problem with your internet connection or your notifications settings.

Port Unblocking

If you are unable using a Wi-Fi network and are unabto receive push notifications, ask your network administrator to unblock the following TCP ports: 5228, 5229, 5230. Please see https://developers.google.com/cloud-messaging/ for more details.

Frequently Asked Questions

  • Question: Do I have to have Chrome running to receive notifications?
    • Yes. You must have at least one Chrome window or Chrome app running to receive LoginTC request notifications. If you do not have a Chrome window open or Chrome app opened, you will receive pending LoginTC request notifications as soon as you open a Chrome window or a Chrome app.
  • Question: Do I have to use Chrome as my web browser for LoginTC to work?
    • No. As long as Chrome is installed and running users can use the web browser of their choice or other desktop/laptop applications (like Cisco AnyConnect) to access the Internet and their protected content.