Defining a Generic Plug-In

Generic plug-ins are implemented using Java. To develop a generic server plug-in, you must implement all the methods of the generic server plug-in interface as described.

  1. Write the Java code to implement the server plug-in. See Coding a Generic Server Plug-In. Then incorporate the server plug-in code into the appropriate .jar file.

  2. Describe the plug-in attributes in the appropriate .properties file.

Guidelines to Set Up All Plug-Ins Types

Use the following list of guidelines to set up all plug-ins:

  • Set the plug_in_name.class to the name of the Java class for plug-in implementation.

  • Set the plug_in_name.conf_file to the name of a specific configuration file given to the plug-in by ActivID CMS in the init function.

  • Set the plug_in_name.link to the list of attribute names whose values are needed by the plug-in to match a user entry on its repository. This parameter is used in the setAttributes and getAttributes functions.

    Important: If you have configured ActivID CMS to work with more than one type of directory, you may need to specify the directory type by adding a suffix with the directory short name to the plug_in_name.link property key (for example, plug_in_name.link.msft-ad). For details about the directory short names, see Configuring the Generic Plugin.

Guidelines to Set Up Non-Enrollment Plug-In Types

Use the following list of guidelines to set up non-enrollment plug-ins:

Important: If you have configured ActivID CMS to work with more than one type of directory, you may need to specify the directory type by adding a suffix with the directory short name to the plug_in_name.input and plug_in_name.output property keys (for example, plug_in_name.input.msft-ad).. For details about the directory short names, see Configuring the Generic Plugin.
  • Set the plug_in_name.input to the list of attribute names whose values are passed as input to the server plug-in. (This invokes the method.)

  • Set the plug_in_name.ouput to the list of attribute names whose values are returned as output from the server plug-in. (This invokes the method.)

  • Add the plug-in name to the server plug-in list corresponding to the logical step where the plug-in is to be invoked. (This invokes the method.) For example, to declare the GenericPluginSample1 server plug-in on the user information retrieval screen of the device issuance process, the entry in the generic_plugin.properties file should look like the following example:

    Copy
    USER_INFO.plugin.server = GenericPluginSample1

Guidelines to Set Up Enrollment Plug-In Types

Use the following list of guidelines to set up enrollment plug-ins:

To identify the plug-in as an enrollment plug-in, add a comma-delimited list of the EnrollmentPlugins at the beginning of the generic-plugin.properties file as illustrated next:

Copy
EnrollmentPlugins=GenericPluginSample1,GenericPluginSample2

Copy your own .jar file and third-party packages to the following directory:

cms_install_dir\aims.war\WEB-INF\lib

Where cms_install_dir is the ActivID CMS installation directory.

Important: The cms_portal directory, used in previous versions of ActivID CMS, no longer exists. With the migration to WildFly in ActivID CMS 6.0, that directory is now called aims.war.