![]() |
![]() |
![]() |
Lasso Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <lasso/lasso.h> LassoIdWsf2Discovery; LassoIdWsf2Discovery* lasso_idwsf2_discovery_new (LassoServer *server);gchar * lasso_idwsf2_discovery_metadata_register_self (LassoIdWsf2Discovery *discovery, constgchar *service_type, constgchar *abstract, constgchar *soap_endpoint, constgchar *svcMDID);gint lasso_idwsf2_discovery_init_metadata_register (LassoIdWsf2Discovery *discovery, constgchar *service_type, constgchar *abstract, constgchar *disco_provider_id, constgchar *soap_endpoint);gint lasso_idwsf2_discovery_process_metadata_register_msg (LassoIdWsf2Discovery *discovery, constgchar *message);gint lasso_idwsf2_discovery_process_metadata_register_response_msg (LassoIdWsf2Discovery *discovery, constgchar *message);gint lasso_idwsf2_discovery_init_metadata_association_add (LassoIdWsf2Discovery *discovery, constgchar *svcMDID);gint lasso_idwsf2_discovery_process_metadata_association_add_msg (LassoIdWsf2Discovery *discovery, constgchar *message);gint lasso_idwsf2_discovery_register_metadata (LassoIdWsf2Discovery *discovery);gint lasso_idwsf2_discovery_process_metadata_association_add_response_msg (LassoIdWsf2Discovery *discovery, constgchar *message);gint lasso_idwsf2_discovery_init_query (LassoIdWsf2Discovery *discovery, constgchar *security_mech_id);gint lasso_idwsf2_discovery_add_requested_service_type (LassoIdWsf2Discovery *discovery, constgchar *service_type);gint lasso_idwsf2_discovery_process_query_msg (LassoIdWsf2Discovery *discovery, constgchar *message);gint lasso_idwsf2_discovery_build_query_response_eprs (LassoIdWsf2Discovery *discovery);gint lasso_idwsf2_discovery_process_query_response_msg (LassoIdWsf2Discovery *discovery, constgchar *message); LassoIdWsf2DataService* lasso_idwsf2_discovery_get_service (LassoIdWsf2Discovery *discovery, constgchar *service_type);
The Discovery service usually runs on the principal identity provider and knowns about resources and services related to the principal. Attribute providers can register themselves as offering resources for an user while other services can ask where to find a given resource.
typedef struct { LassoIdWsf2Profile parent; /* FIXME : Both should be lists */ LassoIdWsf2DiscoSvcMetadata *metadata; gchar *svcMDID; } LassoIdWsf2Discovery;
LassoIdWsf2Discovery* lasso_idwsf2_discovery_new (LassoServer *server);
Create a new LassoIdWsf2Discovery.
|
the LassoServer |
Returns : |
a newly created LassoIdWsf2Discovery object; or NULL if an error occured. |
gchar * lasso_idwsf2_discovery_metadata_register_self (LassoIdWsf2Discovery *discovery, constgchar *service_type, constgchar *abstract, constgchar *soap_endpoint, constgchar *svcMDID);
Register metadata service on itself as an ID-WSF Provider (WSP). Typically used for an IdP to register itself as Discovery service.
|
a LassoIdWsf2Discovery |
|
the service type of the registered metadata, for example LASSO_IDWSF2_DISCO_HREF |
|
label/title of the service, free form |
|
URL of the SoapEndpoint to the service |
|
identifier of the metadatas if caller wants to specify which identifier it wants. If NULL, a random identifier will be generated. |
Returns : |
the svcMDID of the registered service metadata. |
gint lasso_idwsf2_discovery_init_metadata_register (LassoIdWsf2Discovery *discovery, constgchar *service_type, constgchar *abstract, constgchar *disco_provider_id, constgchar *soap_endpoint);
Initialise a ID-WSF service metadata registration request to a Discovery service specified by disco_provider_id.
|
a LassoIdWsf2Discovery |
|
the service type of the registered metadata, for example LASSO_IDWSF2_DISCO_HREF |
|
label/title of the service, free form |
|
provider identifier of the discovery service |
|
URL of the SoapEndpoint to the service |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_process_metadata_register_msg (LassoIdWsf2Discovery *discovery, constgchar *message);
Process received metadata register request. If successful, register the service metadata into the discovery service.
|
a LassoIdWsf2Discovery |
|
received metadata register soap request |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_process_metadata_register_response_msg (LassoIdWsf2Discovery *discovery, constgchar *message);
Process received metadata register response.
Check response status code.
If successful, save into discovery->svcMDID
the service metadata identifier
found in the response.
|
a LassoIdWsf2Discovery |
|
received metadata register soap response |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_init_metadata_association_add (LassoIdWsf2Discovery *discovery, constgchar *svcMDID);
Initialise a request to associate a user account to a service metadata, allowing a WSC to request this service for data related to this user account.
|
a LassoIdWsf2Discovery |
|
identifier of the service metadata the user wants to associate with |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_process_metadata_association_add_msg (LassoIdWsf2Discovery *discovery, constgchar *message);
Process received metadata association add request.
|
a LassoIdWsf2Discovery |
|
received metadata association add soap request |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_register_metadata (LassoIdWsf2Discovery *discovery);
Add service metadata identifier into user identity object.
|
a LassoIdWsf2Discovery |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_process_metadata_association_add_response_msg (LassoIdWsf2Discovery *discovery, constgchar *message);
Process received metadata association add response. Check response status code.
|
a LassoIdWsf2Discovery |
|
received metadata association add soap response |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_init_query (LassoIdWsf2Discovery *discovery, constgchar *security_mech_id);
Initialise a request for ID-WSF discovery Query to a discovery service.
|
a LassoIdWsf2Discovery |
|
obsolete ; can be NULL |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_add_requested_service_type (LassoIdWsf2Discovery *discovery, constgchar *service_type);
Select the requested service type which will be queried.
|
a LassoIdWsf2Discovery |
|
the service type (or data profile) requested |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_process_query_msg (LassoIdWsf2Discovery *discovery, constgchar *message);
Process received query request.
|
a LassoIdWsf2Discovery |
|
received query soap request |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_build_query_response_eprs (LassoIdWsf2Discovery *discovery);
Build a query response containing one or more EndpointReference (EPR) for each WSP providing the requested service type and matching other query criteria to allow a WSC to request them.
|
a LassoIdWsf2Discovery |
Returns : |
0 on success; or a negative value otherwise. |
gint lasso_idwsf2_discovery_process_query_response_msg (LassoIdWsf2Discovery *discovery, constgchar *message);
Process received query response. Copy returned EPRs into session object. Check response status code.
|
a LassoIdWsf2Discovery |
|
received query soap response |
Returns : |
0 on success; or a negative value otherwise. |
LassoIdWsf2DataService* lasso_idwsf2_discovery_get_service (LassoIdWsf2Discovery *discovery, constgchar *service_type);
After a discovery query message, create a LassoIdWsf2DataService instance for the
requested service_type
.
|
a LassoIdWsf2Discovery |
|
the requested service type |
Returns : |
a newly created LassoIdWsf2DataService object; or NULL if an error occured. |