Open topic with navigation

Kony Fabric console User Guide: EAS Overview

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

Overview

Kony 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 Kony EAS are available on Cloud and On-Premises.

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

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

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

The following table details Kony Fabric roles to manage EAS Apps

EAS Apps Management
PERMISSIONS User Roles in Kony Fabric
OWNER ADMIN MEMBER

Developing Apps

Publishing Apps to EAS (Kony 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 Kony 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 Kony App Server

Prerequisites for Cloud

Prerequisites for On-premises

Supported Channels and Platforms for Kony App Server

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

Publishing Apps to EAS (Kony App Server)

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

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

Publishing Client Binaries to Kony App Server from Kony Fabric

By using Kony Fabric, you can directly upload client binaries and publish them to Kony App Server. After an app is published to Kony 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 Kony App Server by using Kony Fabric

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

  1. Create an app in Kony Fabric.
  2. In the App details page, click the Manage Client App Assets tab for the app. By default, the iOS tab is selected.

  3. 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.

        ssdsds
        (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 Kony 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 Kony 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.

  4. After you upload a app binary to the server, you must publish the binary to the EAS as follows:
    1. Go to the Publish tab. By default, the Service & Web Client Publish tab is selected.
    2. Click Native Client. The Native Client page lists Kony App Server environments suitable for EAS. The list also displays one of the following app statuses for that cloud or environment.

      • Published: An app is published to a cloud or an 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.

    3. Select the required Kony App Services environment.
    4. Click NEXT.
    5. In the Select assets to Publish page, select the version of each client binary you want to publish to the selected environment.
    6. Click PUBLISH. The process of publishing the app begins.

      Important: If you are publishing the Kony App Store version 2.0.1 or higher to an environment where the lower version of the Kony 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 Kony 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 (Kony Fabric)

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

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

Handling EAS Unavailability

If the Kony 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.

  1. 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 Kony Fabric, your published app will be listed with the same name as your linked Kony 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 PageApp Details page in the EAS Client App
      • Sample Screen-shots for EAS in Native Mobile View
        Native Mobile
        EAS Client App Home PageApp Details page in the EAS Client AppHelp Screen for iOS only

      • Sample Screen-shots for EAS in Native Tablet View
        Native Tablet
        EAS Client App Home PageApp Details page in the EAS Client AppHelp Screen for iOS only

      • Sample Screen-shots for EAS in Web Mobile View
        Web Mobile
        EAS Client App Home PageApp Details page in the EAS Client App
      • Sample Screen-shots for EAS in Web Tablet View
        Web Tablet
        EAS Client App Home PageApp Details page in the EAS Client App


  2. 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.

  1. Go to your iOS device Settings > General > Profiles or Profiles & Device Management.
  2. Under the Enterprise App, choose the profile.

Securing Apps in Kony App Server for EAS

The Kony Enterprise App Store (EAS) is a platform for sharing mobile apps. The default authentication type for EAS is Kony User Repository. The authentication type is disabled, by default. After an app is published to Kony 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 Kony EAS can customize the user access based on their requirements.

Note: By default, from Kony AppPlatform V8 SP4, Kony 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 Kony User Repository is associated to the Kony App Store for authentication. All users registered in the Kony 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.

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.

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

Securing Apps by using Kony 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 Kony Visualizer Starter (for Cloud only)

In the case of Kony 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 Kony App Services Console

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

  1. Log in to App Services Console, where you have published the app for EAS.
  2. Navigate to Settings.
  3. Click the Configuration Parameters tab.
  4. 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.

  5. Click Save to save the settings. Now your app has enabled for authentication.
  6. Navigate to the Kony App Store app in your Kony Fabric account.
  7. Click the Identity tab. The associated Kony User Repository is listed in the Identity page. Add users and groups if required. Your app is enabled with authentication for these users.
  8. Publish the Kony App Store app to the Kony 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.

  9. Enter the user name and password.

  10. Click SIGN IN.

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

The default authentication type for EAS is Kony User Repository. After an app is published to Kony App Server, any user from Kony 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 Kony User Repository auth provider.

Switching Between Identity Services in Kony App Store App for EAS

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

  1. Go to Kony Fabric Account.
  2. Navigate to the Kony App Store.
  3. 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.
  4. 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.

  5. 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 Kony 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 Kony Fabric.

  1. Open the app where assets are available.
  2. Click the Manage Client App Assets tab.
  3. Click the required platform tab, for example iOS or Android.

  4. In the Description field, modify the text if required.

  5. 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.

  6. Click UPLOAD. The modified details are updated to the client binaries.

  7. Publish the client binaries to EAS.

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

The Kony App Store app is available in an account in Kony Fabric by default, and the app should exist in your account always. The Kony 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 Kony App Store app from your Kony Fabric Account, you can re-import it by raising a request with the Kony 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 Kony Enterprise App Store (EAS) Source Application.

Unpublish an App from the EAS using Kony 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 Kony Fabric.

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

  1. Go to your app in Kony Fabric Console.
  2. 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.
  3. Click the Native Client Tab.
  4. Select the environment.
  5. click UNPUBLISH.

Note: You can also unpublish the published app through the Kony Quantum Visualizer. For more information, refer Unpublish an App from the EAS using Kony 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:

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.

Supported Databases (on-premises only)

Copyright © 2020 Kony, Inc. All rights reserved.

Open topic with navigation