All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface semper.access.ControlledApplication

public interface ControlledApplication

The root class of all SEMPER applications that need to be registered with the access control manager.

ControlledApplication defines the interface for the access control manager to store the access control handle it constructs into the application. The application being registered must implement this interface.

Version:

$Revision: 1.3 $ $Date: 1997/12/19 14:24:44 $

Author:

Mogens Rom Andersen ([email protected])

See Also:

registerSignedApplication, AccessControlHandle, ApplicationProfile

main()

Main entry point for application

After an application has been loaded, its main method can be called to run it.

myCertifier()

Return the name of the certifier.

myDescription()

Return the description of this application.

myName()

Return the name of this application.

myRoles()

Returns an array of role names.

storeAccessControlHandle(AccessControlHandle)

Store the access control handle for later use by the application.

 public abstract String myName()

Return the name of this application.

The name should be short, but describe the application adequately. The names of applications certified by a certifier must be unique.

Precondition:

Should be callable immediately after the class is loaded and a new instance of it is generated.

Postcondition:

Returns a non-null name.

Todo:

(nothing)

Returns:

name of this application.

 public abstract String myDescription()

Return the description of this application.

The description is a string describing this application in more detail.

Precondition:

Should be callable immediately after the class is loaded and a new instance of it is generated.

Postcondition:

Returns a non-null description.

Todo:

(nothing)

Returns:

description of this application.

 public abstract String myCertifier()

Return the name of the certifier.

Return the name of the certifer who signed this application. The certifier/application-name pair uniquely identifies an application.

Precondition:

Should be callable immediately after the class is loaded and a new instance of it is generated.

Postcondition:

Returns the name of the certifier.

Todo:

Integration with Installation module.

Returns:

name of certifier.

See Also:

registerSignedApplication

 public abstract FlaggedName[] myRoles()

Returns an array of role names.

The names of the roles stored in this array are deemed appropriate as active roles for this application by the certifier. Each name is accompanied by a boolean flag indicating whether the role is initially enabled (=false) or disabled (=true).

Precondition:

Should be callable immediately after the class is loaded and a new instance of it is generated.

Postcondition:

Returns an array of FlaggedName's with non-null names.

Todo:

(nothing)

Returns:

an array of flagged names, for each certified role template name plus a boolean indicating whether the role is initially enabled.

See Also:

registerSignedApplication, FlaggedName

 public abstract void storeAccessControlHandle(AccessControlHandle ach)

Store the access control handle for later use by the application.

The registration procedure calls this function to store the access control handle it generates for this application and which is later used to authenticate the application with the access control service.

Precondition:

Should be callable immediately after the class is loaded and a new instance of it is generated. Should not have been called before.

Postcondition:

The access control handle passed as parameter is stored for later retrieval.

Todo:

(nothing)

Parameters:

ach - access control handle to be stored.

 public abstract void main()

Main entry point for application

After an application has been loaded, its main method can be called to run it.

Precondition:

Should only be called after the application is registered.

Postcondition:

(none)

Todo:

(nothing)

All Packages  Class Hierarchy  This Package  Previous  Next  Index