| 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:
|