Deploy and secure an application using the Deployment App

Deploy and secure an application using the Deployment App. Start with the Genero Archive (.gar) for the application.

Before you begin

  • Before you can use the Deployment App, you need to configure and enable the Genero Identity Provider (GIP) on your GAS. You use the StarterApp to perform the installation of the GIP. The Deployment App utilizes the Deployment Service. You must select these components in your GIP configuration at the time of installation.

  • You must have packaged your applications and services into a Genero Archive.
    Note:

    When you create a Genero Archive (.gar) with fglgar gar using the --service wsname.42m option, a web service configuration (.xcf) file is automatically generated from the app. If you have an existing web service configuration (.xcf) that you would rather use, you must create a MANIFEST file pointing to your web service configuration file.

About this task

When you deploy and secure applications and services in a Genero Archive using the Deployment App, the registration of applications with the GIP is managed for you, to include the creation of a CLIENT_ID and SERVICE_ID for the deployed Genero Archive and the addition of the GIP details to the generated application configuration files.

  1. Start the Deployment App as an authorized user.
    The Deployment App is located at http[s]://host:port/[gas/]ua/r/admin/DeploymentApp.
    Tip:

    Select the Deployment application link from the GAS demos page at http[s]://host:port/[gas/]demos.html.

  2. Deploy the .gar file.
    1. Select Deploy > Genero Archives ....
    2. Click Deploy.
    3. Use the Select your Genero Archive to deploy dialog to select your Genero Archive (.gar).
    The Genero archive deploys and is listed under Genero Archive(s).
  3. Secure the Genero Archive.
    1. Select the Genero Archive row.
    2. Click Secure.
    The Genero Archive is secured, and the individual applications are ready for security configuration.
  4. For an app:
    1. In the Secured panel, select the row for an application.
    2. Click Configure.
      The configuration page appears, where you can select authorization roles and required scopes for the selected application.
    3. Under the Authorization roles tab, select the authorization roles required to access the application.
    4. Under the Required access scopes tab, select those scopes required by the application.
    5. When you have selected the scopes needed by the application, click Save.
      Click Yes in the dialogue box to confirm your changes.
      The application is secured by the Genero Identity Provider (GIP).
  5. Change the status of the deployed Genero Archive to Active.
    1. Select the row containing the deployed app.
    2. Click Enable.
    The status changes from Inactive to Active.
  6. If the same Genero Archive (.gar) must be deployed on several GAS, repeat the procedure; however, the role will not be updated. Only the initial deployment can set the role.