![]() |
![]() |
![]() |
Lasso Reference Manual | ![]() |
---|---|---|---|---|
#include <lasso/lasso.h> LassoLecp; LassoLecp* lasso_lecp_new (LassoServer *server);void lasso_lecp_destroy (LassoLecp *lecp);int lasso_lecp_build_authn_request_envelope_msg (LassoLecp *lecp);int lasso_lecp_build_authn_request_msg (LassoLecp *lecp);int lasso_lecp_build_authn_response_msg (LassoLecp *lecp);int lasso_lecp_build_authn_response_envelope_msg (LassoLecp *lecp);int lasso_lecp_init_authn_request (LassoLecp *lecp, constchar *remote_providerID);int lasso_lecp_process_authn_request_msg (LassoLecp *lecp, constchar *authn_request_msg);int lasso_lecp_process_authn_request_envelope_msg (LassoLecp *lecp, constchar *request_msg);int lasso_lecp_process_authn_response_envelope_msg (LassoLecp *lecp, constchar *response_msg);
typedef struct { LassoLibAuthnRequestEnvelope *authnRequestEnvelope; LassoLibAuthnResponseEnvelope *authnResponseEnvelope; char *assertionConsumerServiceURL; } LassoLecp;
LassoLecp* lasso_lecp_new (LassoServer *server);
Creates a new LassoLecp.
server : |
the LassoServer |
Returns : | a newly created LassoLecp object; or NULL if an error occured |
void lasso_lecp_destroy (LassoLecp *lecp);
Destroys a LassoLecp object
lecp : |
a LassoLecp |
int lasso_lecp_build_authn_request_envelope_msg (LassoLecp *lecp);
Builds an enveloped authentication request message. Sets msg_body
to that
message.
lecp : |
a LassoLecp |
Returns : | 0 on success; or a negative value otherwise. |
int lasso_lecp_build_authn_request_msg (LassoLecp *lecp);
Builds an authentication request. The data for the sending of the request are
stored in msg_url
and msg_body
(SOAP POST).
lecp : |
a LassoLecp |
Returns : | 0 on success; or a negative value otherwise. |
int lasso_lecp_build_authn_response_msg (LassoLecp *lecp);
Builds the lecp authentication response message (base64). Sets msg_body
to
that message.
lecp : |
a LassoLecp |
Returns : | 0 on success; or a negative value otherwise. |
int lasso_lecp_build_authn_response_envelope_msg (LassoLecp *lecp);
Builds the enveloped LECP authentication response message (SOAP message).
Sets msg_body
to that message.
lecp : |
a LassoLecp |
Returns : | 0 on success; or a negative value otherwise. |
int lasso_lecp_init_authn_request (LassoLecp *lecp, constchar *remote_providerID);
Initializes a new lib:AuthnRequest.
lecp : |
a LassoLecp |
remote_providerID : |
the providerID of the identity provider. When NULL, the first known identity provider is used. |
Returns : | 0 on success; or a negative value otherwise. |
int lasso_lecp_process_authn_request_msg (LassoLecp *lecp, constchar *authn_request_msg);
Processes received authentication request, checks it is signed correctly, checks if requested protocol profile is supported, etc.
lecp : |
a LassoLecp |
authn_request_msg : |
the authentication request received |
Returns : | 0 on success; or a negative value otherwise. |
int lasso_lecp_process_authn_request_envelope_msg (LassoLecp *lecp, constchar *request_msg);
Processes received enveloped authentication request, extracts the authentication request out of it.
lecp : |
a LassoLecp |
request_msg : |
the enveloped authentication request received |
Returns : | 0 on success; or a negative value otherwise. |
int lasso_lecp_process_authn_response_envelope_msg (LassoLecp *lecp, constchar *response_msg);
Processes received enveloped authentication response, extracts the
authentication response out of it and stores it in response
.
lecp : |
a LassoLecp |
response_msg : |
the enveloped authentication response received |
Returns : | 0 on success; or a negative value otherwise. |