re-add token auth

This commit is contained in:
Iuri Matias
2026-06-05 14:48:16 -04:00
parent b7eb07efed
commit 124fd51860
8 changed files with 400 additions and 1 deletions
+64
View File
@@ -1,8 +1,11 @@
#include "module_proxy.h"
#include "logos_provider_object.h"
#include "token_manager.h"
#include <QDebug>
#include <QByteArray>
#include <QJsonObject>
#include <QJsonValue>
#include <algorithm>
ModuleProxy::ModuleProxy(LogosProviderObject* provider, QObject* parent)
: QObject(parent)
@@ -75,6 +78,18 @@ QVariant ModuleProxy::callRemoteMethod(const QString& authToken, const QString&
if (methodName == "getPluginInterface" && args.isEmpty()) {
return QVariant(getPluginInterface());
}
// NOTE: the three getPlugin* introspection calls above intentionally stay
// ungated. They expose only the method/event signatures (no business logic
// or state) and are needed before any token exists — a caller discovers a
// module's interface as part of the connection handshake, ahead of the
// capability_module token exchange. Everything past this point is a real
// business-method dispatch and MUST be authorized.
if (!isAuthorized(authToken)) {
qWarning() << "ModuleProxy: rejecting unauthorized call to" << methodName
<< "- auth token not recognized";
return QVariant();
}
qDebug() << "ModuleProxy: callRemoteMethod" << methodName << "args:" << args;
return m_provider->callMethod(methodName, args);
@@ -92,6 +107,55 @@ bool ModuleProxy::informModuleToken(const QString& authToken, const QString& mod
return m_provider->informModuleToken(moduleName, token);
}
namespace {
// note: this is to ensure comparison is constant time to prevent timing attacks
// Length-independent constant-time comparison of two tokens. Returns true only
// when both byte sequences are identical. We compare over the longer of the two
// lengths (folding any length difference into the result) so the running time
// does not reveal a correct prefix or the secret's length.
bool constantTimeEquals(const QString& a, const QString& b)
{
const QByteArray ba = a.toUtf8();
const QByteArray bb = b.toUtf8();
const int n = std::max(ba.size(), bb.size());
// A different length is a mismatch, but keep scanning to stay constant-time.
int diff = ba.size() ^ bb.size();
for (int i = 0; i < n; ++i) {
const unsigned char ca = i < ba.size() ? static_cast<unsigned char>(ba[i]) : 0;
const unsigned char cb = i < bb.size() ? static_cast<unsigned char>(bb[i]) : 0;
diff |= (ca ^ cb);
}
return diff == 0;
}
} // namespace
bool ModuleProxy::isAuthorized(const QString& authToken) const
{
// Fail closed: an empty token is never valid, even if some empty value
// somehow ended up in a token store.
if (authToken.isEmpty()) {
return false;
}
// A token is valid only if THIS module actually issued it to some caller.
// Two stores hold issued tokens:
// * m_tokens — legacy per-proxy store (LogosAPIProvider::saveToken)
// * TokenManager — the capability-flow store that informModuleToken
// writes when capability_module mints a token for a
// (caller, target) pair.
// We scan every issued token with a constant-time compare and never early
// out, so neither a match position nor the number of issued tokens leaks
// through timing.
bool authorized = false;
for (auto it = m_tokens.constBegin(); it != m_tokens.constEnd(); ++it) {
authorized |= constantTimeEquals(authToken, it.value());
}
for (const QString& key : TokenManager::instance().getTokenKeys()) {
authorized |= constantTimeEquals(authToken, TokenManager::instance().getToken(key));
}
return authorized;
}
namespace {
// getMethods() returns the module's full interface — both methods and events,
// each tagged with a "type" ("method"/"event"). Split it back out. An entry
+6
View File
@@ -43,6 +43,12 @@ signals:
void eventResponse(const QString& eventName, const QVariantList& data);
private:
// Returns true only when authToken matches a token THIS module has issued
// (via saveToken / informModuleToken). Empty/unknown tokens are rejected.
// Comparison is constant-time and never early-outs, so neither a correct
// prefix nor the number of issued tokens leaks through timing.
bool isAuthorized(const QString& authToken) const;
LogosProviderObject* m_provider;
QHash<QString, QString> m_tokens;
};
+4 -1
View File
@@ -273,7 +273,10 @@ QVariant QtProviderObject::callMethod(const QString& methodName, const QVariantL
return QVariant(getMethods());
}
// Auth-token validation (mirrors the old ModuleProxy logic)
// No auth check here by design: this adapter has no token parameter and is
// only ever reached through ModuleProxy::callRemoteMethod, which authorizes
// the caller's token before dispatching (see ModuleProxy::isAuthorized).
// The checks below are sanity guards on the wrapped plugin, not authz.
PluginInterface* pluginInterface = qobject_cast<PluginInterface*>(m_module);
if (!pluginInterface) {
qWarning() << "[LogosProviderObject] QtProviderObject::callMethod: module is not a PluginInterface";
+1
View File
@@ -34,6 +34,7 @@ add_executable(sdk_tests
test_logos_provider_base.cpp
test_logos_module_context.cpp
test_module_proxy.cpp
test_auth_token_enforcement.cpp
test_logos_api_provider.cpp
test_mock_transport.cpp
test_local_transport_integration.cpp
+318
View File
@@ -0,0 +1,318 @@
// Security regression tests for the provider-side auth-token enforcement.
//
// These pin down two findings:
//
// F-001 ModuleProxy::callRemoteMethod accepted authToken but never validated
// it — any peer could dispatch any method with an empty/garbage token.
//
// F-002 QtProviderObject::callMethod (the legacy QObject dispatch sink, always
// reached *through* a ModuleProxy) carried a comment claiming auth-token
// validation but performed none. Enforcing centrally in ModuleProxy
// closes this path too.
//
// ModuleProxy::callRemoteMethod is the single provider-side dispatch sink for
// every transport (Local and plain/TCP both invoke it), so enforcement there is
// the choke point that authorizes both new-API (LogosProviderBase) providers and
// legacy QObject plugins wrapped by QtProviderObject.
#include <gtest/gtest.h>
#include <QJsonObject>
#include "logos_api.h"
#include "logos_provider_object.h"
#include "qt_provider_object.h"
#include "module_proxy.h"
#include "token_manager.h"
#include "logos_mode.h"
#include "logos_object.h"
#include "plugin_registry.h"
#include "local_transport.h"
#include "../../core/interface.h"
// ── New-API provider (LogosProviderBase) ────────────────────────────────────
class AuthTestProvider : public LogosProviderBase {
public:
QString providerName() const override { return "auth_test"; }
QString providerVersion() const override { return "1.0.0"; }
QVariant callMethod(const QString& methodName, const QVariantList& args) override
{
lastMethodCalled = methodName;
lastArgs = args;
return QVariant(QStringLiteral("dispatched"));
}
QJsonArray getMethods() override
{
QJsonArray arr;
QJsonObject m;
m["type"] = "method";
m["name"] = "privilegedMethod";
arr.append(m);
return arr;
}
QString lastMethodCalled;
QVariantList lastArgs;
};
// ── Legacy QObject plugin wrapped by QtProviderObject (F-002 path) ───────────
class LegacyQObjectPlugin : public QObject, public PluginInterface {
Q_OBJECT
Q_INTERFACES(PluginInterface)
public:
QString name() const override { return "legacy_mod"; }
QString version() const override { return "1.0.0"; }
Q_INVOKABLE QString deleteAllData(const QString& arg)
{
privilegedCalled = true;
return QStringLiteral("deleted:") + arg;
}
bool privilegedCalled = false;
};
class AuthTokenEnforcementTest : public ::testing::Test {
protected:
void SetUp() override
{
TokenManager::instance().clearAllTokens();
m_provider = new AuthTestProvider();
}
void TearDown() override
{
delete m_provider;
TokenManager::instance().clearAllTokens();
}
AuthTestProvider* m_provider = nullptr;
};
// ── F-001: dispatch must reject unauthorized tokens ─────────────────────────
TEST_F(AuthTokenEnforcementTest, RejectsGarbageTokenForNewApiProvider)
{
ModuleProxy proxy(m_provider);
// No token was ever issued to any caller. A peer supplies a garbage token.
QVariant r = proxy.callRemoteMethod("garbage-token", "privilegedMethod", {QVariant(1)});
EXPECT_FALSE(r.isValid()) << "unauthorized call must not return a dispatched result";
EXPECT_TRUE(m_provider->lastMethodCalled.isEmpty())
<< "provider method must NOT be dispatched without a valid token (F-001)";
}
TEST_F(AuthTokenEnforcementTest, RejectsEmptyToken)
{
ModuleProxy proxy(m_provider);
QVariant r = proxy.callRemoteMethod("", "privilegedMethod", {QVariant(1)});
EXPECT_FALSE(r.isValid());
EXPECT_TRUE(m_provider->lastMethodCalled.isEmpty())
<< "empty token must be rejected (fail-closed)";
}
// ── F-001: a token actually issued to a caller is accepted ──────────────────
TEST_F(AuthTokenEnforcementTest, AcceptsTokenIssuedViaTokenManager)
{
ModuleProxy proxy(m_provider);
// The capability flow stores the issued token in TokenManager keyed by the
// requesting module (informModuleToken -> TokenManager::saveToken).
TokenManager::instance().saveToken("caller_mod", "issued-tok");
QVariant r = proxy.callRemoteMethod("issued-tok", "privilegedMethod", {QVariant(1)});
EXPECT_EQ(r.toString(), "dispatched");
EXPECT_EQ(m_provider->lastMethodCalled, "privilegedMethod");
}
TEST_F(AuthTokenEnforcementTest, AcceptsTokenIssuedViaLegacySaveToken)
{
ModuleProxy proxy(m_provider);
// Legacy provider-side token store (LogosAPIProvider::saveToken -> ModuleProxy::saveToken).
ASSERT_TRUE(proxy.saveToken("caller_mod", "legacy-tok"));
QVariant r = proxy.callRemoteMethod("legacy-tok", "privilegedMethod", {QVariant(1)});
EXPECT_EQ(r.toString(), "dispatched");
EXPECT_EQ(m_provider->lastMethodCalled, "privilegedMethod");
}
TEST_F(AuthTokenEnforcementTest, RejectsTokenNotMatchingAnyIssued)
{
ModuleProxy proxy(m_provider);
// A valid token exists for some caller, but the peer presents a different one.
TokenManager::instance().saveToken("caller_mod", "issued-tok");
QVariant r = proxy.callRemoteMethod("some-other-token", "privilegedMethod", {QVariant(1)});
EXPECT_FALSE(r.isValid());
EXPECT_TRUE(m_provider->lastMethodCalled.isEmpty())
<< "a token never issued by this module must not be honoured (replay/forge)";
}
// The core discriminator, on a SINGLE issued-token state: a wrong token is
// blocked AND never reaches the provider, while the correct token dispatches.
// This is the exact behaviour the dropped guard used to provide; if the guard
// is removed again the first half of this test fails (the wrong token goes
// through), which is precisely the F-001 regression.
TEST_F(AuthTokenEnforcementTest, WrongTokenBlockedCorrectTokenAllowed)
{
ModuleProxy proxy(m_provider);
TokenManager::instance().saveToken("caller_mod", "the-real-token");
// 1) Wrong token: must NOT dispatch, must NOT return a result.
QVariant wrong = proxy.callRemoteMethod("not-the-token", "privilegedMethod", {QVariant(1)});
EXPECT_FALSE(wrong.isValid()) << "wrong token must not produce a result";
EXPECT_TRUE(m_provider->lastMethodCalled.isEmpty())
<< "wrong token must not reach the provider (the F-001 guard)";
EXPECT_TRUE(m_provider->lastArgs.isEmpty())
<< "wrong token must not forward args to the provider";
// 2) Correct token, same state: must dispatch through to the provider.
QVariant ok = proxy.callRemoteMethod("the-real-token", "privilegedMethod", {QVariant(7)});
EXPECT_EQ(ok.toString(), "dispatched");
EXPECT_EQ(m_provider->lastMethodCalled, "privilegedMethod");
ASSERT_EQ(m_provider->lastArgs.size(), 1);
EXPECT_EQ(m_provider->lastArgs[0].toInt(), 7);
}
// ── Introspection stays reachable (used for interface discovery during the
// handshake, before a token exists; also exposed via a separate ungated
// transport channel). Gating it here would be false security and would break
// bootstrap, so the special-cases must remain ungated. ─────────────────────
TEST_F(AuthTokenEnforcementTest, IntrospectionRemainsReachableWithoutToken)
{
ModuleProxy proxy(m_provider);
QVariant methods = proxy.callRemoteMethod("garbage-token", "getPluginMethods");
EXPECT_GT(methods.toJsonArray().size(), 0);
// Introspection must not be mistaken for a dispatched business method.
EXPECT_TRUE(m_provider->lastMethodCalled.isEmpty());
}
// ── F-002: the legacy QObject path (QtProviderObject), reached through a
// ModuleProxy, must also be authorized. ──────────────────────────────────
class LegacyPluginAuthTest : public ::testing::Test {
protected:
void SetUp() override
{
TokenManager::instance().clearAllTokens();
m_plugin = new LegacyQObjectPlugin();
// QtProviderObject::callMethod bails early if logosAPI is null; set it so
// that, absent enforcement, dispatch would actually reach the method.
m_api = new LogosAPI("legacy_mod");
m_plugin->logosAPI = m_api;
m_qtProvider = new QtProviderObject(m_plugin);
}
void TearDown() override
{
delete m_qtProvider;
delete m_plugin;
delete m_api;
TokenManager::instance().clearAllTokens();
}
LegacyQObjectPlugin* m_plugin = nullptr;
QtProviderObject* m_qtProvider = nullptr;
LogosAPI* m_api = nullptr;
};
TEST_F(LegacyPluginAuthTest, RejectsGarbageTokenForLegacyQObjectPlugin)
{
ModuleProxy proxy(m_qtProvider);
QVariant r = proxy.callRemoteMethod("garbage-token", "deleteAllData",
{QVariant("everything")});
EXPECT_FALSE(r.isValid());
EXPECT_FALSE(m_plugin->privilegedCalled)
<< "legacy QObject privileged method invoked with no valid token (F-002)";
}
TEST_F(LegacyPluginAuthTest, AcceptsIssuedTokenForLegacyQObjectPlugin)
{
ModuleProxy proxy(m_qtProvider);
TokenManager::instance().saveToken("caller_mod", "issued-tok");
QVariant r = proxy.callRemoteMethod("issued-tok", "deleteAllData",
{QVariant("everything")});
EXPECT_TRUE(m_plugin->privilegedCalled);
EXPECT_EQ(r.toString(), "deleted:everything");
}
// ── End-to-end through the real Local transport ─────────────────────────────
//
// The findings describe the threat as "any peer that can reach the object".
// The reject tests above call ModuleProxy directly; this one drives the full
// consumer-facing path a remote caller actually uses —
// LocalLogosObject::callMethod(authToken, ...) -> ModuleProxy::callRemoteMethod
// -> provider — to prove enforcement holds at the transport boundary, not just
// when ModuleProxy is poked in isolation.
class AuthEnforcementTransportTest : public ::testing::Test {
protected:
void SetUp() override
{
m_savedMode = LogosModeConfig::getMode();
LogosModeConfig::setMode(LogosMode::Local);
TokenManager::instance().clearAllTokens();
m_provider = new AuthTestProvider();
m_proxy = new ModuleProxy(m_provider);
}
void TearDown() override
{
PluginRegistry::unregisterPlugin("auth_mod");
delete m_proxy;
delete m_provider;
TokenManager::instance().clearAllTokens();
LogosModeConfig::setMode(m_savedMode);
}
LogosMode m_savedMode;
AuthTestProvider* m_provider = nullptr;
ModuleProxy* m_proxy = nullptr;
};
TEST_F(AuthEnforcementTransportTest, WrongTokenBlockedThroughTransport)
{
LocalTransportHost host;
host.publishObject("auth_mod", m_proxy);
LocalTransportConnection conn;
LogosObject* obj = conn.requestObject("auth_mod", 5000);
ASSERT_NE(obj, nullptr);
TokenManager::instance().saveToken("caller_mod", "the-real-token");
// A peer with the wrong token hits the published object directly.
QVariant r = obj->callMethod("forged-token", "privilegedMethod", {QVariant(1)}, 5000);
EXPECT_FALSE(r.isValid());
EXPECT_TRUE(m_provider->lastMethodCalled.isEmpty())
<< "forged token must not reach the provider through the transport";
obj->release();
}
TEST_F(AuthEnforcementTransportTest, CorrectTokenAllowedThroughTransport)
{
LocalTransportHost host;
host.publishObject("auth_mod", m_proxy);
LocalTransportConnection conn;
LogosObject* obj = conn.requestObject("auth_mod", 5000);
ASSERT_NE(obj, nullptr);
TokenManager::instance().saveToken("caller_mod", "the-real-token");
QVariant r = obj->callMethod("the-real-token", "privilegedMethod", {QVariant(1)}, 5000);
EXPECT_EQ(r.toString(), "dispatched");
EXPECT_EQ(m_provider->lastMethodCalled, "privilegedMethod");
obj->release();
}
#include "test_auth_token_enforcement.moc"
@@ -54,12 +54,16 @@ protected:
LogosModeConfig::setMode(LogosMode::Local);
m_provider = new LocalTestProvider();
m_proxy = new ModuleProxy(m_provider);
// Authorize the "auth" token the dispatch tests below present, so they
// exercise the call path rather than the (now-enforced) authz rejection.
m_proxy->saveToken("caller", "auth");
}
void TearDown() override
{
PluginRegistry::unregisterPlugin("local_mod");
delete m_proxy;
delete m_provider;
TokenManager::instance().clearAllTokens();
LogosModeConfig::setMode(m_savedMode);
}
LogosMode m_savedMode;
+1
View File
@@ -66,6 +66,7 @@ protected:
TEST_F(ModuleProxyTest, CallRemoteMethodDispatchesToProvider)
{
ModuleProxy proxy(m_provider);
proxy.saveToken("caller", "token"); // authorize the caller's token
QVariant r = proxy.callRemoteMethod("token", "myMethod", {QVariant(1)});
EXPECT_EQ(r.toInt(), 99);
EXPECT_EQ(m_provider->lastMethodCalled, "myMethod");
+2
View File
@@ -216,6 +216,8 @@ protected:
TokenManager::instance().clearAllTokens();
m_provider = new SampleProvider();
m_proxy = new ModuleProxy(m_provider);
// Authorize the "auth" token the full-stack tests present.
m_proxy->saveToken("caller", "auth");
}
void TearDown() override
{