This is documentation for Apprenda 7 and 8.
Documentation for older versions are also available.

Managing User Access to Applications

Tenant access to applications depends on the highest User Access Model/Application Service selected for an application.

Accessing Applications with a User Access Model of Anyone and Authentication

For applications with a User Access Model of Anyone (equivalent in a Deployment Manifest to an Application Services level of "None")anyone who can access the application's URL can launch the application.  For instance, if the application's website is publicly accessible, anyone will be able to launch the application; if it is restricted to an internal network, anyone with network permissions to access the site can launch the application. Please note that Apprenda does not publish information about the the application's URL, so Development Teams must convey this information to their Tenants.  

For applications with Authentication, all registered users on a given Apprenda Platform will be able to launch the application.  Please note that Apprenda does not publish information about the the application's URL, so Development Teams must convey this information to their Tenants.  

Accessing Single-Tenant Applications with Authorization

For applications with Authorization, application access is restricted to Platform Users who have been granted explicit access rights to the application.  The Development Team that deploys the application controls which Platform Users can launch and access different parts of the application through the Additional Controls section of the Developer Portal.  This is done through the Manage Users link that will appear on the application's Overview page once it is Published:

 

Click on the Manager Users link to open up the Manager Users control, which will display any Platform Users who have already been assigned subscriptions.  You can Remove Users by checking the appropriate boxes and clicking the Remove Users link.  To add Users, click the Add Users button, which will open the Add Application Users tool:

 

Simply select the desired Users and, if you have created more than one plan for the application in its User-based Entitlement Definition, select the appropriate plan.  Click the Add button, and the subscriptions will be created.  You may add Users to other plans as needed, as the Add Application Users tool will remain open until you click the Done button.

For Apprenda Platform instances with External User Store enabled: if your Platform instance is set to use an External User Store, when you click the Manage Users link as described above, the Manage Users table will be divided into two categories: it will contain a Groups tab and a Users tab, each with a corresponding list of Groups/Users designated with access to the application.  The Users tab works as described above, and the additional Groups table lists all the Groups (which are groupings of Users defined in the External User repository) that have access to the application.  To add a Group to this list, click the Add Groups link in the table.  You will be prompted with a list of existing Groups; select the groups you want to add, and click the Add button to grant those groups access to the application.

Accessing Multi-tenant Applications

For applications with Multi-tenancy, application access is restricted to Platform Users who have been granted explicit access rights to the application through one or more Tenant Accounts.  User access is controlled through subscriptions configured through the Account Portal, and can be either configured by the Development Team that deploys the application or can be left for potential User groups to self-provision.  Whether you prefer to manage User and subscription information for your Tenants or would rather they self-provision and self-manage, these actions are done through the Account Portal.

For your convenience, we've included an Account Portal Guide that outlines the processes for User and subscription management through the Account Portal. 

Tenant Provisioning

In order to be provisioned as a subscriber to your application, your Tenants must make an initial procurement of subscriptions to your application; it is also possible for you to make this transaction for them should you choose.  Information on how to make this initial procurement can be found here. Once a Tenant has made an initial subscription procurement for your application, they will be able to procure additional subscriptions through a link in the Account Portal.

Application Access

Users can always access subscribed applications through the Applications page of their Account Portal by clicking on the "Launch" icon to the right of the desired application.

In addition, Users can visit the URL shown in this window directly instead of first entering the Account Portal to access the application. Users who access an application by this method will be prompted to enter their Apprenda Username and Password before they can access the application, and will only be granted access if they have been assigned a subscription to that application.

Making Applications Accessible by Means of a Custom URL

You can provide your Tenants with a Custom URL controlled by your Development Team that has been configured to access your application.  Once the URL has been created, you must perform the following steps to configure your application to be available through the URL (please note that these steps must be completed before the application is published):

  1. Ask your Organization’s domain administrator to contact the Apprenda Platform Operator to obtain the appropriate DNS information. 
  2. Have your domain administrator configure your Custom URL to map to the host name by means of the DNS information given to you by the Platform Operator.
  3. In the Developer Portal, navigate to the Application Settings page for the application you wish to make available through the URL.
  4. Enter your Custom URL in the Specify Application URL field in the Application URL box on the Application Settings page.  Once you click on the Save Changes button, Apprenda will honor requests from your Custom URL to link to the application URL hosted on your Apprenda instance.

Users who access their applications by means of a Custom URL controlled by your Organization will be prompted to enter their Apprenda login Username and Password before they are granted access to their subscribed applications.

If you have configured the Custom URL controlled by your Organization using a custom stylesheet, you can customize the look of the Login page that will appear when your Tenants access their applications through this method.

For more information on creating a custom stylesheet, download the Custom Login Style Guide available as a ZIP file in the appropriate section of the Application Settings page.

Once you have created and customized your stylesheet and uploaded the resulting CSS file to your Organization-controlled URL, you must specify the stylesheet URL in the Custom Login Stylesheet field in the Login Stylesheet section of the Application Settings page.