LoginTC Android App Guide

Overview

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

Requirements

  • Android device
  • Android 2.2+
  • A working Internet connection (e.g. Wi-Fi, 3G, 4G)

Installation

  1. Open Google Play app from your applications
  2. Search for LoginTC
  3. Press the Install button

Usage

Adding Token

Adding a token to the LoginTC app enables you to use your mobile device 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
  3. Enter the 10-character alphanumeric activation code provided to you by your administrator
  4. Press Next
  5. 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.
  6. Confirm the 4-digit PIN by entering it in again
  7. Press Next
  8. Your token is loaded 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 your mobile device. Follow these instructions to revoke your token:

  1. Open the LoginTC app
  2. Press your token in the token list
  3. Press the dropdown menu in the top right
  4. Press the Revoke option and confirm your action when prompted in a dialog

Request Notifications

You will receive a push notification to your mobile device when you attempt to log into a LoginTC-enabled service. Tap on the notification to open it and view the LoginTC Request.

Request Polling

If your administrator has Request Polling enabled for your domain, you can launch pending LoginTC requests directly from the token list by pulling down on the token list. If there’s a pending request for your token it will be displayed after pulling down from the top.

Approving Request

When you receive and open a LoginTC Request, you will be presented with 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.

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 app
  2. Press the dropdown menu and click on Settings
  3. Open the Diagnostics page
  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. If you are using Wi-Fi, check that it is enabled and that your phone is connected to a network with a strong wi-fi signal. If you are using 3G or 4G networks, check that mobile networking is enabled and that service is provided in your area.

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

Test 2: Issuing remote push notification

If this 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, check that Notifications are enabled for your app.

  1. Open your phone’s Settings app
  2. Select Apps (on some devices this is called the Application Manager)
  3. Find the LoginTC app and open it
  4. Check that Show notifications is enabled

You must also have a working Internet connection to receive push notifications. 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 application permissions.

Port Unblocking

If you are using your Android device on a Wi-Fi network, and you are unable to receive push notifications, ask your network administrator to unblock the following TCP ports: 5228, 5229, 5230. Please see https://developer.android.com/google/gcm/http.html for more details.