| Lasso Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
struct LassoIdWsf2Discovery; LassoIdWsf2Discovery * lasso_idwsf2_discovery_new (LassoServer *server); lasso_error_t lasso_idwsf2_discovery_init_metadata_register (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_init_metadata_association_add (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_init_query (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_init_metadata_query (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_init_metadata_replace (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_init_metadata_delete (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_init_metadata_association_delete (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_init_metadata_association_query (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_add_service_metadata (LassoIdWsf2Discovery *idwsf2_discovery,LassoIdWsf2DiscoSvcMetadata *service_metadata); lasso_error_t lasso_idwsf2_discovery_add_simple_service_metadata (LassoIdWsf2Discovery *idwsf2_discovery,const char *abstract,const char *provider_id,GList *service_types,GList *options,const char *address,GList *security_mechanisms); GList * lasso_idwsf2_discovery_get_metadatas (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_add_requested_service (LassoIdWsf2Discovery *discovery,GList *service_types,GList *provider_ids,GList *options,GList *security_mechanisms,GList *frameworks,GList *actions,LassoIdWsf2DiscoveryQueryResultType result_type,const char *req_id); lasso_error_t lasso_idwsf2_discovery_build_request_msg (LassoIdWsf2Discovery *discovery,const char *security_mechanism); lasso_error_t lasso_idwsf2_discovery_process_request_msg (LassoIdWsf2Discovery *discovery,const char *message); LassoIdWsf2DiscoveryRequestType lasso_idwsf2_discovery_get_request_type (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_validate_request (LassoIdWsf2Discovery *discovery); lasso_error_t lasso_idwsf2_discovery_fail_request (LassoIdWsf2Discovery *discovery,const char *status_code,const char *status_code2); lasso_error_t lasso_idwsf2_discovery_process_response_msg (LassoIdWsf2Discovery *discovery,const char *msg); GList * lasso_idwsf2_discovery_get_endpoint_references (LassoIdWsf2Discovery *discovery); GList * lasso_idwsf2_discovery_get_svcmdids (LassoIdWsf2Discovery *discovery); void lasso_idwsf2_discovery_set_svcmdids (LassoIdWsf2Discovery *discovery,GList *svcmdids);
LassoIdWsf2Discovery * lasso_idwsf2_discovery_new (LassoServer *server);
Create a new LassoIdWsf2Discovery.
|
a LassoServer object, for resolving ProviderID names |
Returns : |
a newly created LassoIdWsf2Discovery object; or NULL if an error occured. |
lasso_error_t lasso_idwsf2_discovery_init_metadata_register
(LassoIdWsf2Discovery *discovery);
Initialise a ID-WSF service metadata registration request to a Discovery service.
|
a LassoIdWsf2Discovery object |
Returns : |
0 on success; an error code otherwise. |
lasso_error_t lasso_idwsf2_discovery_init_metadata_association_add
(LassoIdWsf2Discovery *discovery);
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. |
lasso_error_t lasso_idwsf2_discovery_init_query (LassoIdWsf2Discovery *discovery);
Initialise a request for ID-WSF discovery Query to a discovery service.
|
a LassoIdWsf2Discovery |
Returns : |
0 on success; or a negative value otherwise. |
lasso_error_t lasso_idwsf2_discovery_init_metadata_query
(LassoIdWsf2Discovery *discovery);
Initialise a ID-WSF service metadata query request to a Discovery service
|
a LassoIdWsf2Discovery object |
Returns : |
0 on success; an error code otherwise. |
lasso_error_t lasso_idwsf2_discovery_init_metadata_replace
(LassoIdWsf2Discovery *discovery);
Initialise a ID-WSF service metadata replace request to a Discovery service.
|
a LassoIdWsf2Discovery object |
Returns : |
0 on success; an error code otherwise. |
lasso_error_t lasso_idwsf2_discovery_init_metadata_delete
(LassoIdWsf2Discovery *discovery);
Initialise a ID-WSF service metadata query request to a Discovery service
|
a LassoIdWsf2Discovery object |
Returns : |
0 on success; an error code otherwise. |
lasso_error_t lasso_idwsf2_discovery_init_metadata_association_delete
(LassoIdWsf2Discovery *discovery);
lasso_error_t lasso_idwsf2_discovery_init_metadata_association_query
(LassoIdWsf2Discovery *discovery);
lasso_error_t lasso_idwsf2_discovery_add_service_metadata (LassoIdWsf2Discovery *idwsf2_discovery,LassoIdWsf2DiscoSvcMetadata *service_metadata);
Add a new metadata object to a request.
|
a LassoIdWsf2Discovery object |
|
a LassoIdWsf2DiscoSvcMetadata object to add to the register request. |
Returns : |
0 if successful, an error code otherwise. |
lasso_error_t lasso_idwsf2_discovery_add_simple_service_metadata (LassoIdWsf2Discovery *idwsf2_discovery,const char *abstract,const char *provider_id,GList *service_types,GList *options,const char *address,GList *security_mechanisms);
Add new metadata to the current Metadata Register request.
|
a LassoIdWsf2Discovery object |
|
a human description of the service |
|
the provider id of the service to register, if none is given, providerId of the current LassoServer object is used |
|
an array of service type URIs. [element-type utf8][allow-none] |
|
an array of option string. [element-type LassoIdWsf2DiscoOptions][allow-none] |
|
the URI of the service endpoint for the default EndpointContext |
|
the security mechanisms supported by the service. [allow-none][element-type utf8] |
Returns : |
0 if successful, an error code otherwise. |
GList * lasso_idwsf2_discovery_get_metadatas
(LassoIdWsf2Discovery *discovery);
Return the current list of metadatas in the discovery object. They can be metadatas just
received through a LASSO_IDWSF2_DISCOVERY_REQUEST_TYPE_MD_REGISTER request or added through
lasso_idwsf2_discovery_add_service_metadata() or
lasso_idwsf2_discovery_add_simple_service_metadata().
|
a LassoIdWsf2Discovery object |
Returns : |
the list of metadatas. [transfer none][element-type LassoIdWsf2DiscoSvcMetadata] |
lasso_error_t lasso_idwsf2_discovery_add_requested_service (LassoIdWsf2Discovery *discovery,GList *service_types,GList *provider_ids,GList *options,GList *security_mechanisms,GList *frameworks,GList *actions,LassoIdWsf2DiscoveryQueryResultType result_type,const char *req_id);
Add a new request to find some specific services associated to the current principal at the discovery service.
|
a LassoIdWsf2Discovery |
|
the service type (or data profile) requested. [element-type utf8][allow-none] |
|
the providers ids to select. [element-type utf8][allow-none] |
|
the options to select. [element-type utf8][allow-none] |
|
the security mechanisms to select. [element-type utf8][allow-none] |
|
the ID-WSF framework version to select. [element-type utf8][allow-none] |
|
the actions to select. [element-type utf8][allow-none] |
|
how to filter the generated EPRs. [allow-none][default LASSO_IDWSF2_DISCOVERY_QUERY_RESULT_TYPE_NONE] |
|
an eventual ID to put on the request, that can be matched with the generated EndpointReferences |
Returns : |
0 on success; or a negative value otherwise. |
lasso_error_t lasso_idwsf2_discovery_build_request_msg (LassoIdWsf2Discovery *discovery,const char *security_mechanism);
Build the request message using a security mechanism to authenticate the requester and the target identity. If none is given Bearer mechanism is used.
|
a LassoIdWsf2Discovery object |
|
the security mech id to use, if NULL a Bearer mechanism is used. |
Returns : |
0 if successful, an error code otherwise. |
lasso_error_t lasso_idwsf2_discovery_process_request_msg (LassoIdWsf2Discovery *discovery,const char *message);
Parse a Discovery service request.
|
a LassoIdWsf2Discovery object |
|
a received SOAP message |
Returns : |
0 if sucessful, an error code otherwise among:
|
LassoIdWsf2DiscoveryRequestType lasso_idwsf2_discovery_get_request_type
(LassoIdWsf2Discovery *discovery);
Return the type of the last parsed request.
|
a LassoIdWsf2Discovery object |
Returns : |
the type of the last parsed request. |
lasso_error_t lasso_idwsf2_discovery_validate_request
(LassoIdWsf2Discovery *discovery);
Accept the discovery request, and produce the response.
|
a LassoIdWsf2Discovery object |
Returns : |
0 on success; or a negative value otherwise. |
lasso_error_t lasso_idwsf2_discovery_fail_request (LassoIdWsf2Discovery *discovery,const char *status_code,const char *status_code2);
Fail the last request with the given status code.
|
a LassoIdWsf2Discovery |
|
a status code string |
|
a second-level status code |
Returns : |
0 on success; or a negative value otherwise. |
lasso_error_t lasso_idwsf2_discovery_process_response_msg (LassoIdWsf2Discovery *discovery,const char *msg);
|
a LassoIdWsf2Discovery object |
|
a string containing the response messages |
Returns : |
0 if successful, an error code otherwise. |
GList * lasso_idwsf2_discovery_get_endpoint_references
(LassoIdWsf2Discovery *discovery);
Return the list of wsa:EndpointReference returned by the last discovery query.
|
a LassoIdWsf2Discovery object |
Returns : |
a GList of LassoWsAddrEndpointReference objects, or NULL if none is found. [transfer none][element-type LassoWsAddrEndpointReference] |
GList * lasso_idwsf2_discovery_get_svcmdids (LassoIdWsf2Discovery *discovery);
Return the list of SvcMDID, or service metadata ids, returned by the last discovery query.
|
a LassoIdWsf2Discovery object |
Returns : |
a list of SvcMDID's. [transfer none][element-type utf8][allow-none] |
void lasso_idwsf2_discovery_set_svcmdids (LassoIdWsf2Discovery *discovery,GList *svcmdids);
Set the list of SvcMDID, or service metadata ids.
|
a LassoIdWsf2Discovery object |
|
a list of service metadata IDs. [element-type utf8][allow-none] |