Add a custom subject mapper to a Permissioning Service blade

A Java-based Liberator Permissioning Service blade can contain a custom subject mapper, which resides in Liberator’s Permissioning Auth Module. Here we explain how to add the custom subject mapper to the blade.

For an explanation of subject mapping in the context of permissioning, see the online documentation Additional permissioning capabilities.

You develop a custom subject mapper by implementing the SubjectMapper interface of the Permissioning Integration API in the Caplin Integration Suite. Having created a JAR file containing the subject mapper, your Permissioning Service blade needs to

know its location. To specify this (assuming the JAR is called mycustommapper.jar):

  1. Add the custom mapper JAR to the blade by copying it to the blade’s Liberator/lib/java/ directory.

  2. Specify the class path of the custom mapper in the blade’s Liberator/etc/java.conf directory, as in this example:

    add-javaclass
    class-name   example.permissioning.SimplePermissioning
    class-id     authenticator
    classpath    "${ccd}/../lib/java/mycustommapper.jar"
    classpath    "${ccd}/../lib/java/SimplePermissioning.jar"
end-javaclass

See also: