issrg.pba.management.agent.managed
Interface ManagedPermisRBACMBean

All Known Implementing Classes:
ManagedPermisRBAC

public interface ManagedPermisRBACMBean

The declaration of the management-information.

this interface specifies the instrumentation provided by the managed PERMIS, to the PERMIS manager.

These methods must be implemented by the managed PERMIS installation and are the method called by the PERMIS manager via the JMX / MBean server mechanism.

Version:
0.2.2008.02.23
Author:
mfb4@kent.ac.uk

Method Summary
 java.lang.String updatePolicy(java.lang.String xmlPolicy)
          Method for updating the policy from a String object.
 java.lang.String updatePolicy(java.lang.String policyName, byte[] policyACbyteArray)
          The policy update method.
 java.lang.String updatePolicyFromLDAP(java.lang.String policyName, java.lang.String host, java.lang.Integer port, java.lang.String aCName, java.lang.String version)
          The update LDAP method.
 java.lang.String updatePolicyFromWebDAV(java.lang.String policyName, java.lang.String host, java.lang.Integer port)
          The update WebDAV method.
 

Method Detail

updatePolicy

java.lang.String updatePolicy(java.lang.String policyName,
                              byte[] policyACbyteArray)
                              throws PbaException
The policy update method. It is expected that the policy is read in by the PERMIS manager, from a file, and passed to the managed PERMIS.

Parameters:
policyName - unique policy name (normally an object identifier)
policyACbyteArray - the Attribute Certificate containing the policy
Returns:
A String value response (Message) to report back to the PERMIS Manager
Throws:
PbaException - if one it thrown during the update Process
Since:
0.3.2008.02.23

updatePolicyFromWebDAV

java.lang.String updatePolicyFromWebDAV(java.lang.String policyName,
                                        java.lang.String host,
                                        java.lang.Integer port)
                                        throws PbaException
The update WebDAV method. implemented by the managed PERMIS and called by the PERMIS manager.

Parameters:
policyName - unique policy name (normally an object identifier)
host - location of the WebDAV directory
port - number of the WebDAV directory
Returns:
A String value response (Message) to report back to the PERMIS Manager
Throws:
PbaException - if one it thrown during the update Process
Since:
0.3.2008.02.23

updatePolicyFromLDAP

java.lang.String updatePolicyFromLDAP(java.lang.String policyName,
                                      java.lang.String host,
                                      java.lang.Integer port,
                                      java.lang.String aCName,
                                      java.lang.String version)
                                      throws PbaException
The update LDAP method. implemented by the managed PERMIS and called by the PERMIS manager.

Parameters:
policyName - unique policy name (normally an object identifier)
host - location of the LDAP directory
port - number of the LDAP directory
aCName - LDAP attribute name use to identify Attribute Certificate entries
version - of the LDAP installation
Returns:
A String value response (Message) to report back to the PERMIS Manager
Throws:
PbaException - if one is thrown during the update Process
Since:
0.3.2008.02.23

updatePolicy

java.lang.String updatePolicy(java.lang.String xmlPolicy)
                              throws PbaException
Method for updating the policy from a String object. Should be implemented by the managed PERMIS engine and called by the PERMIS manager.

Parameters:
xmlPolicy - a String containing the new policy
Returns:
a response to report to the PERMIS Manager
Throws:
PbaException - if something went wrong during the update process