RapidIdentity Administrators' and Users' Guide

Create an Application

Follow these steps to create an Application in RapidIdentity:

  1. Choose the Applications module from the main drop-down menu.

  2. Select Catalog from the left menu.

  3. Click on the Add Application button from the top right of the screen or from within the Catalog screen to start the new Application process.

    Add_Application_Full_Button.png
  4. Fill out the necessary fields to complete the Details tab of the application. There are three main required fields: Name, Status, and Access Control. Upon population, these fields may require additional fields to be populated. For example, once the Status of the application is set to Active, an Icon will be required in order to save. See the Application Details table below for information pertaining to each field.

    Application_Details.png

    Note

    The application cannot be saved until all required fields are populated.

    Table 2. Application Details

    Field

    Description

    Name

    Required. The name that makes the application easy to identify.

    Icon

    The image that represents the application. Click the pencil in the icon box to select or upload an image. A default library of icons is available, or you can upload a custom icon by clicking Upload Icon and follow the upload wizard.

    Note

    For the best results, use a square icon that is 300px × 300px or fewer and uses a simple design with clear colors. Text, intricate designs, or specialty shapes may distort upon use.

    Note

    Once the Status of the application is set to Active, this field will be required in order to save.

    Description

    A brief description of the application.

    Owner

    The name of the user who is responsible for the application. This field will automatically populate with the identity of the current user.

    Categories

    The Category in which this application will appear. To assign multiple categories, click Add Another Category and populate the added field(s).

    Add_Another_Category.png

    Status

    Required. Determines if the application icon link will be visible in RapidIdentity Portal.

    To activate this application, use the drop-down menu Status to Active. This setting also fully enables/disables the application definition, determining whether the application link will be visible in RapidIdentity Portal.

    Application URL

    The application's URL, which is the URL required to access the application. Tokens* may be used in the Application URL. All LDAP attributes are valid.

    Note

    Once the Status of the application is set to Active, this field will be required in order to save.

    *Tokens are interpolation expressions of the form %x% where x is either an LDAP attribute, session.password, or password.<LDAP Attribute> if the LDAP attribute is encrypted by RapidIdentity.

    Require Bookmark

    When checked, this application displays in the qualified user's Bookmarks in the Dashboard module.

    Priority

    This value allows administrators to determine the relative order users see when accessing My Applications.

    Assigning priority is very useful when users have access to large numbers of applications, particularly if accessing applications from a mobile device.

    Applications can have equivalent priority (e.g. 3 applications set to priority 100).

    Access Control

    Required. Choose whether to provide the application as Role-based or Attribute-based. Depending on the selection, the required, related fields will populate:

    Included Roles: Allows the user to type to begin a search of a role/roles to associate the application to.

    Excluded Roles: Allows the user to type to begin a search of a role/roles to exclude from access to the application

    Attribute ACL: Allows the user to set up the access control list for the application through the LDAP Builder.



  5. Click on the SSO tab to define the type of application authentication to use. See the SSO table below for information pertaining to each field.

    SSO_Type.png
    Table 3. SSO Tab

    Type

    Description

    Simple

    No authentication. This is typically used with federation/SSO provided the Service Provider is configured properly. This can also just be a simple link to any website.

    Form Fill Authentication (via Plugin)

    Pass attributes to authenticate a user using a Plugin.

    Note

    Choosing this option will require configuration of login steps and URLs for the plugin and content pages. This information is discussed with more detail in Form Fill Authentication (via Plugin).

    Form Fill Authentication

    Pass attributes to authenticate a user.

    Note

    Choosing this option will require configuration of other fields. More information is available in Form Fill Authentication.

    HTTP Basic Authentication

    Send username and password in the URL field.

    Note

    Choosing this option will require configuration of other fields. More information is available in HTTP Basic Authentication Data Tab Fields.