121 lines
4.5 KiB
Markdown
121 lines
4.5 KiB
Markdown
# 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`:
|
|
|
|
```xml
|
|
<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:
|
|
|
|
```csharp
|
|
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:
|
|
|
|
```csharp
|
|
using StellaOps.Router.AspNet;
|
|
```
|
|
|
|
After service registration (e.g., after `AddControllers()`), add:
|
|
|
|
```csharp
|
|
// 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:
|
|
|
|
```csharp
|
|
app.TryUseStellaRouter(resolvedOptions.Router);
|
|
```
|
|
|
|
### 4. Refresh Endpoint Cache
|
|
|
|
After all endpoints are mapped (before `app.RunAsync()`), add:
|
|
|
|
```csharp
|
|
app.TryRefreshStellaRouterEndpoints(resolvedOptions.Router);
|
|
```
|
|
|
|
## Configuration Example (YAML)
|
|
|
|
```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
|