Skip to content

Plugin Metadata

When a plugin is built for use with the Masking Engine, it is critical that certain metadata be included in the plugin JAR file. This includes certain attributes in the JAR's manifest, as well as the service discovery file used to determine which classes in the JAR are directly usable by the Extensibility Framework.

Manifest Attributes

Java archives carry metadata attributes in the manifest file, located at META-INF/MANIFEST.MF in the archive file. Some of these attributes are required or at minimum quite useful in a plugin's manifest.

The following attributes carry special meaning to the extensibility framework when present in a plugin's manifest. Care must be taken to ensure they are set to valid and meaningful values for any plugins intended for production use. Additional attributes may be supported in the future. Any future attributes introduced for anything beyond a purely informational purpose will be of the format "Delphix-*" to avoid conflict with any preexisting usage.

Recognized Manifest Attributes

Attribute Meaning Example Value
Delphix-Plugin-Name The default name of the plugin. This name will be used on the Masking Engine unless overridden at plugin install time. All plugin names beginning with the string "dlpx" are reserved for future use by modules delivered with the Delphix Masking Engine product. SamplePlugin
Implementation-Vendor The individual or organization that authored the plugin module. Sample Inc.
Implementation-Version The version of the plugin. This is an entirely free-form string, limited to 255 characters. 1.0.0-SNAPSHOT
Delphix-Algorithm-API-Version The version of the Delphix Masking Plugin API used by the plugin. This value must be present and represent a valid API version. 1.0.0

Note

The maskScript init sub-command adds logic to the gradle build files to ensure that the project build inserts the correct attribute values into the plugin manifest.