| 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. |