using Grpc.Core; using Microsoft.Extensions.Logging.Abstractions; using Microsoft.Extensions.Options; using Shouldly; using Xunit; using ZB.MOM.WW.OtOpcUa.Cluster; using ZB.MOM.WW.OtOpcUa.Host.Configuration; namespace ZB.MOM.WW.OtOpcUa.Host.Tests.Configuration; /// /// mesh gRPC command plane, Phase 0 — the node-side command endpoint's inbound gate. Mapping /// NodeCommandService onto the pipeline is a Phase 1 task; this test covers only the /// interceptor's own authorization behavior. /// /// /// Same contract as , scoped to /// /mesh_transport.v1.NodeCommandService/ — fail-closed on an unconfigured key, /// constant-time comparison, gated on every handler shape so scoping holds regardless of RPC /// shape. Deliberately NO x-otopcua-cluster requirement: that header is a central-side /// routing hint, and requiring it here would gate on a value the caller chooses. /// public sealed class MeshCommandAuthInterceptorTests { private const string ExecuteMethod = "/mesh_transport.v1.NodeCommandService/Execute"; private const string OtherMethod = "/telemetry.v1.TelemetryStreamService/Subscribe"; private static MeshCommandAuthInterceptor CreateInterceptor(string? psk) => new( Options.Create(new MeshTransportOptions { GrpcPsk = psk }), NullLogger.Instance); private static ServerCallContext CreateContext(string method, string? authorizationHeader) => CreateContext(method, authorizationHeader is null ? [] : [authorizationHeader]); private static ServerCallContext CreateContext(string method, string[] authorizationHeaders) { var headers = new Metadata(); foreach (var value in authorizationHeaders) headers.Add("authorization", value); return new FakeServerCallContext(method, headers); } /// Invokes the interceptor's unary path (how Execute actually runs). private static Task Invoke(MeshCommandAuthInterceptor interceptor, ServerCallContext context) => interceptor.UnaryServerHandler( "request", context, (_, _) => Task.FromResult("ok")); [Fact] public async Task NonMeshCommandMethod_PassesThrough_EvenWithNoPskConfigured() { // The interceptor shares the AddGrpc pipeline with the sync / config-serve / telemetry // services, so it sees every call. It must be scoped strictly to the node command service. var interceptor = CreateInterceptor(psk: null); var context = CreateContext(OtherMethod, authorizationHeader: null); await Invoke(interceptor, context); // no throw } [Fact] public async Task ExecuteMethod_WithNoPskConfigured_IsDenied_EvenWithABearerToken() { // Fail-closed. "No PSK configured" is the DEFAULT — treating it as "no auth required" would // let anything that can reach the port drive RestartDriver / AlarmCommand / deployment // dispatch on this node. A token must not help. var interceptor = CreateInterceptor(psk: null); var context = CreateContext(ExecuteMethod, "Bearer anything-at-all"); var ex = await Should.ThrowAsync(() => Invoke(interceptor, context)); ex.StatusCode.ShouldBe(StatusCode.PermissionDenied); } [Fact] public async Task ExecuteMethod_WithBlankPskConfigured_IsDenied() { // Blank is distinct from unset in the options (GrpcPsk is nullable on purpose) but must be // treated identically here: an empty expected token would be satisfied by an empty bearer. var interceptor = CreateInterceptor(" "); var context = CreateContext(ExecuteMethod, "Bearer "); var ex = await Should.ThrowAsync(() => Invoke(interceptor, context)); ex.StatusCode.ShouldBe(StatusCode.PermissionDenied); } [Fact] public async Task ExecuteMethod_WithNoBearerToken_IsDenied() { var interceptor = CreateInterceptor("the-cluster-psk"); var context = CreateContext(ExecuteMethod, authorizationHeader: null); var ex = await Should.ThrowAsync(() => Invoke(interceptor, context)); ex.StatusCode.ShouldBe(StatusCode.PermissionDenied); } [Fact] public async Task ExecuteMethod_WithMalformedAuthorizationHeader_IsDenied() { // No "Bearer " prefix at all — must be treated the same as a missing header. var interceptor = CreateInterceptor("the-cluster-psk"); var context = CreateContext(ExecuteMethod, "the-cluster-psk"); var ex = await Should.ThrowAsync(() => Invoke(interceptor, context)); ex.StatusCode.ShouldBe(StatusCode.PermissionDenied); } [Fact] public async Task ExecuteMethod_WithWrongBearerToken_IsDenied() { // This is also the isolation proof: a node holding SITE-A's PSK rejects a caller presenting // SITE-B's. Nothing about the cluster id is consulted — only whether the key matches. var interceptor = CreateInterceptor("dev-mesh-psk-SITE-A"); var context = CreateContext(ExecuteMethod, "Bearer dev-mesh-psk-SITE-B"); var ex = await Should.ThrowAsync(() => Invoke(interceptor, context)); ex.StatusCode.ShouldBe(StatusCode.PermissionDenied); } [Fact] public async Task ExecuteMethod_WithCorrectBearerToken_PassesThrough() { var interceptor = CreateInterceptor("the-cluster-psk"); var context = CreateContext(ExecuteMethod, "Bearer the-cluster-psk"); await Invoke(interceptor, context); // no throw } [Fact] public async Task ExecuteMethod_WithCorrectBearerToken_AndNoClusterHeader_PassesThrough() { // x-otopcua-cluster is a central-side routing hint. Requiring it here would gate on a value // the caller supplies about itself, which proves nothing the PSK has not already proven. var interceptor = CreateInterceptor("the-cluster-psk"); var context = CreateContext(ExecuteMethod, "Bearer the-cluster-psk"); await Invoke(interceptor, context); // no throw } [Fact] public async Task ExecuteMethod_WithAJunkAuthorizationHeaderBeforeTheRealOne_IsDenied() { // First entry wins, and it must parse. This interceptor originally scanned past a non-Bearer // header for a later Bearer one while its central-side clone took the first entry, so the // two clones gave OPPOSITE answers to this exact request. Both now share // GrpcRequestHeaders and both deny it; pinned identically on CentralCommandAuthInterceptor. var interceptor = CreateInterceptor("the-cluster-psk"); var context = CreateContext(ExecuteMethod, ["junk", "Bearer the-cluster-psk"]); var ex = await Should.ThrowAsync(() => Invoke(interceptor, context)); ex.StatusCode.ShouldBe(StatusCode.PermissionDenied); } [Fact] public async Task ExecuteMethod_TokenComparison_IsNotAPrefixMatch() { // A prefix/StartsWith comparison would accept a truncated key and make the secret // recoverable one character at a time. var interceptor = CreateInterceptor("the-cluster-psk"); var context = CreateContext(ExecuteMethod, "Bearer the-cluster-ps"); var ex = await Should.ThrowAsync(() => Invoke(interceptor, context)); ex.StatusCode.ShouldBe(StatusCode.PermissionDenied); } [Fact] public async Task ServerStreamingPath_IsAlsoGated() { // Execute is unary today, but gating only that path would leave any future streaming method // on the same service open. Gate every handler shape. var interceptor = CreateInterceptor("the-cluster-psk"); var context = CreateContext(ExecuteMethod, "Bearer the-wrong-psk"); var ex = await Should.ThrowAsync(() => interceptor.ServerStreamingServerHandler( "request", responseStream: null!, context, (_, _, _) => Task.CompletedTask)); ex.StatusCode.ShouldBe(StatusCode.PermissionDenied); } [Fact] public async Task ClientStreamingPath_IsAlsoGated() { var interceptor = CreateInterceptor("the-cluster-psk"); var context = CreateContext(ExecuteMethod, "Bearer the-wrong-psk"); var ex = await Should.ThrowAsync(() => interceptor.ClientStreamingServerHandler( requestStream: null!, context, (_, _) => Task.FromResult("ok"))); ex.StatusCode.ShouldBe(StatusCode.PermissionDenied); } [Fact] public async Task DuplexStreamingPath_IsAlsoGated() { var interceptor = CreateInterceptor("the-cluster-psk"); var context = CreateContext(ExecuteMethod, "Bearer the-wrong-psk"); var ex = await Should.ThrowAsync(() => interceptor.DuplexStreamingServerHandler( requestStream: null!, responseStream: null!, context, (_, _, _) => Task.CompletedTask)); ex.StatusCode.ShouldBe(StatusCode.PermissionDenied); } [Fact] public void HasExactlyOnePublicConstructor() { // Grpc.AspNetCore silently stops invoking an interceptor with more than one public ctor — // this pins the shape so a well-meaning overload doesn't quietly disable auth in production. var publicCtors = typeof(MeshCommandAuthInterceptor).GetConstructors(); publicCtors.Length.ShouldBe(1); } /// /// Minimal carrying just a method name and request headers — /// the only two things the interceptor reads. Hand-rolled because /// Grpc.Core.Testing.TestServerCallContext ships only in the retired native package. /// private sealed class FakeServerCallContext(string method, Metadata requestHeaders) : ServerCallContext { protected override string MethodCore => method; protected override string HostCore => "localhost"; protected override string PeerCore => "ipv4:127.0.0.1:12345"; protected override DateTime DeadlineCore => DateTime.UtcNow.AddMinutes(1); protected override Metadata RequestHeadersCore => requestHeaders; protected override CancellationToken CancellationTokenCore => CancellationToken.None; protected override Metadata ResponseTrailersCore { get; } = []; protected override Status StatusCore { get; set; } protected override WriteOptions? WriteOptionsCore { get; set; } protected override AuthContext AuthContextCore { get; } = new(null, new Dictionary>()); protected override ContextPropagationToken CreatePropagationTokenCore( ContextPropagationOptions? options) => throw new NotSupportedException(); protected override Task WriteResponseHeadersAsyncCore(Metadata responseHeaders) => Task.CompletedTask; } }