![]() |
![]() |
![]() |
Lasso Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
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 utf8. |
|
an array of option string. element-type LassoIdWsf2DiscoOptions. allow-none LassoIdWsf2DiscoOptions. |
|
the URI of the service endpoint for the default EndpointContext |
|
allow-none)(element-type utf8. 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 utf8. |
|
the providers ids to select. element-type utf8. allow-none utf8. |
|
the options to select. element-type utf8. allow-none utf8. |
|
the security mechanisms to select. element-type utf8. allow-none utf8. |
|
the ID-WSF framework version to select. element-type utf8. allow-none utf8. |
|
the actions to select. element-type utf8. allow-none utf8. |
|
allow-none)(default LASSO_IDWSF2_DISCOVERY_QUERY_RESULT_TYPE_NONE. 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 : |
transfer none)(element-type LassoWsAddrEndpointReference. 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 utf8. |
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 utf8. |