Utils
[Rampart Utilities]

Functions
AXIS2_EXTERN void *	rampart_load_module (const axutil_env_t *env, axis2_char_t *module_name, axutil_param_t **param)
AXIS2_EXTERN rampart_credentials_t *	rampart_load_credentials_module (const axutil_env_t *env, axis2_char_t *cred_module_name)
AXIS2_EXTERN rampart_credentials_status_t	rampart_call_credentials (const axutil_env_t *env, rampart_credentials_t *cred_module, axis2_msg_ctx_t *ctx, axis2_char_t **username, axis2_char_t **password)
AXIS2_EXTERN rampart_authn_provider_t *	rampart_load_auth_module (const axutil_env_t *env, axis2_char_t *auth_module_name)
AXIS2_EXTERN rampart_authn_provider_status_t	rampart_authenticate_un_pw (const axutil_env_t *env, rampart_authn_provider_t *authp, const axis2_char_t *username, const axis2_char_t *password, const axis2_char_t *nonce, const axis2_char_t *created, const axis2_char_t *password_type, axis2_msg_ctx_t *msg_ctx)
AXIS2_EXTERN rampart_callback_t *	rampart_load_pwcb_module (const axutil_env_t *env, axis2_char_t *callback_module_name)
AXIS2_EXTERN axis2_char_t *	rampart_callback_password (const axutil_env_t *env, rampart_callback_t *callback_module, const axis2_char_t *username)
AXIS2_EXTERN axis2_char_t *	rampart_generate_nonce (const axutil_env_t *env)
AXIS2_EXTERN axis2_char_t *	rampart_generate_time (const axutil_env_t *env, int ttl)
AXIS2_EXTERN axis2_status_t	rampart_compare_date_time (const axutil_env_t *env, axis2_char_t *dt1, axis2_char_t *dt2)
AXIS2_EXTERN axis2_status_t	rampart_print_info (const axutil_env_t *env, axis2_char_t *info)

---

Function Documentation

AXIS2_EXTERN rampart_authn_provider_status_t rampart_authenticate_un_pw	(	const axutil_env_t *	env,
		rampart_authn_provider_t *	authp,
		const axis2_char_t *	username,
		const axis2_char_t *	password,
		const axis2_char_t *	nonce,
		const axis2_char_t *	created,
		const axis2_char_t *	password_type,
		axis2_msg_ctx_t *	msg_ctx
	)

Call auth module

Parameters:

	env	pointer to environment struct
	authp	the authentication module
	username	the username in the UsernameToken
	password	the password in the UsernameToken
	nonce	the nonce in the UsernameToken
	created	the created time in the UsernameToken
	password_type	the type of the password. either plain text of digest
	msg_ctx	the message context

AXIS2_EXTERN rampart_credentials_status_t rampart_call_credentials	(	const axutil_env_t *	env,
		rampart_credentials_t *	cred_module,
		axis2_msg_ctx_t *	ctx,
		axis2_char_t **	username,
		axis2_char_t **	password
	)

Call credentials module User MUST free memory

Parameters:

	env	pointer to environment struct
	cred_module	the credentails module
	ctx	the message context
	username	reference to the returned username
	password	reference to the returned password

Returns:

the status of the operation

AXIS2_EXTERN axis2_char_t* rampart_callback_password	(	const axutil_env_t *	env,
		rampart_callback_t *	callback_module,
		const axis2_char_t *	username
	)

the environment the file name of the callback module (.so or .DLL) the name of the user to get the password The axis2 context

Returns:

the password for the user or NULL if failed

AXIS2_EXTERN axis2_status_t rampart_compare_date_time	(	const axutil_env_t *	env,
		axis2_char_t *	dt1,
		axis2_char_t *	dt2
	)

Check if < . if not returns a false

Parameters:

	env	pointer to environment struct
	dt1	date time 1
	dt2	date time 2

AXIS2_EXTERN axis2_char_t* rampart_generate_nonce

(

const axutil_env_t *

env

)

Generates the nonce. Nonce is a base64 encoded random string. User MUST free memory

Parameters:

env

pointer to environment struct

Returns:

generated nonce

AXIS2_EXTERN axis2_char_t* rampart_generate_time	(	const axutil_env_t *	env,
		int	ttl
	)

Generates the nonce. Nonce is a base64 encoded random string. User MUST free memory

Parameters:

ttl

Time to live. The time difference between created and expired in mili seconds.

Returns:

generated nonce

AXIS2_EXTERN rampart_authn_provider_t* rampart_load_auth_module	(	const axutil_env_t *	env,
		axis2_char_t *	auth_module_name
	)

Load authentication module User MUST free memory

Parameters:

	env	pointer to environment struct
	auth_module_name	name of the authentication module

Returns:

creatd athenticaiton module

AXIS2_EXTERN rampart_credentials_t* rampart_load_credentials_module	(	const axutil_env_t *	env,
		axis2_char_t *	cred_module_name
	)

Load the credentials module User MUST free memory

Parameters:

	env	pointer to environment struct
	cred_module_name	name of the credentails module to be loaded

Returns:

the loaded credentails module

AXIS2_EXTERN void* rampart_load_module	(	const axutil_env_t *	env,
		axis2_char_t *	module_name,
		axutil_param_t **	param
	)

Load a DLL or .SO module User MUST free memory

Parameters:

	env	pointer to environment struct
	module_name	name of the module to be loaded

Returns:

the loaded module

AXIS2_EXTERN rampart_callback_t* rampart_load_pwcb_module	(	const axutil_env_t *	env,
		axis2_char_t *	callback_module_name
	)

Load the password callback module User MUST free memory

Parameters:

env

pointer to environment struct the name of the callback module

Returns:

the loaded callback module

AXIS2_EXTERN axis2_status_t rampart_print_info	(	const axutil_env_t *	env,
		axis2_char_t *	info
	)

Print or log information (Only use for debugging)

Parameters:

	env	pointer to environment struct
	info	the information to be printed

---