Skip to main content

Extensions

Users can extend the test generation, delivery, and target monitoring capabilities of GUARDARA. This can be achieved by creating and deploying extensions under the Settings > Inventory page. GUARDARA provides security mechanisms to ensure only extensions from trusted sources can be deployed.

Developer Accounts

GUARDARA only allows deploying extensions created by registered developers. The Settings > Developers page allows defining a list of trusted developers whose extensions can be deployed on the Inventory page.

Registering a developer requires a few details related to the developer, such as the name, a brief description, and, most importantly, the developer's public key.

Each registered developer is assigned a unique ID (Developer ID). This unique ID should be shared with the developer so that the SDK can be configured appropriately.

The Specify customer Developer ID option allows specifying a custom developer ID. This is mainly to be able to register 3rd party developers who may have decided to use a fixed UUID. For example, GUARDARA uses UUID 00000000-0000-0000-0000-000000000000.

Once a developer has been registered, the registration details, including the Developer ID, can be viewed by checking the checkbox next to the list item and clicking the Edit menu item.

To delete a developer check the checkbox next to the list item representing the developer and click the Delete button from the menu. Please note that deleting a developer will not delete any installed extensions created by the developer.

Extension Control

GUARDARA allows managing both the trusted developers and who can deploy extensions. Users with the built-in Administrator or User roles assigned can deploy extensions. Visit the Access Control section of the documentation to learn how to grant other users permission to deploy extensions.

Extension Deployment

Users can install extensions on the Settings > Inventory page by clicking on the Add button on the top-left side of the screen and selecting the extension to be deployed. Once an extension is uploaded, a table entry with basic extension-related information becomes visible.

After uploading an extension, it may take some time until the extension is available to use. Engines frequently poll the Manager for updates. If new extensions are available, Engines will download and install those. The time it takes for an engine to install an extension depends on:

  • The size of the extension
  • The number of external dependencies to be downloaded, compiled and installed
  • On the speed of the network connection
  • On the speed of the machine running the Engine

The engine status screen on the Settings > Engines page shows if an engine is updating. The screen also allows obtaining a list of deployed extensions.

Users can delete extensions by selecting the extension(s) to be removed and clicking the Delete button.