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