Quantum Enterprise App Store (EAS) Service for Digital App Distribution

IMPORTANT: From 202404, Temenos Quantum has ended support for the Enterprise App Store. This applies to all future fixpack releases.

Overview

Quantum Enterprise App Store (EAS) is a simplified app distribution service that enables an enterprise to securely and easily manage and distribute their apps to their users. All features of Quantum EAS are available on Cloud and On-Premises.

With Quantum AppPlatform Release V8 Service Pack 4, Quantum App Server has been enhanced to provide the backend support for the Quantum Enterprise App Store.

NOTE: From Quantum AppPlatform V8 SP4, Quantum EAS Service is available to all Quantum AppPlatform users by default.

After an app is built by using Quantum AppPlatform, Quantum EAS service allows Quantum AppPlatform users (Admin/Member/Owner) to choose to publish an app to the Quantum App Server available in their Quantum Fabric account. AppPlatform users can then allow authenticated access to certain end-users. The authorized end-users can access the published apps directly from Quantum EAS, just like how you can access apps from the Google Play Store and the Apple App Store.

The following table details Quantum Fabric roles to manage EAS Apps

EAS Apps Management
PERMISSIONS	User Roles in Quantum Fabric
PERMISSIONS	OWNER	ADMIN	MEMBER
Developing Apps
Publishing Apps to EAS (Quantum App Server)
Unpublishing Apps to EAS
Setting Public access mode for an EAS App: By default, the authentication is disabled for EAS. So, when an app is published to the EAS, users can view and download your published apps from the EAS client app without logging in to EAS.
Setting Protected access mode for the EAS App: Users with Quantum Fabric account can enable authentication to EAS so that, only authorized users can log in to the EAS and access the published apps

Workflow of Apps for Quantum App Server

Prerequisites for Cloud

Access to a Quantum Cloud account. If you do not have a cloud account, you can register for it at Quantum Cloud Registration.

Access to a Quantum Cloud Build Environment version, and access to Fabric App Server for publishing apps to EAS.

Click here for more details on EAS and Platform Versions Compatibility Chart

The following table details the supported versions of EAS source and Platform.

IMPORTANT: If you are upgrading to EAS V 2.0.1 or a higher version, you must restart the server.

EAS Source App version		Platform Supported Version
Client App (Store.zip)	Server App (Kony App Store.zip)	Fabric	Visualizer	Middleware
1.0.0 Features Initial Release	1.0.0	NA	V8 SP4 FP44 or lower	8.4.3.x.
1.1.0 Features Support for Web apps	1.0.0	NA	V8 SP4 FP44 or lower	8.4.3.x.
2.0.0 Features Support for Android 10 Support for iOS 13 Push Notifications	2.0.0	NA	V8 SP4 FP48 or higher	8.4.3.x
2.0.1 Features Bug fixes	2.0.1	NA	V8 SP4 FP66 or higher.	8.4.3.10
3.0.1 Features Support for Desktop View Help section in iOS Native Apps	3.0.1	NA	V9 GA	8.4.3.10
3.1.0 Features Support for Upgrade Policy	3.1.0	NA	V9 SP1	V9 SP1
SP: Service Pack FP: Fix Pack

Prerequisites for On-premises

For publishing apps to the Enterprise App Store, you have to have Quantum Fabric App Server.

Click here for more details on EAS and Platform Versions Compatibility Chart

The following table details the supported versions of EAS source and Platform.

IMPORTANT: If you are upgrading to EAS V 2.0.1 or a higher version, you must restart the server.

EAS Source App version		Platform Supported Version
Client App (Store.zip)	Server App (Kony App Store.zip)	Fabric	Visualizer	Middleware
1.0.0 Features Initial Release	1.0.0	NA	V8 SP4 FP44 or lower	8.4.3.x.
1.1.0 Features Support for Web apps	1.0.0	NA	V8 SP4 FP44 or lower	8.4.3.x.
2.0.0 Features Support for Android 10 Support for iOS 13 Push Notifications	2.0.0	NA	V8 SP4 FP48 or higher	8.4.3.x
2.0.1 Features Bug fixes	2.0.1	NA	V8 SP4 FP66 or higher.	8.4.3.10
3.0.1 Features Support for Desktop View Help section in iOS Native Apps	3.0.1	NA	V9 GA	8.4.3.10
3.1.0 Features Support for Upgrade Policy	3.1.0	NA	V9 SP1	V9 SP1
SP: Service Pack FP: Fix Pack

Set the variable max_allowed_packet as per the size of your application:

IMPORTANT: For on-premises: If the size of your application is more than the variable size of server database, an error occurs. Ensure the variable max_allowed_packet is set to a higher value than the application size.

To avoid this error, increase the global variable in the server database.

- Modify the SQL Statement to set global max_allowed_packet=10*1024*1024.
In this statement, the server database size is configured to 10-Megabytes(MB).

For example, if your application size is 1024-kilobytes (1 MB) and you try to publish an application from Quantum Studio of 2048-Kilobytes(2 MB) an error appears while publishing. Increase the size of server database to a value more than 2048-Kilobytes (2 MB), for publishing the application. Refer to Increase innodb_log_file_size in my.ini file- MySQL.
Before you publish apps to EAS you must set the File Storage Root Directory path in the Settings > Runtime Configuration > File Storage Configuration in App Services Console.
- Quantum Fabric uses client app binaries uploaded to the location set in File Storage Root Directory and publishes them to EAS. So, the File Storage Root Directory path should be in the same system as the Quantum Fabric installation.
  IMPORTANT: If your Quantum Fabric is on Windows and the path is in the D drive, then provide the value as D:
  
  For example,
  Quantum Fabric is installed on D:\Installers\QuantumFabric
  The file path can be D:\Installers\Content\QuantumEAS
  Configuring File Storage Root Directory (Target location) path:
  1. Sign in to your on-premises instance of Quantum Fabric.
  2. From the left navigation pane, select Environments.
  3. Click the server icon to open the Admin Console.
  4. From the left navigation pane of the Admin Console, select Settings.
  5. Click on the Runtime Configuration tab and expand the File Service Configuration section.
  6. Provide the path of your file system target location under File Service Root Directory.

Supported Channels and Platforms for Quantum App Server

The following table details the supported channels and apps in EAS:

Android	iOS	Desktop
Mobile (Native and Web Apps) Tablet (Native and Web Apps)	Mobile (Native and Web Apps) Tablet (Native and Web Apps)	Web Apps

EAS support is available from Quantum AppPlatform V8 SP4 onwards.

Publishing Apps to EAS (Quantum App Server)

Publishing Client Binaries to Quantum App Server from Quantum Visualizer (for Cloud only)

With Visualizer Starter, you can build client binaries and publish them directly to Quantum App Server from Visualizer. For more information, refer to Publishing Native Apps to Enterprise App Store from Visualizer Starter.

NOTE: If you are a Quantum Visualizer Enterprise user, you must publish apps to EAS from Quantum Fabric Console. The behavior of EAS is the same for Quantum Visualizer Enterprise and Visualizer Starter Editions.

Publishing Client Binaries to Quantum App Server from Quantum Fabric

By using Quantum Fabric, you can directly upload client binaries and publish them to Quantum App Server. After an app is published to Quantum App Server, an authorized end-user can access EAS Client app to view available applications and download them using a mobile device.

The following flow diagram explains the process of publishing client binaries to Quantum App Server by using Quantum Fabric

To publish client binaries to Quantum App Server by using Quantum Fabric, follow these steps:

Create an app in Quantum Fabric.
In the App details page, click the Manage Client App Assets tab for the app. By default, the iOS tab is selected.
Upload the client binaries for supported platforms such as iOS, Android , and Web, as follows:
1. In the Mange Client App Assets, click the tab for iOS or Android or Web.
  1. Click the UPLOAD button for the specific channel. The Upload dialog appears for the selected channel.
    
    (This sample screen shot is for native phone binary upload)
    IMPORTANT: For on-premises: If the size of your application is more than the variable size of server database, an error occurs. Ensure the variable max_allowed_packet_size is set to a higher value than the application size.
    
    To avoid this error, increase the global variable in the server database.
    
    - Modify the SQL Statement to set global max_allowed_packet=10*1024*1024.
    In this statement, the server database size is configured to 10-Megabytes(MB).
    
    For example, if your application size is 1024-kilobytes (1 MB) and you try to publish an application from Quantum Studio of 2048-Kilobytes(2 MB) an error appears while publishing. Increase the size of the server database to a value more than 2048-Kilobytes (2 MB) for publishing the application. Refer to Increase innodb_log_file_size in my.ini file- MySQL.
  2. Drag and drop the app binary or click Browse and navigate to the required app binary file.
1. In the Display Name field, specify the name of the application. The app is displayed with the specified name in EAS when you view the App Store in a mobile device. This field is optional.
  If the display name is not specified for the app binary, the published app is displayed with the default Quantum Fabric app name in EAS.
2. In the Version field, add the version for the app.
3. To add the app icon, click the Plus symbol in the App Icon section and navigate to the icon file. This is applicable to native binary.
4. To change the screens, click the Plus symbol in the Screenshot section and navigate to the required image file. This is applicable to native binary.
5. In the Description field, add the description of the app.
6. Click UPLOAD. The add details are updated to the selected channel.
IMPORTANT: In the case of Web binary, if you have uploaded a Web binary file, you must publish the Web binary to the server as follows:

1. Go to the Publish tab. By default, the Service & Web Client Publish tab is selected.
2. Under the Select environment to publish, click an environment.
3. Click the PUBLISH button. The process of publishing the app begins.
After the binary is published, the publish status changes to Published in the Select environment to publishing section.

After you upload a app binary to the server, you must publish the binary to the EAS as follows:

Go to the Publish tab. By default, the Service & Web Client Publish tab is selected.

Click Native Client. The Native Client page lists Quantum App Server environments suitable for EAS.
The list also displays one of the following app publish statuses and availability status for that environment.

APP PUBLISH STATUS
Published: An app is published to a cloud or environment. You can unpublish the app, if required.
Not Published: An app is not published to a cloud or environment. You can publish the app, if required.
Error: An app is canceled while publishing or unpublishing. You can publish or unpublish the app, if required.
ENVIRONMENT STATUS
Busy: Server is busy publishing another app. App publish request will not be submitted for publishing. For example, When you try to publish an app in a Busy environment, the error message is displayed “`Server is busy processing another request. Please try after some time`”
Available: Server is ready for publishing the app. You can publish/unpublish an app to this environment successfully. For example: When an environment status is Available, if you try to publish an app, the app is submitted for publishing and processed via the publish life-cycle successfully. When an environment status is Available, and if multiple apps (app1 and app2) are sent for publishing simultaneously from different users of the same Fabric account, then the app which is submitted for publish first (say app1) will be processed for publishing, and for app2 the error message will be the shown “`Server is busy processing another request. Please try after some time`”
Unknown: Unable to fetch the server status. App publish request will not be submitted for publishing For example: When an environment status is Unknown, if you try to publish an app, the app is submitted for publishing, but the publishing might not be successful.

Select the required Quantum App Services environment.
Click NEXT.
In the Select assets to Publish page, select the version of each client binary you want to publish to the selected environment.

Click PUBLISH. The process of publishing the app begins.

IMPORTANT: If you are publishing the Quantum App Store version 2.0.1 or higher to an environment where the lower version of the Quantum App Store is already published, then in order to get the latest changes, you must restart the application server.

For more information on How to Stop and Start a Deployment Application Server, refer to How to Stop and Start Quantum Fabric.

When the app is published, the Application published window appears and displays link to the App Store and Manage App Store Users, along with the QR Code to access the EAS.

App Store URL
If you open the App Store URL by using a mobile device, the Responsive Web view of the EAS Store displays all the published native and Web apps. If you open the App Store URL by using a PC system (for example, Desktop or Macbook), the Desktop view of the EAS Store displays all the published Web apps suitable for Desktop only. For more details. refer to Downloading Apps from EAS
App Store QR Code
If you open the App Store QR Code by using a mobile device, the Responsive Web view of the EAS Store displays all the published native and Web apps.

NOTE: By default, the authentication is disabled for EAS. Users can view your published apps from EAS client app without having to log in.To enable authentication to your app, refer to Securing Apps in EAS.

Accessing EAS App Link

To access EAS link after the app is published (Quantum Fabric)

When the app is published, the Application published window appears and displays link to the App Store and Manage App Store Users, along with the QR Code to access the EAS
IMPORTANT: Use the App Store link on a browser or scan the displayed QR code to launch the Enterprise App Store on your mobile.

You can manage access to EAS by using the Manage App Store Users link, which allows you to manage user access to published apps. When you click on the Manage App Store Users link, the My App Store Login window appears.
For more information on how to configure users for EAS, refer to Manage App Store Users.

To access EAS link from the published Environment (Quantum Fabric)

Publish an app to an EAS environment.
Click Publish.
Click Native Client.
If the app status shows as Published in the environment, the Quantum logo become active.
Click the Quantum Logo to view links to the App Store and Manage App Store Users, along with the QR Code to access the EAS.
IMPORTANT: Use the App Store link on a browser or scan the displayed QR code to launch the Enterprise App Store on your mobile.

You can manage access to EAS by using the Manage App Store Users link, which allows you to manage user access to published apps. For more information on how to secure, refer Securing Apps by using Quantum Fabric.
NOTE: By default, the authentication is disabled for EAS. Users can view your published apps from EAS client app without having to log in.To enable authentication to your app, refer to Securing Apps in EAS.

To access EAS link from the App Service Document and App Key (Quantum Fabric)

After you publish an app to EAS, navigate to Quantum App Store. Click Publish. If the app status shows as Published in an environment, click the App Key to view link to the App Store.
The App Service Document is available in Publish -> Environment -> Download -> App Service Document. The EAS client app is available at <https://<your_App_Server_Environment_URL>/apps/store. You can retrieve this URL from your App Service Document, as the URL under Webapp.

Handling EAS Unavailability

If the Quantum App Store app is in an unpublished state, and the user tries to access the Enterprise App Store URL, the app displays the warning message of the problem.

Downloading Apps from EAS

The EAS client app is available at <https://<your_App_Server_Environment_URL>/apps/store.

NOTE: You can enable the authentication for your apps if required. For details, refer to Securing Apps in EAS.

To launch EAS on your mobile device, go to the URL <https://<your_App_Server_Environment_URL>/apps/store from your mobile device.
The EAS client app is launched in the mobile device displaying all the published apps.
- If you have published the app using Visualizer, your published app will be listed with the Visualizer app name.
- If you have published the app using Quantum Fabric, your published app will be listed with the same name as your linked Quantum Fabric app. You can use the Display Name field to change the name of your application. As a result, the modified name of the app will be displayed in EAS.
  - Sample Screen-shots for EAS in Desktop View
    Desktop
    EAS Client App Home Page App Details page in the EAS Client App
  - Sample Screen-shots for EAS in Native Mobile View
    Native Mobile
    EAS Client App Home Page App Details page in the EAS Client App Help Screen for iOS only
  - Sample Screen-shots for EAS in Native Tablet View
    Native Tablet
    EAS Client App Home Page App Details page in the EAS Client App Help Screen for iOS only
  - Sample Screen-shots for EAS in Web Mobile View
    Web Mobile
    EAS Client App Home Page App Details page in the EAS Client App
  - Sample Screen-shots for EAS in Web Tablet View
    Web Tablet
    EAS Client App Home Page App Details page in the EAS Client App
To download an app, click the GET button of the app. The application will start downloading to your mobile device.

Trust iOS Certificates

While viewing the iOS apps installed from EAS, if your iOS device displays the Untrusted Enterprise Developer pop-up message, you cannot view these apps. You must trust iOS certificates on your devices before viewing the apps.

Go to your iOS device Settings > General > Profiles or Profiles & Device Management.
Under the Enterprise App, choose the profile.
For more information, tap the Help button in your app.
The Help screen appears and displays the help details.
NOTE: The following pop-up message appears if your iOS certificates are not trusted while viewing the app installed from EAS.

Securing Apps in Quantum App Server for EAS

The Quantum Enterprise App Store (EAS) is a platform for sharing mobile apps. The default authentication type for EAS is Quantum User Repository. The authentication type is disabled, by default. After an app is published to Quantum App Server, users can view your published apps from EAS client app without logging in. You can browse and download apps from the store. An organization that uses Quantum EAS can customize the user access based on their requirements.

NOTE: By default, from Quantum AppPlatform V8 SP4, Quantum EAS Service is available to all users with the Store URL that is displayed in the Your App is ready dialog window after your app is published.

To secure your apps, you can enable authentication. When you enable authentication to apps in EAS, by default the Quantum User Repository is associated to the Quantum App Store for authentication. All users registered in the Quantum User Repository are authorized to access this app by specifying log-in credentials.

NOTE: When you log in to EAS by providing login credentials, the login details are stored in the browser settings of the mobile device. So, when you try to launch EAS on the same device next time, your authentication happens automatically, and you can start downloading apps.

IMPORTANT: If you log out from EAS in a mobile device, and try to launch the EAS on the same device next time, the Log In screen appears, which helps you to enter the credentials to launch the EAS.

You can enable authentication to apps in EAS by using Quantum Fabric, Quantum Visualizer Starter, and Quantum App Services Console.

Securing Apps by using Quantum Fabric

When the app is published, the Application published window appears and displays link to the App Store and Manage App Store Users, along with the QR Code to access the EAS.

IMPORTANT: Use the App Store link on a browser or scan the displayed QR code to launch the Enterprise App Store on your mobile.

You can manage access to EAS by using the Manage App Store Users link, which allows you to manage user access to published apps. When you click on the Manage App Store Users link, the My App Store Login window appears.
For more information on how to configure users for EAS, refer to Manage App Store Users.

Securing Apps by using Quantum Visualizer Starter (for Cloud only)

In the case of Quantum Visualizer Starter, after you publish an app to EAS, you can view the Manage App Store Users link to enable authentication for the apps in the Your App is ready dialog.

For more details on how to manage users, refer to the Manage App Store Users section in the Accessing Enterprise App Store on Visualizer Starter.

Securing Apps by using Quantum App Services Console

The following procedure explains how to enable security to an app in EAS.

Log in to App Services Console, where you have published the app for EAS.
Navigate to Settings.
Click the Configuration Parameters tab.
Click the Client App Properties tab and specify the following details:
- Field Name: KONY_APPSTORE_LOGIN.
- Field Value: true. The Field Value is a case-sensitive in small letters.
Click Save to save the settings. Now your app has enabled for authentication.
Navigate to the Quantum App Store app in your Quantum Fabric account.
Click the Identity tab. The associated Quantum User Repository is listed in the Identity page. Add users and groups if required. Your app is enabled with authentication for these users.
Publish the Quantum App Store app to the Quantum App Services environment. Now, when a user launches EAS, the log in screen appears on a mobile device.
- In the case of the app that you want to access is protected by an authorization service, the Login page for EAS appears. For example, the following screen is EAS login screen based on OAuth.
Enter the user name and password.
Click SIGN IN.

Forgot Password for Client Apps for EAS (for Cloud only)

The default authentication type for EAS is Quantum User Repository. After an app is published to Quantum App Server, any user from Quantum User Repository can access EAS without authentication by using the URL of the published app.

When you enable authentication to apps in EAS, the authorized users must specify login credentials to access app published to EAS.

In this case if you forget your login password for EAS, you can reset the password by clicking the Forgot Password button on the Login screen in your mobile device. An email will be sent to your registered mail account for the resting password.

NOTE: The Forgot Password functionality is only available for Quantum User Repository auth provider.

Switching Between Identity Services in Quantum App Store App for EAS

After you enable authentication to apps for EAS, you can switch between identity services configured in your Quantum Fabric account.

Go to Quantum Fabric Account.
Navigate to the Quantum App Store.
Click the Identity tab. The authentication service type is listed in the Identity page. The default identity service type is User Repository, and the service name is AppStoreUserRepository.
Configure a new identity service or use an existing identity service.
The new service is listed in the Identity page. You need to have only one service in the list. In the case of more than one service listed, the first service from the list is used for authentication.
Publish the app to App Server.
Now, the new service is associated to the app, and the existing identity service is unlinked from the app. When a user launches EAS, the user must specify the login credentials configured based on the new identity service that you have associated with the app.

Configuring Properties for Client Binaries

After you upload client binaries in Quantum Fabric, you can reconfigure a few of the basic properties such as the description of a binary, the icon of a binary, and the related screen shots of a binary file. You can reconfigure these properties of the client binaries only by using Quantum Fabric.

Open the app where assets are available.
Click the Manage Client App Assets tab.
Click the required platform tab, for example iOS or Android.
In the Description field, modify the text if required.
Click the Edit. The Upload dialog appears for the selected channel.

You can perform various actions for a client binary such as the download, edit, and delete.
- To change the app display name, click the Display Name text field and modify the name.
- To change the app icon, click the Plus symbol in the App Icon section and navigate for the icon file.
- To change the screens, click the Plus symbol in the Screenshot section and navigate for the required image file.
- To change the description, modify the text in the Description field.
Click UPLOAD. The modified details are updated to the client binaries.
Publish the client binaries to EAS.

Download Quantum App Store App to Quantum Fabric Account (for Cloud only)

The Quantum App Store app is available in an account in Quantum Fabric by default, and the app should exist in your account always. The Quantum App Store app is configured with required services to be used in an app for EAS, for example, Identity Services.

In case you had deleted the Quantum App Store app from your Quantum Fabric Account, you can re-import it by raising a request with the Quantum Support Team. To register and raise a customer ticket, refer to https://basecamp.kony.com.

NOTE: For more information on how to customize EAS App for branding, refer to Walk-through of Quantum Enterprise App Store (EAS) Source Application.

Unpublish an App from the EAS using Quantum Fabric

Once your app is published to the Enterprise App Store (EAS) , if you want to unpublish it for any reason, you can do so in Quantum Fabric.

To unpublish an app from the EAS using Quantum Fabric, follow these steps:

Go to your app in Quantum Fabric Console.
Go to the Publish tab. The Publish tab has the Service & Web Client and Native Client tabs. By default, the Service & Web Client Publish tab is selected.
Click the Native Client Tab.
Select the environment.
click UNPUBLISH.

NOTE: You can also unpublish the published app through the Quantum Quantum Visualizer. For more information, refer Unpublish an App from the EAS using Quantum Visualizer.

Limitations for EAS

Android Limitations for EAS

When you try to download multiple apps simultaneously, the alert message dialog appears This site is attempting to download multiple files. Do you want to allow this?. Perform one of the following actions:

If you click Allow, the download multiple apps task is resumed and start downloading the apps.
If you click Block, all apps currently in the process of downloading, will stop.
To continue downloading apps from EAS, you must un-block pop-ups from site settings in your browser in your Android mobile browser.

iOS Limitations for EAS

When you launch EAS from the Safari browser, and click the GET button of the app, an alert message dialog appears asking for Open this page in iTunes.

If you want to continue to download the app from EAS, click OK. The app files will start downloading to your mobile device.
If you click Cancel and try to download the same app or another app, an error message appears Safari cannot open the page because the address is invalid. All the apps download in-progress are stopped.
- If you want to continue to download apps from EAS, you must refresh the browser page in the iOS mobile device.

Child app size limitations for EAS Environments

From Quantum V9 GA, while publishing child apps to multi-tenant environments, your app size can be upto 13MB. If the child app size exceeds 13MB on multi-tenant environments, the download fails for the child app.

The error: {opstatus":10101,"errmsg":"Application does not exist for the specified appID."}
Single-tenant environments do not have any size restrictions on child apps for EAS.

Supported Databases (on-premises only)

MySQL
MSSQL
Oracle
MariaDB
NOTE: IBM DB2 is not supported.

Desktop
EAS Client App Home Page	App Details page in the EAS Client App

Native Mobile
EAS Client App Home Page	App Details page in the EAS Client App	Help Screen for iOS only