LoginTC iOS App Guide

Overview

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

Requirements

  • iOS device (iPhone, iPad, iPod Touch)
  • iOS 6+
  • A working Internet connection (e.g. Wi-Fi, 3G, 4G)

Installation

  1. Open the Apple App Store app from your home screen
  2. Search for LoginTC (iPad users: ensure iPhone Only option is selected)
  3. Press the Download button

Note: Push Notifications

When you launch LoginTC for the first time. You must allow push notifications for LoginTC to work.

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. Click Next to confirm that this a token for the correct domain
  4. Enter the 10-character alphanumeric activation code provided to you by your administrator
  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 Next
  9. 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 Revoke Token button at the bottom
  4. Press the Revoke Token button in the dialog twice to confirm

Request Notifications

You will receive a push notification to your mobile device when you attempt to log into a LoginTC-enabled service. Tap or slide the notification to open it and view the LoginTC Request. If your mobile device is in standby mode or locked, the notification will be presented on your lockscreen:

If your mobile device is on and running, you will be presented with a notification at the top of your screen.

Tap on the notification or swipe down to view the Notification Center.

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

The Diagnostics page is a tool to help you identify problems if your LoginTC app is not working properly. 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 Settings button in the top left-hand corner and click on Settings
  3. Open the Diagnostics page
  4. Click 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 your phone Notification settings. LoginTC Requests require that you have iOS push notifications enabled on your mobile device. To ensure that you have iOS push notifications enabled, follow these instructions:

  1. Open the Settings app from your home screen
  2. Scroll down and tap on Notification Center

  3. Scroll down and tap on LoginTC

  4. Ensure that :
    • Allow Notifications is set to ON
    • Show in Notification Center is set to 1, 5, or 10 (not None)
    • Show on Lock Screen is set to ON
  5. Ensure that Alert Style When Unlocked is set to Banners or Alerts

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

Unable to Load a Token: Unable to register your device with LoginTC

Push notifications are required for the LoginTC app to operate. This also includes loading new tokens. Review Receiving push notification for the appropriate Notification Center settings.

Use the Diagnostics Tool to test the settings.

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 the internet connection or the notifications settings.

Not Receiving LoginTC Requests (After Upgrading to iOS 8)

If you are not receiving LoginTC push notifications after upgrading to iOS 8, follow these instructions:

  1. Open the LoginTC app from your home screen
  2. If prompted to allow push notifications, allow by pressing OK
  3. Leave the app open while authenticating for the first time

If this does not resolve the issue, delete the application, re-install it, and contact your administrator to re-issue the token.

Not Receiving LoginTC Requests (After Upgrading to iOS 9 on an iPad)

If you are using an iPad, and if you are not receiving LoginTC push notifications after upgrading to iOS 9, contact your administrator to re-issue you your token.

Port Unblocking

If you are using your iOS device on a Wi-Fi network, and you are still unable to receive push notifications, ask your network administrator to unblock the following TCP ports: 5223, 2195, 2196, 443. Please see http://support.apple.com/kb/TS4264 for more details.