/* * This file is part of matrix-glib-sdk * * matrix-glib-sdk is free software: you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation, either * version 3 of the License, or (at your option) any later version. * * matrix-glib-sdk is distributed in the hope that it will be * useful, but WITHOUT ANY WARRANTY; without even the implied * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with matrix-glib-sdk. If not, see * . */ #include "matrix-api.h" #include "matrix-http-api.h" #include #include /** * SECTION:matrix-http-api * @short_description: Low level API calls to communicate with a * Matrix.org server via HTTP * @title: MatrixHTTPAPI * @stability: Unstable * @include: matrix-glib/matrix.h * * This is a class for low level communication with a Matrix.org * server via HTTP. */ /** * MatrixHTTPAPI: * * The MatrixHTTPAPI object’s instance definition. */ /** * MatrixHTTPAPIClass: * @parent_class: the parent class structure (#GObjectClass) * * The MatrixHTTPAPI object’s class definition. */ #define API_ENDPOINT "/_matrix/client/api/v1" typedef struct _MatrixHTTPAPIPrivate { SoupSession *soup_session; guint txn_id; gchar *url; gchar *token; gboolean validate_certificate; } MatrixHTTPAPIPrivate; enum { PROP_VALIDATE_CERTIFICATE = 1, PROP_BASE_URL, PROP_TOKEN, N_PROPERTIES }; GParamSpec *obj_properties[N_PROPERTIES] = {NULL,}; static void matrix_http_api_matrix_api_init(MatrixAPIInterface *iface); G_DEFINE_TYPE_WITH_CODE(MatrixHTTPAPI, matrix_http_api, G_TYPE_OBJECT, G_ADD_PRIVATE(MatrixHTTPAPI) G_IMPLEMENT_INTERFACE(MATRIX_TYPE_API, matrix_http_api_matrix_api_init)); static void matrix_http_api_matrix_api_init(MatrixAPIInterface *iface) {} static void matrix_http_api_finalize(GObject *gobject) { g_signal_handlers_destroy(gobject); G_OBJECT_CLASS(matrix_http_api_parent_class)->finalize(gobject); } static void matrix_http_api_set_property(GObject *gobject, guint prop_id, const GValue *value, GParamSpec *pspec) { MatrixHTTPAPI *api = MATRIX_HTTP_API(gobject); MatrixHTTPAPIPrivate *priv = matrix_http_api_get_instance_private(api); switch (prop_id) { case PROP_VALIDATE_CERTIFICATE: priv->validate_certificate = g_value_get_boolean(value); break; case PROP_BASE_URL: { const gchar *base_url; gchar *last_occurence; base_url = g_value_get_string(value); if (!g_str_is_ascii(base_url)) { g_warning("URL specified (%s) is not ASCII", base_url); return; } g_free(priv->url); last_occurence = g_strrstr(base_url, API_ENDPOINT); /* Check if the provided URL already ends with the API endpoint */ if ((g_strcmp0(last_occurence, API_ENDPOINT) == 0) || (g_strcmp0(last_occurence, API_ENDPOINT"/") == 0)) { /* if so, just use it */ priv->url = g_strdup(base_url); } else { /* if not, add the API endpoint */ gchar *url; /* If the provided URL already contains the API * endpoint, but it’s not at the end, print a message, * but still continue */ if (last_occurence != NULL) { g_info("Provided URL (%s) already contains the API endpoint but not at the end; appending anyway", base_url); } url = g_strdup(base_url); if (url[strlen(url) - 1] == '/') { url[strlen(url) - 1] = 0; } priv->url = g_strdup_printf("%s%s", url, API_ENDPOINT); g_free(url); } break; } case PROP_TOKEN: if (priv->token) { g_free(priv->token); } priv->token = g_strdup(g_value_get_string(value)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID(gobject, prop_id, pspec); } } static void matrix_http_api_get_property(GObject *gobject, guint prop_id, GValue *value, GParamSpec *pspec) { MatrixHTTPAPI *api = MATRIX_HTTP_API(gobject); MatrixHTTPAPIPrivate *priv = matrix_http_api_get_instance_private(api); switch (prop_id) { case PROP_VALIDATE_CERTIFICATE: g_value_set_boolean(value, priv->validate_certificate); break; case PROP_BASE_URL: g_value_set_string(value, priv->url); break; case PROP_TOKEN: g_value_set_string(value, priv->token); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID(gobject, prop_id, pspec); } } static void matrix_http_api_class_init(MatrixHTTPAPIClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS(klass); gobject_class->set_property = matrix_http_api_set_property; gobject_class->get_property = matrix_http_api_get_property; gobject_class->finalize = matrix_http_api_finalize; /** * MatrixHTTPAPI:validate-certificate: * * Set to %FALSE if you don’t want the SSL/TLS certificates to be * validated. */ obj_properties[PROP_VALIDATE_CERTIFICATE] = g_param_spec_boolean( "validate-certificate", "Validate certificate", "TRUE if server certificates should be validated", TRUE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); /** * MatrixHTTPAPI:base-url: * * The base URL to use for communication with the Matrix.org * server. If the URL doesn’t end with the correct API endpoint * (/_matrix/client/api/v1), it gets appended automatically. */ obj_properties[PROP_BASE_URL] = g_param_spec_string( "base-url", "Server's base URL", "Matrix.org home server to connect to.", NULL, G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); /** * MatrixHTTPAPI:token: * * The token to use for authorization. The matrix_http_api_login() * and matrix_http_api_register() calls set this automatically. */ obj_properties[PROP_TOKEN] = g_param_spec_string( "token", "Authorization token", "The token to use for authorization", NULL, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); g_object_class_install_properties(gobject_class, N_PROPERTIES, obj_properties); } static void matrix_http_api_init(MatrixHTTPAPI *api) { MatrixHTTPAPIPrivate *priv = matrix_http_api_get_instance_private(api); priv->txn_id = 0; priv->url = NULL; priv->token = NULL; priv->validate_certificate = TRUE; priv->soup_session = soup_session_new_with_options( SOUP_SESSION_ADD_FEATURE_BY_TYPE, SOUP_TYPE_CONTENT_SNIFFER, NULL); } /** * matrix_http_api_new: * @base_url: the URL to use as the API endpoint * @token: (allow-none): an authorization token to use. If %NULL, * requests that need authentication will fail * * Create a new #MatrixHTTPAPI object with the specified base URL, and * an optional authorization token */ MatrixHTTPAPI * matrix_http_api_new(const gchar *base_url, const gchar *token) { return g_object_new(MATRIX_TYPE_HTTP_API, "base-url", base_url, "token", token, NULL); } /** * matrix_http_api_set_validate_certificate: * @api: a #MatrixHTTPAPI implementation * @validate_certificate: %TRUE if server certificates should be * validated * * Sets if server certificates should be validated. */ void matrix_http_api_set_validate_certificate(MatrixHTTPAPI *api, gboolean validate_certificate) { MatrixHTTPAPIPrivate *priv = matrix_http_api_get_instance_private(api); priv->validate_certificate = validate_certificate; } /** * matrix_http_api_get_validate_certificate: * @api: a #MatrixHTTPAPI implementation * * Gets the value set by matrix_http_api_set_validate_certificate() * * Returns: %TRUE if the server certificates should be validated */ gboolean matrix_http_api_get_validate_certificate(MatrixHTTPAPI *api) { MatrixHTTPAPIPrivate *priv = matrix_http_api_get_instance_private(api); return priv->validate_certificate; }