Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 3m13s
Foundation / checks (client) (push) Successful in 12m12s
Foundation / checks (network) (push) Successful in 8m56s
Foundation / checks (tsan) (push) Successful in 7m42s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (postgres) (push) Canceled after 19m14s
Foundation / checks (checks) (push) Canceled after 31m28s
Session protocol v1 session messages (Hello with grant, Welcome, Refresh, RefreshResult, Close with reasons) on the QUIC reliable stream. RegionSessions verifies grants with the issuer public keys and admits them through SessionControl: a newer grant closes the account's old connection as superseded, expiry and epoch advances close sessions, every close is announced and flushed. RegionSessionClient logs in, refreshes in place and reports why a session ended. ADR-0091. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
67 lines
2.9 KiB
C++
67 lines
2.9 KiB
C++
#pragma once
|
|
#include "evo/network/quic_transport.hpp"
|
|
#include "evo/network/session_control.hpp"
|
|
#include "evo/network/session_grant.hpp"
|
|
#include "evo/network/session_protocol.hpp"
|
|
#include <chrono>
|
|
#include <cstddef>
|
|
#include <cstdint>
|
|
#include <expected>
|
|
#include <memory>
|
|
#include <optional>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
// M10.3b region-side session login over QUIC (ADR-0091, schemas/network/session-v1.md).
|
|
// Owned by the region host's thread, which calls poll(). A connection must send Hello
|
|
// with a grant before the deadline; the grant is verified with the region's issuer
|
|
// public keys and admitted by SessionControl. A newer grant for an account closes the
|
|
// account's previous connection with `superseded`. Refusals and closes send Close with a
|
|
// reason, then the connection is closed after a short flush. Intentions and views are
|
|
// later segments (10.4, 10.5). Events carry account log labels only, never grants.
|
|
namespace evo::server {
|
|
struct IssuerKey {
|
|
std::uint32_t key_id{};
|
|
network::GrantPublicKey public_key{};
|
|
};
|
|
struct RegionSessionsConfig {
|
|
network::quic::ServerConfig transport;
|
|
network::ControlConfig control; // `epoch` is the initial ownership epoch.
|
|
std::vector<IssuerKey> issuer_keys;
|
|
std::chrono::milliseconds hello_deadline{5000}; // Connected to Hello (ADR-0089).
|
|
std::chrono::milliseconds close_flush{1000}; // Close sent to connection closed.
|
|
};
|
|
enum class RegionSessionsError : std::uint8_t { configuration, keys, transport };
|
|
struct RegionSessionEvent {
|
|
enum class Kind : std::uint8_t { opened, closed, refused } kind{};
|
|
std::uint64_t session{}; // 0 for refusals.
|
|
std::string account; // log_label, empty when unauthenticated.
|
|
network::SessionCloseReason reason{};
|
|
};
|
|
|
|
class RegionSessions {
|
|
public:
|
|
[[nodiscard]] static std::expected<std::unique_ptr<RegionSessions>, RegionSessionsError>
|
|
create(RegionSessionsConfig config);
|
|
RegionSessions(const RegionSessions&) = delete;
|
|
RegionSessions& operator=(const RegionSessions&) = delete;
|
|
~RegionSessions();
|
|
// `epoch` is the region's current ownership epoch: a newer one closes every session
|
|
// (stale_epoch). `now_seconds` is wall time for grants, `now` monotonic for deadlines.
|
|
void poll(std::uint64_t epoch, std::uint64_t now_seconds,
|
|
std::chrono::steady_clock::time_point now);
|
|
// Closes every connection with `shutdown` (flushed by later polls).
|
|
void shutdown(std::chrono::steady_clock::time_point now);
|
|
[[nodiscard]] std::vector<RegionSessionEvent> take_events();
|
|
[[nodiscard]] std::optional<std::uint64_t> holder(const network::AccountId& account) const;
|
|
[[nodiscard]] std::size_t sessions() const noexcept;
|
|
[[nodiscard]] std::size_t connections() const noexcept;
|
|
[[nodiscard]] std::uint16_t port() const noexcept;
|
|
|
|
private:
|
|
struct Impl;
|
|
explicit RegionSessions(std::unique_ptr<Impl> impl);
|
|
std::unique_ptr<Impl> impl_;
|
|
};
|
|
} // namespace evo::server
|