| 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,
const char *remote_providerID);
int lasso_lecp_process_authn_request_msg
(LassoLecp *lecp,
const char *authn_request_msg);
int lasso_lecp_process_authn_request_envelope_msg
(LassoLecp *lecp,
const char *request_msg);
int lasso_lecp_process_authn_response_envelope_msg
(LassoLecp *lecp,
const char *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. |