Sun OpenSSO Enterprise 8.0 C API Reference for Application and Web Policy Agent Developers

Parameters

This function takes the following parameters:

policy_handle

Integer specifying the object being evaluated.

sso_token

Pointer to the session token (SSOTokenID) of the authenticated user.


Note –

The OpenSSO Enterprise Session Service creates a session data structure (also known as an SSOToken) that stores information such as login time, authentication scheme, and authentication level. It also generates a session token (also known as an SSOTokenID, a randomly-generated string that identifies an instance of an SSOToken.


resource_name

Pointer to the name of the resource being requested.

action_name

Pointer to the action requested.


Note –

An action is the operation to be performed on the resource. Web server actions are POST and GET. An allowable action for a human resources service , for example, can change a home telephone number.


env_parameter_map

Map object which contains environment variables (IP address, host name, etc.) used for evaluation by the Policy Service.


Note –

See am_map_t for more information.


policy_response_map_ptr

Pointer to a map object which contains all the profile, session and response attributes fetched.


Note –

This must be enabled in the agent configuration properties. See am_policy_result_t for information on how this is done. See am_map_t for more information on map objects.


policy_result

Pointer to the am_policy_result_t type to store the result.


Note –

See am_policy_result_t for more information.