| Lasso Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
LassoNameIdentifierMappingLassoNameIdentifierMapping — Liberty Enabled Client and Proxy Profile (ID-FF)  | 
Synopsis
struct LassoNameIdentifierMapping; LassoNameIdentifierMapping * lasso_name_identifier_mapping_new (LassoServer *server); lasso_error_t lasso_name_identifier_mapping_build_request_msg (LassoNameIdentifierMapping *mapping); lasso_error_t lasso_name_identifier_mapping_build_response_msg (LassoNameIdentifierMapping *mapping); void lasso_name_identifier_mapping_destroy (LassoNameIdentifierMapping *mapping); lasso_error_t lasso_name_identifier_mapping_init_request (LassoNameIdentifierMapping *mapping,gchar *targetNamespace,gchar *remote_providerID); lasso_error_t lasso_name_identifier_mapping_process_request_msg (LassoNameIdentifierMapping *mapping,gchar *request_msg); lasso_error_t lasso_name_identifier_mapping_process_response_msg (LassoNameIdentifierMapping *mapping,gchar *response_msg); lasso_error_t lasso_name_identifier_mapping_validate_request (LassoNameIdentifierMapping *mapping);
Details
struct LassoNameIdentifierMapping
struct LassoNameIdentifierMapping {
	LassoProfile parent;
	gchar *targetNameIdentifier;
};
lasso_name_identifier_mapping_new ()
LassoNameIdentifierMapping *  lasso_name_identifier_mapping_new
                                                        (LassoServer *server);
Creates a new LassoNameIdentifierMapping.
  | 
the LassoServer | 
Returns :  | 
a newly created LassoNameIdentifierMapping object; or NULL if an error occured | 
lasso_name_identifier_mapping_build_request_msg ()
lasso_error_t       lasso_name_identifier_mapping_build_request_msg
                                                        (LassoNameIdentifierMapping *mapping);
Builds a name identifier mapping request message.
If it is a SOAP method, then it builds the request as a SOAP message, optionally signs his node, sets
msg_bodywith that message and setsmsg_urlwith the SOAP Endpoint URLIf it is a HTTP-Redirect method, then it builds the request as a query string message, optionally signs it and sets
msg_urlto that URL.
  | 
a LassoNameIdentifierMapping | 
Returns :  | 
0 on success; or a negative value otherwise. | 
lasso_name_identifier_mapping_build_response_msg ()
lasso_error_t       lasso_name_identifier_mapping_build_response_msg
                                                        (LassoNameIdentifierMapping *mapping);
Builds a name identifier mapping response message.
If it is a SOAP method, then it builds the response as a SOAP message, optionally signs his node, sets
msg_bodywith that message and setsmsg_urlwith the register name identifier service return URL.If it is a HTTP-Redirect method, then it builds the response as a query string message, optionally signs it and sets
msg_urlto that URL.
If private key and certificate are set in server object it will also signs the message (either with X509 if SOAP or with a simple signature for query strings).
  | 
a LassoNameIdentifierMapping | 
Returns :  | 
0 on success; or a negative value otherwise. | 
lasso_name_identifier_mapping_destroy ()
void                lasso_name_identifier_mapping_destroy
                                                        (LassoNameIdentifierMapping *mapping);
Destroys a LassoNameIdentifierMapping object.
  | 
a LassoNameIdentifierMapping | 
lasso_name_identifier_mapping_init_request ()
lasso_error_t lasso_name_identifier_mapping_init_request (LassoNameIdentifierMapping *mapping,gchar *targetNamespace,gchar *remote_providerID);
Initializes a new lib:NameIdentifierMappingRequest request.
  | 
a LassoNameIdentifierMapping | 
  | 
the request targetNamespace | 
  | 
the providerID of the identity provider. | 
Returns :  | 
0 on success; or a negative value otherwise. | 
lasso_name_identifier_mapping_process_request_msg ()
lasso_error_t lasso_name_identifier_mapping_process_request_msg (LassoNameIdentifierMapping *mapping,gchar *request_msg);
Processes a lib:NameIdentifierMappingRequest message. Rebuilds a request object from the message and optionally verifies its signature.
  | 
a LassoNameIdentifierMapping | 
  | 
the name identifier mapping request message | 
Returns :  | 
0 on success; or a negative value otherwise. | 
lasso_name_identifier_mapping_process_response_msg ()
lasso_error_t lasso_name_identifier_mapping_process_response_msg (LassoNameIdentifierMapping *mapping,gchar *response_msg);
Processes a lib:NameIdentifierMappingResponse message. Rebuilds a response object from the message and optionally verifies its signature.
If the response depicts Success it will also sets targetNameIdentifier.
  | 
a LassoNameIdentifierMapping | 
  | 
the name identifier mapping response message | 
Returns :  | 
0 on success; or a negative value otherwise. | 
lasso_name_identifier_mapping_validate_request ()
lasso_error_t       lasso_name_identifier_mapping_validate_request
                                                        (LassoNameIdentifierMapping *mapping);
Checks profile request with regards to message status and principal federations, update them accordingly and prepares a lib:NameIdentifierMappingResponse accordingly.
  | 
a LassoNameIdentifierMapping | 
Returns :  | 
0 on success; or a negative value otherwise. | 
