Setting Up the Developer Portal

The Developer Portal is an interface designed to allow Developers and place to create, view, and manage their Platform applications. It optimizes basic application management workflows, exposing an intuitive Platform structure that cuts down on task completion time and minimizes complexity.

After installation, you can begin configuring your Development and manage access for your Development Teams and Account users.

Initial Configuration of the Developer Portal at Installation

When ACP is installed, an initial Tenant and user account is created using the information about your company and the username and password provided to the Apprenda Installer. In addition to the accounts and subscriptions created for a new Tenant, the initial account is also creates as a Development Team. This means that an instance of the Developer Portal is created for your Organization.

A subscription to the Developer Portal is granted automatically to the Account Administrator (the initial user). After installation, your Account Administrator is the only member of your Organization that can log in to your Developer Portal.

Accessing the Developer Portal

Access to the Developer Portal is restricted to Users who have been assigned subscriptions to it. Subscription management is controlled through the Account Portal, where you can manage subscriptions and securables to the multi-tenant applications of your Organization. In this case, the multi-tentant application you are managing is the Developer Portal. You, or a user with the appropriate access, must create and assign a Developer Portal subscription manually for all other Users who require to access the Developer Portal.

Unless your Platform Operator has configured the Platform otherwise, upon login the Account Administrator and other Users who have been assigned a subscription to the Developer Portal are directed to the Developer Portal Dashboard. Users who do not have a subscription to the Developer Portal are directed to the Account Portal Dashboard and will not have access to the Developer Portal. 

Switching between the Developer and Account Portals

You can access the Account Portal from any page Additional Controls section of the Developer Portal through the “Manage Your Organization” link located in the taskbar in the upper right side of the screen. From the Account Portal, Users who have a subscription to the Developer Portal can access it through the “Publish Applications” link.

Create Subscriptions for the Developer Portal

In the Account Portal, navigate to the Applications pages from the top menu.

  1. Click on the Add Subscriptions icon to the right of the Developer Portal. This will take you to Manage Subscriptions page for the Developer Portal  
  2. Fill in the number of subscriptions you want to create in the input box for the “basic” user access plan
  3. Click on the Continue button. On the confirmation page that appears, review the changes, and click Continue again to create the new subscriptions.

Assign Developer Portal Subscriptions

In the Account Portal, navigate to the Applications pages from the top menu.

  1. Click on the Subscriptions & Usage icon to the right of the Developer Portal. This will take you to the Developer Portal Subscriptions & Usage page.  
  2. In the Your User Subscription Groups box to the right, click on the group name Basic, which will take you to the Basic Subscription Group page.
  3. Click on either the Subscriptions icon listed on the top right menu, or the View Subscriptions option under the Subscription Breakdown section in the upper right portion of the Group Profile box. This will take you to a page that lists each individual subscription in this Group.
  4. In the User Auto Assignment box on the bottom left of the page, select the names of the Users (up to the number of vacant subscriptions available) you wish to assign from the list provided.  This list contains the name of all Users who do not currently have a subscription to the Developer Portal.
  5. Click the Auto Assign button.

Create Roles and Assign Securable Permissions for the Developer Portal

If you have created Users and granted them access to the Developer Portal, you will need to use the Account Portal to Create Roles and grant Securable permissions that allow them to perform many of the Developer Portal’s functions. A general walkthrough of Creating Roles and Assigning Securable Permissions can be found in the Account Portal section of the docs, as can a more specific outline of Security Permissions for the Account Portal.

Once you have created Roles and assigned Users to them, you can assign Security Permissions for the Developer Portal by selecting its corresponding Access Control & Security icon in the Applications page of the Account Portal. This will take you to the Security page for the Developer Portal, where you can grant Securable permissions to a Role by marking the appropriate check boxes.

Platform versions 7.1.0 added the Manage Users and Subscriptions securable that grants the ability to manage access to an application. If you upgrade to Platform version 7.1.0 or later, users with the Manage Application securable will automatically be assigned Manage Users and Subscriptions.

Usage Notes

Browser Compatibility

The Developer Portal is optimized for Chrome, but is supports the latest version of all Firefox and IE. For more details information on compatible browsers, see the supported software page.

When viewing in IE, a Security setting of “Medium High” is recommended. If this is not permitted by corporate guidelines, at a minimum the following settings must be enabled in your browser: Active scripting, Font download, File download. If you are using a later version of IE, make sure that Emulation mode is set to Edge. The minimum resolution for viewing the Development Portal is 1280x1024.

Refreshing Data

A refresh button is available on some Developer Portal pages. The refresh button allows Developers to refresh the data on the page being viewed, as it may have been changed through normal Platform activities (such as scaling) or the actions of other Developers or Platform Operators. The refresh button is available in the upper right corner of applicable pages along with the time that has elapsed since the data on the page was last refreshed.