Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Rule Methods › Action Method—Sets or Retrieves the Action for the Rule
Action Method—Sets or Retrieves the Action for the Rule
The Action method sets or retrieves the action for the rule.
Syntax
The Action method has the following format:
Netegrity::PolicyMgtRule‑>Action([action])
Parameters
The Action method accepts the following parameter:
action (string)
(Optional) Specifies the action to perform, as follows:
For action type Web Agent actions, use one or more of the following HTTP actions. Use commas to separate multiple actions:
- GET. Retrieves a resource for viewing through HTTP.
- POST. Posts user-supplied information through HTTP.
- PUT. Supports legacy HTTP actions.
For action type Authentication events:
- OnAuthAccept. Occurs when a user successfully authenticates.
- OnAuthAttempt. Occurs when a user fails to authenticate because no user name was supplied.
- OnAuthChallenge. May be used in custom authentication schemes to trigger a response.
- OnAuthReject. Occurs when a user fails to authenticate.
- OnAuthUserNotFound. Used to trigger Active Responses.
For action type Authorization events:
- OnAccessAccept. Occurs when SiteMinder successfully authorizes a user to access the resource.
- OnAccessReject. Occurs when SiteMinder rejects a user because the user is not authorized to access the resource.
Return Value
The Action method returns one of the following values:
- The new or the existing rule action
- undef if the call is unsuccessful
