org.ocap.hn.security

Interface NetAuthorizationHandler

public interface NetAuthorizationHandler

This interface represents a callback mechanism to a registered network authorization handler.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	notifyAction(String actionName, InetAddress inetAddress, String macAddress, int activityID) Notifies the authorization handler that an action it registered interest in has been received.
void	notifyActivityEnd(int activityID) Notifies the registered authorization handler that an activity has ended.
boolean	notifyActivityStart(InetAddress inetAddress, String macAddress, URL url, int activityID) Notifies the registered authorization handler that an activity to access cable services has been started.

Method Detail

notifyActivityStart

boolean notifyActivityStart(InetAddress inetAddress,
                          String macAddress,
                          URL url,
                          int activityID)

Notifies the registered authorization handler that an activity to access cable services has been started. The handler will permit or deny the ability for the activity to continue.

Parameters:

inetAddress - IP address the transaction was sent from.

macAddress - An empty string; this parameter is not used.

url - The URL requested by the transaction.

activityID - The unique identifier of the activity.

Returns:

true if the activity is accepted; false otherwise.

notifyActivityEnd

void notifyActivityEnd(int activityID)

Notifies the registered authorization handler that an activity has ended.

Parameters:

activityID - Unique identifier assigned to the activity and passed to the notifyActivityStart method.

notifyAction

boolean notifyAction(String actionName,
                   InetAddress inetAddress,
                   String macAddress,
                   int activityID)

Notifies the authorization handler that an action it registered interest in has been received.

Parameters:

actionName - Name of the action received. Will match a name in the actionNames parameter previously passed to NetSecurityManager.setAuthorizationHandler(NetAuthorizationHandler, String[], boolean).

inetAddress - IP address the transaction was sent from.

macAddress - An empty string; this parameter is not used.

activityID - The unique identifier of the activity if known. If no activityID is associated with the transaction the implementation SHALL pass a value of -1;

Returns:

True if the activity is accepted, otherwise returns false.