// Matrix Construct // // Copyright (C) Matrix Construct Developers, Authors & Contributors // Copyright (C) 2016-2018 Jason Volk // // Permission to use, copy, modify, and/or distribute this software for any // purpose with or without fee is hereby granted, provided that the above // copyright notice and this permission notice is present in all copies. The // full license for this software is available in the LICENSE file. #pragma once #define HAVE_IRCD_M_KEYS_H namespace ircd::m { struct keys; } namespace ircd::m::self { extern ed25519::sk secret_key; extern ed25519::pk public_key; extern std::string public_key_b64; extern std::string public_key_id; extern std::string tls_cert_der; extern std::string tls_cert_der_sha256_b64; } #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wsubobject-linkage" /// Contains the public keys and proof of identity for a remote server. /// /// A user who wishes to verify a signature from a remote server must have /// the name of the server (origin) and the key_id. Calling the appropriate /// static function of this class will attempt to fetch the key from the db /// or make network requests, with valid response being saved to the db. Keys /// are thus managed internally so the user doesn't supply a buffer or ever /// construct this object; instead this object backed by internal db data is /// presented in the supplied synchronous closure. /// /// 2.2.1.1 Publishing Keys /// /// Key Type, Description /// server_name String, DNS name of the homeserver. /// verify_keys Object, Public keys of the homeserver for verifying digital signatures. /// old_verify_keys Object, The public keys that the server used to use and when it stopped using them. /// signatures Object, Digital signatures for this object signed using the verify_keys. /// tls_fingerprints Array of Objects, Hashes of X.509 TLS certificates used by this this server encoded as Unpadded Base64. /// valid_until_ts Integer, POSIX timestamp when the list of valid keys should be refreshed. /// struct ircd::m::keys :json::tuple < json::property, json::property, json::property, json::property, json::property, json::property > { struct init; public: using closure = std::function; using key_closure = std::function; // remember to unquote()!!! using ed25519_closure = std::function; static void get(const string_view &server_name, const string_view &key_id, const string_view &query_server, const closure &); static void get(const string_view &server_name, const closure &); static void get(const string_view &server_name, const string_view &key_id, const closure &); static void get(const string_view &server_name, const string_view &key_id, const key_closure &); static void get(const string_view &server_name, const string_view &key_id, const ed25519_closure &); using super_type::tuple; using super_type::operator=; }; #pragma GCC diagnostic pop struct ircd::m::keys::init { json::object config; void certificate(); void signing(); public: init(const json::object &config); ~init() noexcept; };