Asset Amway ID Biometric Component 1.0.2

Downloadable Asset:

com.alticor.biometric.zip

Developer Guide Documentation:

biometric_marketplace_component_template.docx

Asset Version:

1.0.2

Asset Description:

Amway ID supports Biometric as a component to integrate anywhere in your app, to Enable/Disable the Biometric authentication in your app. Ex: Menu, User Profile, etc. This component supports Face ID, Touch ID for iOS, and Fingerprint for Android.

Details:

Documentation bug fix
 1Overview

Biometric -Authentication allows users to confirm their identity with a single touch. With this component, you can add Face ID, Touch ID or Fingerprint recognition to your app. Drag and drop the component in your app, configure few properties and you are ready to go.

Amway ID supports Biometric as a component to integrate anywhere in your app, to Enable/Disable the Biometric authentication in your app. Ex: Menu, User Profile, etc.

This component supports Face ID, Touch ID for iOS and Fingerprint for Android.

2Getting Started with the AmwayID Biometric component

This is a Getting Started section for the Amway ID Biometric. It contains information about importing and running the component.

For information about the Dynamic Usage, Properties, Events, and APIs of the component, you can visit the Reference Section.

Before you start using the Amway ID Biometric component, make sure that you meet all the requirements in the Prerequisites.

3Prerequisites

<ul>
<li>A <a href="https://manage.kony.com/">Kony account</a></li>
</ul>

<ul>
<li>Kony Visualizer V8 SP4, or higher</li>
</ul>

3.1Android

<ul>
<li>USE_FINGERPRINT Permission.</li>
</ul>

Refer to the Section#4.2 Configuring Native Settings (Android) section for more information.

3.2iOS

<ul>
<li>Camera Permissions.</li>
<li>Face ID Permissions</li>
</ul>

Refer to the Section#4.1 Configuring Native Settings (iOS) section for more information.

After you make sure that you meet all the prerequisites, you can expand any of the following drop downs to get details about each step of getting started with the Component.

3.3Source Code

The component source can be found at <a href="https://github.com/AmwayACS/AmwayIDNativeLogin">https://github.com/Amway...

4Importing the Component

Before you start importing the component to Kony Visualizer, you must download the component from the Amway Marketplace website. You can import the marketplace components only into the apps that are of the Kony Reference Architecture type.

To import the AmwayID Biometric component, do the following:

<ol>
<li>Open your app project in Kony Visualizer.</li>
<li>On the File menu, point to Import, and click Component to Library. The Open dialog appears.</li>
</ol>

<ol>
<li>Navigate to the location where you downloaded the component (zip file) on your computer, select the component, and click Open. After Visualizer downloads the component, it opens a window that asks you to enter the metadata for the component.</li>
</ol>

Enter a Library Name, a Collection Name, and a Description if you require one.

<ul>
<li>Library Name - A Library contains component collections and skins. The Library Name specifies the library that you want to import the component into. If the library does not exist, Visualizer will create a new one. 
As an example, let us name the Library as AmwayID.</li>
<li>Collection Name - A collection contains multiple components. The Collection Name specifies the collection that you want to import the component into. If the collection does not exist in the specified library, Visualizer will create a new one. 
As an example, let us name the Collection as Login.</li>
<li>Component Name - This name specifies the display name you want to use for the component in Visualizer. 
By default, the component name is com.alticor.biometric .</li>
<li>After you import the component, you can drag and drop it from the Collection Library onto your form.</li>
</ul>

Save the form now.

After you add the component to a form, you need to configure the native settings of your project. You can refer to the following sections for more information.

4.1Configuring Native Settings (iOS)

To configure the native settings for iOS, you need to perform the following tasks.

<ul>
<li>Provide Camera and Face ID Permissions</li>
</ul>

4.1.1.1Providing Camera and Face ID Permissions

<ol>
<li>From the Project explorer, go to Assets.</li>
<li>Expand Media, right-click Common, and then select Resource Location. 
A file explorer window opens.</li>
<li>Open the infoplist_configuration.json file with a text editor or a code editor.</li>
<li>At the end of the file, type the given code . You can change the description based on your preference.</li>
</ol>

4.2<a href="javascript:void(0);">Configuring Native Settings (Android)</a>

To configure the native settings for Android, follow the given steps.

<ol>
<li>From the left navigation menu, click Project Settings.</li>
</ol>

<ol>
<li>In the Project Settings window, go to Native → Android.</li>
<li>Scroll down to the Manifest Permissions, Tags and Gradle Build Entries section, and then select the USE_FINGERPRINT, select the permission from the left panel and click Add >.</li>
</ol>

4.3<a href="javascript:void(0);">Building and Running your app</a>

After performing all the above steps, you can perform either of the following tasks:

Build and Publish your app (Visualizer Enterprise)

For more information, you can refer to the <a href="http://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Defaul... target="_blank">Building and Viewing an Application</a> section of the Visualizer User Guide.

5APIs

5.1Biometric Events

5.1.1displayCustomPopup

Description:

This event allows to display custom pop up for Android Fingerprint authentication.

Syntax:

displayCustomPopup()

Parameters:

isVisible.

Return Value:

Boolean.

Example:

this.view.biometric.displayCustomPopup = this.displayAndroidPopup;

Ex: displayAndroidPopup : function(isVisible){

this.view.flxAndroidBiometricPopup.isVisible = isVisible;

},

6Known Issues

<<This section provides information on the known issues while using the App.>>

Supported App Types:

Supported Devices:

Supported Platforms:

Platform Version:

Asset Requirements:

Visualizer Enterprise

MobileFabric

Status:

Approved

Title Approved:

Title Review:

Body Approved:

Body Review:

Asset Display View Approved:

Asset Display View Review:

Detail View Images/Video Approved:

Detail View Images/Video Review:

Developers Guide Documentation Approved:

Developers Guide Documentation Review:

External Links Approved:

External Links Review:

Additional Notes:

Asset Review Status:

Approved

Item Logo:

Use iPhone Wrapper:

Supporting Document Link:

Use iFrame:

Item Guid:

f30a78b7e8c54f46876d50141e6acec7

Tour Link:

Item Kuid:

u5c15de30fc849b1bf67394d271de528

Github Repository URL:

https://github.com/AmwayACS/AmwayIDNativeLogin/releases

Is NFI: