Stella Router ASP.NET WebService Integration Guide

This guide explains how to integrate any ASP.NET Core WebService with the Stella Router for automatic endpoint discovery and dispatch.

Prerequisites

Add a project reference to StellaOps.Router.AspNet:

<ProjectReference Include="../../__Libraries/StellaOps.Router.AspNet/StellaOps.Router.AspNet.csproj" />

Integration Steps

1. Add Router Options to Service Options

In your service's options class (e.g., MyServiceOptions.cs), add:

using StellaOps.Router.AspNet;

public class MyServiceOptions
{
    // ... existing options ...

    /// <summary>
    /// Stella Router integration configuration (disabled by default).
    /// </summary>
    public StellaRouterOptionsBase? Router { get; set; }
}

2. Register Services in Program.cs

Add the using directive:

using StellaOps.Router.AspNet;

After service registration (e.g., after AddControllers()), add:

// Stella Router integration
builder.Services.TryAddStellaRouter(
    serviceName: "my-service-name",
    version: typeof(Program).Assembly.GetName().Version?.ToString() ?? "1.0.0",
    routerOptions: options.Router);

3. Enable Middleware

After UseAuthorization(), add:

app.TryUseStellaRouter(resolvedOptions.Router);

4. Refresh Endpoint Cache

After all endpoints are mapped (before app.RunAsync()), add:

app.TryRefreshStellaRouterEndpoints(resolvedOptions.Router);

Configuration Example (YAML)

myservice:
  router:
    enabled: true
    region: "us-east-1"
    defaultTimeoutSeconds: 30
    heartbeatIntervalSeconds: 10
    gateways:
      - host: "router.stellaops.local"
        port: 9100
        transportType: "Tcp"
        useTls: true
        certificatePath: "/etc/certs/router.pem"

WebServices Integration Status

All WebServices have been updated with Router integration:

Service	Path	Status
Scanner.WebService	`src/Scanner/StellaOps.Scanner.WebService`	✅ Complete
Concelier.WebService	`src/Concelier/StellaOps.Concelier.WebService`	✅ Complete
Excititor.WebService	`src/Excititor/StellaOps.Excititor.WebService`	✅ Complete
Gateway.WebService	`src/Gateway/StellaOps.Gateway.WebService`	✅ Complete
VexHub.WebService	`src/VexHub/StellaOps.VexHub.WebService`	✅ Complete
Attestor.WebService	`src/Attestor/StellaOps.Attestor/StellaOps.Attestor.WebService`	✅ Complete
EvidenceLocker.WebService	`src/EvidenceLocker/StellaOps.EvidenceLocker/StellaOps.EvidenceLocker.WebService`	✅ Complete
Findings.Ledger.WebService	`src/Findings/StellaOps.Findings.Ledger.WebService`	✅ Complete
AdvisoryAI.WebService	`src/AdvisoryAI/StellaOps.AdvisoryAI.WebService`	✅ Complete
IssuerDirectory.WebService	`src/IssuerDirectory/StellaOps.IssuerDirectory/StellaOps.IssuerDirectory.WebService`	✅ Complete
Notifier.WebService	`src/Notifier/StellaOps.Notifier/StellaOps.Notifier.WebService`	✅ Complete
Notify.WebService	`src/Notify/StellaOps.Notify.WebService`	✅ Complete
PacksRegistry.WebService	`src/PacksRegistry/StellaOps.PacksRegistry/StellaOps.PacksRegistry.WebService`	✅ Complete
RiskEngine.WebService	`src/RiskEngine/StellaOps.RiskEngine/StellaOps.RiskEngine.WebService`	✅ Complete
Signer.WebService	`src/Signer/StellaOps.Signer/StellaOps.Signer.WebService`	✅ Complete
TaskRunner.WebService	`src/TaskRunner/StellaOps.TaskRunner/StellaOps.TaskRunner.WebService`	✅ Complete
TimelineIndexer.WebService	`src/TimelineIndexer/StellaOps.TimelineIndexer/StellaOps.TimelineIndexer.WebService`	✅ Complete
Orchestrator.WebService	`src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.WebService`	✅ Complete
Scheduler.WebService	`src/Scheduler/StellaOps.Scheduler.WebService`	✅ Complete
ExportCenter.WebService	`src/ExportCenter/StellaOps.ExportCenter/StellaOps.ExportCenter.WebService`	✅ Complete

Files Created

The Router.AspNet library includes the following files:

StellaOps.Router.AspNet.csproj - Project file
StellaRouterOptions.cs - Unified router options
StellaRouterExtensions.cs - DI extensions (AddStellaRouter, UseStellaRouter)
CompositeRequestDispatcher.cs - Routes requests to ASP.NET or Stella endpoints
StellaRouterOptionsBase.cs - Base options class for embedding in service options
StellaRouterIntegrationHelper.cs - Helper methods for conditional integration

4.5 KiB Raw Blame History