Lasso Reference Manual | ||||
---|---|---|---|---|
Top | Description |
struct LassoIdWsf2Profile; void lasso_idwsf2_profile_set_epr (LassoIdWsf2Profile *idwsf2_profile
,LassoWsAddrEndpointReference *epr
); LassoWsAddrEndpointReference * lasso_idwsf2_profile_get_epr (LassoIdWsf2Profile *idwsf2_profile
); LassoSoapEnvelope * lasso_idwsf2_profile_get_soap_envelope_request (LassoIdWsf2Profile *idwsf2_profile
); LassoSoapEnvelope * lasso_idwsf2_profile_get_soap_envelope_response (LassoIdWsf2Profile *idwsf2_profile
); lasso_error_t lasso_idwsf2_profile_init_request (LassoIdWsf2Profile *profile
); lasso_error_t lasso_idwsf2_profile_build_request_msg (LassoIdWsf2Profile *profile
,const char *security_mech_id
); lasso_error_t lasso_idwsf2_profile_process_request_msg (LassoIdWsf2Profile *profile
,const char *msg
); lasso_error_t lasso_idwsf2_profile_check_security_mechanism (LassoIdWsf2Profile *profile
,const char *security_mech_id
); LassoNode * lasso_idwsf2_profile_get_name_identifier (LassoIdWsf2Profile *idwsf2_profile
); lasso_error_t lasso_idwsf2_profile_init_response (LassoIdWsf2Profile *profile
); lasso_error_t lasso_idwsf2_profile_init_soap_fault_response (LassoIdWsf2Profile *profile
,const char *faultcode
,const char *faultstring
,GList *details
); lasso_error_t lasso_idwsf2_profile_redirect_user_for_interaction (LassoIdWsf2Profile *profile
,const gchar *redirect_url
,gboolean for_data
); lasso_error_t lasso_idwsf2_profile_build_response_msg (LassoIdWsf2Profile *profile
); lasso_error_t lasso_idwsf2_profile_process_response_msg (LassoIdWsf2Profile *profile
,const char *msg
);
void lasso_idwsf2_profile_set_epr (LassoIdWsf2Profile *idwsf2_profile
,LassoWsAddrEndpointReference *epr
);
LassoWsAddrEndpointReference * lasso_idwsf2_profile_get_epr
(LassoIdWsf2Profile *idwsf2_profile
);
Return the EPR used by this profile.
|
a LassoIdWsf2Profile object |
Returns : |
a LassoWsAddrEndpointReference object, or NULL if none is set. [transfer none] |
LassoSoapEnvelope * lasso_idwsf2_profile_get_soap_envelope_request
(LassoIdWsf2Profile *idwsf2_profile
);
Return the last parsed SOAP request object.
|
a LassoIdWsf2Profile object |
Returns : |
a LassoSoapEnvelope object or NULL if no request as ever been parsed with this object. You must free this object. [transfer none] |
LassoSoapEnvelope * lasso_idwsf2_profile_get_soap_envelope_response
(LassoIdWsf2Profile *idwsf2_profile
);
Return the last parsed SOAP response object.
|
a LassoIdWsf2Profile object |
Returns : |
a LassoSoapEnvelope object or NULL if no response as ever been parsed with this objects. You must free this object. [transfer none] |
lasso_error_t lasso_idwsf2_profile_init_request (LassoIdWsf2Profile *profile
);
Initialize a new SOAP ID-WSF 2.0 request. Clear the existing request if one is currently set.
|
a LassoIdWsf2Profile object |
Returns : |
0 if successful, an error code otherwise. |
lasso_error_t lasso_idwsf2_profile_build_request_msg (LassoIdWsf2Profile *profile
,const char *security_mech_id
);
Serialize and sign, if needed, the SOAP request message, put the result in
LASSO_PROFILE(profile)->msg_body
.
FIXME: really do sign messages.
|
a LassoIdWsf2Profile object |
Returns : |
0 if successful, LASSO_PROFILE_ERROR_BUILDING_REQUEST_FAILED. |
lasso_error_t lasso_idwsf2_profile_process_request_msg (LassoIdWsf2Profile *profile
,const char *msg
);
Parse a SOAP request message and initialize the SOAP Envelope for the response.
|
a LassoIdWsf2Profile object |
|
a received SOAP message |
Returns : |
0 if successful, an error code otherwise among:
|
lasso_error_t lasso_idwsf2_profile_check_security_mechanism (LassoIdWsf2Profile *profile
,const char *security_mech_id
);
Check ID-WSF 2.0 Security Mechanism upon the received request. It is mandatory that a
LassoServer is setted for the profile
object.
|
a LassoIdWsf2Profile object |
|
the security mechanism to enforce, if none is provided Bearer is assumed. |
Returns : |
0 if the request passed the check, an error code otherwise. |
LassoNode * lasso_idwsf2_profile_get_name_identifier
(LassoIdWsf2Profile *idwsf2_profile
);
Return the NameIdentifier found in a WS-Security authentication token, when Bearer or SAML security mechanism is used. This method does not validate any security conditions on the assertion.
|
a LassoIdWsf2Profile object |
Returns : |
a LassoNode object or NULL. [transfer full][allow-none] |
lasso_error_t lasso_idwsf2_profile_init_response (LassoIdWsf2Profile *profile
);
Initialize a new SOAP ID-WSF 2.0 response. Clear the existing response if one is currently set.
|
a LassoIdWsf2Profile object |
Returns : |
0 if successful, an error code otherwise. |
lasso_error_t lasso_idwsf2_profile_init_soap_fault_response (LassoIdWsf2Profile *profile
,const char *faultcode
,const char *faultstring
,GList *details
);
Initialize a new SOAP 1.1 fault.
|
a LassoIdWsf2Profile object |
|
a SOAP fault code, see LASSO_SOAP_FAULT_CLIENT, LASSO_SOAP_FAULT_SERVER. |
|
a human description of the error |
|
complementary data describing the error, you can use LassoIdWsf2UtilStatus. [allow-none][element-type LassoNode] |
Returns : |
0 if successful, an error code otherwise. |
lasso_error_t lasso_idwsf2_profile_redirect_user_for_interaction (LassoIdWsf2Profile *profile
,const gchar *redirect_url
,gboolean for_data
);
Create a SOAP fault containing a RedirectRequest element, with a redirectURL property set to
redirect_url
concatenated with the parameter "transactionID" set to the messageID of the
response message.
|
a LassoIdWsf2Profile object |
|
an URL where the user must be redirected |
Returns : |
0 if successful, an error code otherwise. |
lasso_error_t lasso_idwsf2_profile_build_response_msg
(LassoIdWsf2Profile *profile
);
Serialize and sign the SOAP, if needed, the response message, put the result in
LASSO_PROFILE(profile)->msg_body
.
|
a LassoIdWsf2Profile object |
Returns : |
0 if successful, LASSO_PROFILE_ERROR_BUILDING_RESPONSE_FAILED otherwise. |
lasso_error_t lasso_idwsf2_profile_process_response_msg (LassoIdWsf2Profile *profile
,const char *msg
);
Parse a response received by SOAP. Place the parsed message in the LassoIdWsf2Profile structure
in the soap_envelope_response
field and the content of the body in the response
field.
|
a LassoIdWsf2Profile object |
|
a string containing a response message |
Returns : |
0 if successful, one of those error codes if the call fails:
|