Adding Applications

Applications can be added from the application catalogue. For applications not listed, the application capture can be used.

When complex applications are needed and capture isn’t working please contact support.

From Application Catalogue

The Add Apps button lets you add applications from the Practice Protect Services platform App Catalogue.

  1. Login to your Admin Portal.
  2. In the navigation menu, go to Web Apps found under Apps.
  3. In the upper-right corner, click on Add Web Apps.
    The user portal opens the App Catalog window. The left pane has two tabs:

    • Search: Use this tab to display the applications in the Practice Protect platform App Catalog by category or search for a specific application. If you do not find the application using either method, use App Capture to add it—see Using Custom App Capture.
    • Recommended: Applications assigned to you by your IT department that are optional.
      Click the Add button aligned with the app.
  4. The app status is set to Ready to Deploy as default. From here, the app will have to be assigned to a user or a role for it to be deployed.In the app, go to Permissions.


    Then click Add.
  5. Search and Select the user or role that the app will be assigned to.
  6. Click Save to complete the application configuration.

Custom Application Capture

App Capture is a Practice Protect feature that allows adding application that is not included in the app catalogue. This feature can automatically identify the login fields of the application.

App Capture is only available for Firefox browser. It requires the CyberArk browser extension where users are being verified if it’s active with Practice Protect.

This procedure can only be done by a user with System Administrator access.

To use App Capture:

  1.  Open Firefox browser.
  2. Login to Practice Protect User Portal.
    then Sign-in to CyberArk browser extension.

  3. Go to the Login Page of the application you wish to add.
  4.  Open CyberArk Browser Extension in your browser (usually found on the top right corner) and select Settings > Advanced > Capture.                                                               
  5. Choose Manual setup option
  6. Click the field for Username. Example, click ‘Email Address” field for Xero. 
  7. Click the field for Password.
  8. Select one in of the following options:
    No – if the page you’re trying to capture doesn’t require an additional login field.

    Yes – if the page you’re trying to capture requires an additional login field like Domain, ID, CompanyID, Name, etc.Selector Timeout is a timer that is set for the fill function to wait for the page to load. The timer is divisible by thousands for milliseconds.

    Click Next.

  9. Select one of the following options:

    • (Recommended) Right-click the Sign in button on the Web page to capture it. After right-clicking the button, click Next.

    Use keyboard Enter key event. Selecting this option will simulate users clicking the ‘Enter’ key when signing in. This option is not recommended as it is less reliable due to incompatibility of the event.

  10. You may update the Name, Description, and Icon.
  11. Click Finish.
  12. Go back to your Practice Protect page and go to Admin Portal.

    Then go to Web Apps.
  13. Search and select the application you’ve added.
  14. In the application menu, go to Advanced.

    Look for the Order field.

    NOTE: This step requires a bit of understanding with basic JavaScript as this is an advanced setup.

    This field is the order script of the application where it follows the instruction that is encoded in this field as websites login page have different behaviors.

    Below are the basic scripts that application usually needs, however, if the application’s behavior is not usual, you may check this guide for better understanding:

  15. [["sleep","2000"],["fill","username"],["fill","password",{pbl:1}],["submit"]]
    --
    [["sleep","2000"],["fill","username"],["sleep","2000"],["fill","password",{pbl:1}],["submit"]]
    --
    [["sleep","2000"],["fill","username"],["submit"],["sleep"],["fill","password",{pbl:1}],["submit"]]
    --
    [["sleep","2000"],["fill","username"],["submit"],["waitForNewPage"],["fill","password",{pbl:1}],["submit"]]
  16. Click Save.

Updated on July 14, 2021

Related Articles