Top |
Description
ESoupAuthBearer adds libsoup support for the use of bearer tokens in HTTP requests to access OAuth 2.0 protected resources, as defined in
RFC 6750.An EBackend should integrate ESoupAuthBearer first by adding it as a
feature to a SoupSession's SoupAuthManager, then from a SoupSession
“authenticate” handler call e_source_get_oauth2_access_token()
and pass the results to e_soup_auth_bearer_set_access_token()
.
Functions
e_soup_auth_bearer_set_access_token ()
void e_soup_auth_bearer_set_access_token (ESoupAuthBearer *bearer
,const gchar *access_token
,gint expires_in_seconds
);
This function is analogous to soup_auth_authenticate()
for "Basic" HTTP
authentication, except it takes an OAuth 2.0 access token instead of a
username and password.
If expires_in_seconds
is greater than zero, soup_auth_is_authenticated()
will return FALSE
after the given number of seconds have elapsed.
Parameters
bearer |
||
access_token |
an OAuth 2.0 access token |
|
expires_in_seconds |
expiry for |
Since: 3.10
e_soup_auth_bearer_is_expired ()
gboolean
e_soup_auth_bearer_is_expired (ESoupAuthBearer *bearer
);
Returns
Whether the set token is expired. It is considered expired even
if the e_soup_auth_bearer_set_access_token()
was called set yet.
Since: 3.24
Types and Values
struct ESoupAuthBearer
struct ESoupAuthBearer;
Contains only private data that should be read and manipulated using the functions below.
Since: 3.10