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.
-
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.
-
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:
-
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:
CopyUSER_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:
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.