Evaluates the access control policies for a specified web-resource and action.
#include "am_web.h" AM_WEB_EXPORT am_status_t am_web_is_access_allowed(const char *sso_token, const char *url, const char *path_info, const char *action_name, const char *client_ip, const am_map_t env_parameter_map, am_policy_result_t *result);
This function takes the following parameters:
The sso_token from the Access Manager cookie. This parameter may be NULL if there is no cookie present.
The URL whose accessibility is being determined. This parameter may not be NULL.
The action (GET, POST, etc.) being performed on the specified URL. This parameter may not be NULL.
The IP address of the client attempting to access the specified URL. If client IP validation is turned on, then this parameter may not be NULL.
A map containing additional information about the user attempting to access the specified URL. This parameter ay not be NULL.
An output parameter where an am_map_t can be stored if the policy evaluation produces any advice information. This parameter may not be NULL.
This function returns am_status_t with one of the following values:
If the evaluation was performed successfully and access is to be allowed to the specified resource.
If the evaluation was not successfully completed due to insufficient memory being available.
If any of the URL, action_name, env_parameter_map, or advices_map_ptr parameters is NULL or if client IP validation is enabled and the client_ip parameter is NULL.
If the specified sso_token does not refer to a currently valid session
If the policy information indicates that the user does not have permission to access the specified resource or any error is detected other than the ones listed above.