AuthControl Mobile Authenticator iOS¶
Overview¶
This article describes functionalities and behaviour of the AuthControl Mobile Authenticator (AMA) application for iOS platform. AMA is an application that works with OATH offline policy and can be provisioned on many devices with the same provisioning code. AuthControl Mobile Authenticator (AMA) application is to constraint functionalities for OATH offline local policy only. Expected behaviors are detailed on the functional procedures section in this article.
Features¶
Request help After provisioning the application, users can navigate to the Others info and request administrator help via email or via call.
Logging Swivel Secure applications have now been implemented with logging which helps both users and administrators to tackle any possible issues with local and/or external integrations.
View settings After provisioning the application, users can navigate to the Others info and check Show settings for configuration details.
Multiple provisioned devices AMA can be provisioned with the same provision code in many different devices.
Requirements¶
- AuthControl Sentry 4.1.2 or higher
- The Swivel virtual or hardware appliance must be reachable from the mobile phone to receive security codes
- Valid certificate on the Swivel server or non SSL, but not a self signed certificate
App Installation and Configuration¶
The AMA application is available from the Apple App Store. You can click on the link below to open the App within the Apple App Store.
AuthControl Mobile Authenticator.
Downloading the App via the Provision Email
- When you open the App Provision email a link to the App Store will be presented.
- Alternatively if you open the App Provision on the device and press Activate, you will see a button ‘Get The App’, which will also take you to the App Store.
Initial Steps¶
When first downloading and setting up AMA mobile application, you will be asked to grant the AMA app certain permissions. Below you find explanations for why each of these permissions is required by the app.
Camera Permission
AMA requires camera access to a user’s mobile for when the provision QR code is sent to the user. The QR code makes the provisioning quicker and smoother.
Biometrics Permission
AMA requires biometrics and/or PIN permissions to secure information. The mobile is either corporate or carries corporate information, the phone must have the least security set up.
In order to have a fast operative and smooth experience with the application, please provide it all requested permissions.
AMA Configuration¶
SSD Server Configuration
This configuration is performed by Swivel Secure team on deployment. Policy for AMA is to be set as Local + OATH in the server.
Sentry Policy Configuration
Sentry Policy > Mobile App. Then set tag Mobile App Local Mode to NO and Mobile App OATH Mode to YES.
Provision code with this policy setup will work only on AMA application. Any other policy setup will not work with AMA application.
AMA Provisioning¶
Before provisioning it’s assumed that Sentry has the users, repositories, groups, transport and rights properly setup.
The provision process is not different from our previous mobile application versions. When you first open the application you will be taken to a “Let’s add your first provision” screen with the button to scan QR code in the bottom.
After configuration is properly setup go to User Administration, select the desired user to be provisioned and press button App Provision.
An email with the provision code will arrive to the user’s e-mail. Keep or save this e-mail. AMA application will provision as many devices as many times as needed by the user with the same provision code. If a new provision code is requested, previous provision code will be erased and all devices with the old provision should be deprovisioned by the user. Requesting new provisioning while the old provision is in place, will affect current provisioned devices and it won’t work anymore.
Steps:
- QR Code will launch a camera and your Apple device will ask you to grant permissions for the Swivel application to use the Camera.
- If the user clicks on the Manual Configuration they are taken to the Manual Configuration Screen.
Your AMA is now provisioned and ready for usage.