Plugin Library (PL) is a feature of the Fortanix Data Security Manager (DSM) that allows users to view a list of frequently used plugins from a commonplace. Fortanix DSM users can create local copies of the plugins in the library that they intend to use and then they can start invoking them.
The Fortanix DSM PL is stored in a Git repository that contains the plugin code. Fortanix DSM users will be able to access updated and new plugins when the repository is updated by Fortanix.
Creating a Plugin
You can add a new plugin by uploading a file with a plugin code or type the code inline. The Fortanix DSM PL can be accessed by going to the Plugins page in the Fortanix DSM GUI, and then clicking the New Plugin tab on this page.
The following are the steps to create a new plugin:
- In the New Plugin page, click Create/Import a new plugin.
Figure 1: New Plugin Page Figure 2: Create a New Plugin
- Fill in the Plugin Name field and using the ‘Assigning the new plugin to groups’ box, assign the new plugin to a group and click Next. You can also create a new group by clicking CREATE NEW GROUP button and assign the plugin to the new group.
Figure 3: Adding New Plugin
- Provide the source code for your plugin. Use the editor to type in your source to the template on the EDIT INLINE tab. You can also upload the source code as a file and then edit it using the UPLOAD A FILE tab and click Create. Figure 4: Add Plugin Code
Accessing Fortanix Data Security Manager Plugin Library
The Fortanix DSM PL can be accessed by going to the Plugins page in the Fortanix DSM GUI, and then clicking the Plugin Library tab on this page. This page contains a list of all the available plugins with a short description of their functionality.
Figure 5: Plugin Library
When a user clicks on a plugin tile in the Plugin Library, the associated plugin page will be displayed with detailed information about the plugin, common use cases, setup, and format of the plugin inputs and outputs.
Figure 6: Plugin Detailed View
Installing a Plugin from the Plugin Library
To install a plugin from the PL, a user needs to click the Get Plugin button as shown in Figure 2 to go to the plugin creation page. From this page the user needs to follow the creation of plugin workflow as described below:
- Click the GET PLUGIN
- Review the plugin name and assign it to a group, and then click Save.
Figure 7: Review Plugin Details
Review Plugin Source Code Before Installation
Plugin source code may be reviewed before installing by clicking the link provided on the “Plugin page”. This link redirects to the official Fortanix Inc. Plugin Library repository hosted by GitHub
Figure 8: Review Plugin Code Before Installation
Review / Modify Plugin Source Code After Installation
Once a plugin is installed, the management of the plugin is identical to plugins created by writing the source code in the Create/Import New Plugin page. Thus, after plugin creation, the user is able to modify the original code to meet specific requirements. As an example, the following image displays the source code of the “HD Wallet” that was installed from the PL.
Figure 9: Modify Plugin Code After Installation
Upgrading Plugins to New Versions
Plugin Library plugins are versioned. When a new version of the plugin becomes available an option to upgrade to the latest version will become available both in the Plugin Library list page and in the plugin main view page. For example, the following figure shows a plugin that is in version 1.0 and can be upgraded to version 2.0 by clicking the link UPGRADE TO V 2.0 on the mid-right of the screen.
Figure 10: Upgrade Plugin
When upgrading a plugin, a list of release notes for the new version is displayed along with the option to keep a backup copy of the currently installed version of the plugin, as shown in the following figure.
Figure 11: Plugin Upgrade Screen
Plugins that are created before Fortanix DSM version 3.16 are called Legacy plugins. For backward compatibility, these legacy plugins will be marked with a special icon that denotes that they are legacy plugins.
Fortanix has applied new security restrictions which will be applicable for plugins created in Fortanix DSM version 3.16 and above.
The following screenshots show a table view of legacy plugins.
Figure 12: Legacy Plugins