< Summary

Information
Class: Program
Assembly: Elsa.Server.Web
File(s): /home/runner/work/elsa-core/elsa-core/src/apps/Elsa.Server.Web/Program.cs
Line coverage
84%
Covered lines: 169
Uncovered lines: 30
Coverable lines: 199
Total lines: 306
Line coverage: 84.9%
Branch coverage
67%
Covered branches: 38
Total branches: 56
Branch coverage: 67.8%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Metrics

MethodBranch coverage Crap Score Cyclomatic complexity Line coverage
<Main>$()67.85%675684.84%
get_ConfigureForTest()100%11100%

File(s)

/home/runner/work/elsa-core/elsa-core/src/apps/Elsa.Server.Web/Program.cs

#LineLine coverage
 1using System.Text.Encodings.Web;
 2using System.Threading.RateLimiting;
 3using Elsa.Caching.Options;
 4using Elsa.Common.RecurringTasks;
 5using Elsa.Expressions.Helpers;
 6using Elsa.Extensions;
 7using Elsa.Features.Services;
 8using Elsa.Http.Options;
 9using Elsa.Identity.Multitenancy;
 10using Elsa.Persistence.EFCore.Extensions;
 11using Elsa.Persistence.EFCore.Modules.Management;
 12using Elsa.Persistence.EFCore.Modules.Runtime;
 13using Elsa.Server.Web.Activities;
 14using Elsa.Server.Web.ActivityHosts;
 15using Elsa.Server.Web.Filters;
 16using Elsa.Tenants;
 17using Elsa.Tenants.AspNetCore;
 18using Elsa.Tenants.Extensions;
 19using Elsa.WorkflowProviders.BlobStorage.ElsaScript.Extensions;
 20using Elsa.Workflows;
 21using Elsa.Workflows.Activities.Flowchart.Extensions;
 22using Elsa.Workflows.Api;
 23using Elsa.Workflows.CommitStates.Strategies;
 24using Elsa.Workflows.IncidentStrategies;
 25using Elsa.Workflows.LogPersistence;
 26using Elsa.Workflows.Options;
 27using Elsa.Workflows.Runtime.Distributed.Extensions;
 28using Elsa.Workflows.Runtime.Options;
 29using Elsa.Workflows.Runtime.Tasks;
 30using JetBrains.Annotations;
 31using Microsoft.AspNetCore.RateLimiting;
 32using Microsoft.Extensions.Diagnostics.HealthChecks;
 33using Microsoft.Extensions.Options;
 34
 35// ReSharper disable RedundantAssignment
 36const bool useReadOnlyMode = false;
 37const bool useSignalR = false; // Disabled until Elsa Studio sends authenticated requests.
 38const bool useStructuredLogs = false; // Enable to inspect backend logs from Elsa Studio.
 39const bool useMultitenancy = true;
 40const bool disableVariableWrappers = false;
 41const string elsaApiRateLimitingPolicy = "elsa-api";
 42const string httpWorkflowRateLimitingPolicy = "elsa-http-workflows";
 43
 344ObjectConverter.StrictMode = true;
 45
 346var builder = WebApplication.CreateBuilder(args);
 347var services = builder.Services;
 348var configuration = builder.Configuration;
 349var identitySection = configuration.GetSection("Identity");
 350var identityTokenSection = identitySection.GetSection("Tokens");
 351var ingressRateLimitingSection = configuration.GetSection("IngressRateLimiting");
 352var useIngressRateLimiting = ingressRateLimitingSection.GetValue("Enabled", false);
 353var registerIngressRateLimitingPolicies = ingressRateLimitingSection.GetValue("RegisterReferencePolicies", useIngressRat
 354var configuredAllowLocalDistributedRuntimeLockProvider = configuration.GetValue<bool?>("DistributedRuntime:AllowLocalLoc
 355var allowLocalDistributedRuntimeLockProvider =
 356    configuredAllowLocalDistributedRuntimeLockProvider ?? builder.Environment.IsDevelopment();
 57
 358services
 359    .AddElsa(elsa =>
 360    {
 361        elsa
 362            .AddActivitiesFrom<Program>()
 363            .AddActivityHost<Penguin>()
 364            .AddWorkflowsFrom<Program>()
 365            .UseIdentity(identity =>
 366            {
 667                identity.TokenOptions += options => identityTokenSection.Bind(options);
 368                identity.UseConfigurationBasedUserProvider(options => identitySection.Bind(options));
 369                identity.UseConfigurationBasedApplicationProvider(options => identitySection.Bind(options));
 370                identity.UseConfigurationBasedRoleProvider(options => identitySection.Bind(options));
 371            })
 372            .UseDefaultAuthentication()
 373            .UseWorkflows(workflows =>
 374            {
 375                workflows.UseCommitStrategies(strategies =>
 376                {
 377                    strategies.AddStandardStrategies();
 378                    strategies.Add("Every 10 seconds", new PeriodicWorkflowStrategy(TimeSpan.FromSeconds(10)));
 679                });
 380            })
 381            .UseFlowchart(flowchart => flowchart.UseTokenBasedExecution())
 382            .UseWorkflowManagement(management =>
 383            {
 684                management.UseEntityFrameworkCore(ef => ef.UseSqlite());
 385                management.SetDefaultLogPersistenceMode(LogPersistenceMode.Inherit);
 386                management.UseCache();
 387                management.UseReadOnlyMode(useReadOnlyMode);
 388            })
 389            .UseWorkflowRuntime(runtime =>
 390            {
 691                runtime.UseEntityFrameworkCore(ef => ef.UseSqlite());
 392                runtime.UseCache();
 393                runtime.UseDistributedRuntime();
 394                // This sample host acknowledges single-host file-system locks in development or explicit single-host op
 395                runtime.DistributedLockingOptions = options => options.AllowLocalLockProviderInDistributedRuntime = allo
 396            })
 397            .UseWorkflowsApi()
 398            .UseFluentStorageProvider()
 399            .UseElsaScriptBlobStorage()
 3100            .UseScheduling()
 3101            .UseCSharp(options =>
 3102            {
 3103                configuration.GetSection("Scripting:CSharp").Bind(options);
 3104                options.DisableWrappers = disableVariableWrappers;
 3105                options.AppendScript("string Greet(string name) => $\"Hello {name}!\";");
 3106                options.AppendScript("string SayHelloWorld() => Greet(\"World\");");
 3107            })
 3108            .UseJavaScript(options =>
 3109            {
 3110                options.AllowClrAccess = true;
 3111                options.ConfigureEngine(engine =>
 3112                {
 19113                    engine.Execute("function greet(name) { return `Hello ${name}!`; }");
 19114                    engine.Execute("function sayHelloWorld() { return greet('World'); }");
 22115                });
 3116            })
 3117            .UsePython(python =>
 3118            {
 3119                python.PythonOptions += options =>
 3120                {
 3121                    // Make sure to configure the path to the python DLL. E.g. /opt/homebrew/Cellar/python@3.11/3.11.6_1
 3122                    // alternatively, you can set the PYTHONNET_PYDLL environment variable.
 3123                    configuration.GetSection("Scripting:Python").Bind(options);
 3124
 3125                    options.AddScript(sb =>
 3126                    {
 3127                        sb.AppendLine("def greet():");
 3128                        sb.AppendLine("    return \"Hello, welcome to Python!\"");
 6129                    });
 6130                };
 3131            })
 6132            .UseLiquid(liquid => liquid.FluidOptions = options => options.Encoder = HtmlEncoder.Default)
 3133            .UseHttp(http =>
 3134            {
 6135                http.ConfigureHttpOptions = options => configuration.GetSection("Http").Bind(options);
 3136                http.UseCache();
 6137            });
 3138
 3139        if(useMultitenancy)
 3140        {
 3141            elsa.UseTenants(tenants =>
 3142            {
 4143                tenants.UseConfigurationBasedTenantsProvider(options => configuration.GetSection("Multitenancy").Bind(op
 4144                tenants.ConfigureMultitenancy(options => options.TenantResolverPipelineBuilder = new TenantResolverPipel
 4145                    .Append<CurrentUserTenantResolver>());
 6146            });
 3147        }
 3148
 3149        if(useStructuredLogs)
 3150            elsa.UseStructuredLogs();
 3151
 3152        ConfigureForTest?.Invoke(elsa);
 6153    });
 154
 155// Obfuscate HTTP request headers.
 3156services.AddActivityStateFilter<HttpRequestAuthenticationHeaderFilter>();
 157
 158// Optionally configure recurring tasks using alternative schedules.
 3159services.Configure<RecurringTaskOptions>(options =>
 3160{
 3161    options.Schedule.ConfigureTask<TriggerBookmarkQueueRecurringTask>(TimeSpan.FromSeconds(300));
 3162    options.Schedule.ConfigureTask<PurgeBookmarkQueueRecurringTask>(TimeSpan.FromSeconds(300));
 3163    options.Schedule.ConfigureTask<RestartInterruptedWorkflowsTask>(TimeSpan.FromSeconds(15));
 6164});
 165
 9166services.Configure<RuntimeOptions>(options => { options.InactivityThreshold = TimeSpan.FromSeconds(15); });
 3167services.Configure<BookmarkQueuePurgeOptions>(options => options.Ttl = TimeSpan.FromSeconds(3600));
 6168services.Configure<CachingOptions>(options => options.CacheDuration = TimeSpan.FromDays(1));
 3169services.Configure<IncidentOptions>(options => options.DefaultIncidentStrategy = typeof(ContinueWithIncidentsStrategy));
 3170if (useIngressRateLimiting)
 171{
 0172    services.PostConfigure<ApiEndpointOptions>(options =>
 0173    {
 0174        if (options.RateLimitingPolicyName == null)
 0175            options.RateLimitingPolicyName = elsaApiRateLimitingPolicy;
 0176    });
 0177    services.PostConfigure<HttpActivityOptions>(options =>
 0178    {
 0179        if (options.RateLimitingPolicyName == null)
 0180            options.RateLimitingPolicyName = httpWorkflowRateLimitingPolicy;
 0181    });
 182}
 183
 3184services.AddRateLimiter(options =>
 3185{
 0186    options.RejectionStatusCode = StatusCodes.Status429TooManyRequests;
 3187
 0188    if (registerIngressRateLimitingPolicies)
 3189    {
 0190        options.AddFixedWindowLimiter(elsaApiRateLimitingPolicy, limiterOptions =>
 0191        {
 0192            limiterOptions.PermitLimit = ingressRateLimitingSection.GetValue("ApiPermitLimit", 120);
 0193            limiterOptions.Window = TimeSpan.FromSeconds(ingressRateLimitingSection.GetValue("ApiWindowSeconds", 60));
 0194            limiterOptions.QueueProcessingOrder = QueueProcessingOrder.OldestFirst;
 0195            limiterOptions.QueueLimit = ingressRateLimitingSection.GetValue("ApiQueueLimit", 0);
 0196        });
 0197        options.AddFixedWindowLimiter(httpWorkflowRateLimitingPolicy, limiterOptions =>
 0198        {
 0199            limiterOptions.PermitLimit = ingressRateLimitingSection.GetValue("HttpWorkflowPermitLimit", 60);
 0200            limiterOptions.Window = TimeSpan.FromSeconds(ingressRateLimitingSection.GetValue("HttpWorkflowWindowSeconds"
 0201            limiterOptions.QueueProcessingOrder = QueueProcessingOrder.OldestFirst;
 0202            limiterOptions.QueueLimit = ingressRateLimitingSection.GetValue("HttpWorkflowQueueLimit", 0);
 0203        });
 3204    }
 3205});
 3206services
 3207    .AddHealthChecks()
 3208    .AddElsaReadinessChecks(includeDistributedLocks: true);
 3209services.AddControllers();
 9210services.AddCors(cors => cors.AddDefaultPolicy(policy => policy.AllowAnyHeader().AllowAnyMethod().AllowAnyOrigin().WithE
 211
 212// Build the web application.
 3213var app = builder.Build();
 214
 215
 216// Configure the pipeline.
 3217if (app.Environment.IsDevelopment())
 3218    app.UseDeveloperExceptionPage();
 219
 220// CORS.
 3221app.UseCors();
 222
 223// Health checks.
 3224app.MapHealthChecks("/health/live", new()
 3225{
 0226    Predicate = _ => false
 3227});
 3228app.MapHealthChecks("/health/ready", new()
 3229{
 0230    Predicate = check => check.Tags.Contains(HealthCheckExtensions.ElsaTag) && check.Tags.Contains(HealthCheckExtensions
 3231    ResultStatusCodes =
 3232    {
 3233        [HealthStatus.Degraded] = StatusCodes.Status503ServiceUnavailable,
 3234        [HealthStatus.Unhealthy] = StatusCodes.Status503ServiceUnavailable
 3235    }
 3236});
 3237app.MapHealthChecks("/", new()
 3238{
 0239    Predicate = _ => false
 3240});
 241
 242// Elsa API endpoints for designer.
 3243var apiEndpointOptions = app.Services.GetRequiredService<IOptions<ApiEndpointOptions>>().Value;
 3244var routePrefix = apiEndpointOptions.RoutePrefix;
 3245app.MapWorkflowsApi(routePrefix);
 246
 247// Routing used for SignalR.
 3248app.UseRouting();
 249
 3250app.UseWorkflowsApiRateLimiting(routePrefix, apiEndpointOptions.RateLimitingPolicyName);
 251
 252// Elsa HTTP Endpoint activities.
 3253var httpActivityOptions = app.Services.GetRequiredService<IOptions<HttpActivityOptions>>().Value;
 3254app.UseWorkflowsRateLimiting(httpActivityOptions.BasePath, httpActivityOptions.RateLimitingPolicyName);
 3255if (useIngressRateLimiting ||
 3256    !string.IsNullOrWhiteSpace(apiEndpointOptions.RateLimitingPolicyName) ||
 3257    !string.IsNullOrWhiteSpace(httpActivityOptions.RateLimitingPolicyName))
 0258    app.UseRateLimiter();
 259
 260// Security.
 3261app.UseAuthentication();
 3262app.UseAuthorization();
 263
 264// Multitenancy.
 265if (useMultitenancy)
 3266    app.UseTenants();
 267
 268// Captures unhandled exceptions and returns a JSON response.
 3269app.UseJsonSerializationErrorHandler();
 270
 3271app.UseWorkflows();
 272
 3273app.MapControllers();
 274
 275// Swagger API documentation.
 3276if (app.Environment.IsDevelopment())
 277{
 3278    app.UseSwaggerUI();
 279}
 280
 281// SignalR.
 282if (useSignalR)
 283{
 284    app.UseWorkflowsSignalRHubs();
 285}
 286
 287// Structured log streaming for Studio diagnostics.
 288if (useStructuredLogs)
 289{
 290    app.UseStructuredLogs();
 291}
 292
 293// Run.
 3294await app.RunAsync();
 295
 296/// <summary>
 297/// The main entry point for the application made public for end to end testing.
 298/// </summary>
 299[UsedImplicitly]
 300public partial class Program
 301{
 302    /// <summary>
 303    /// Set by the test runner to configure the module for testing.
 304    /// </summary>
 7305    public static Action<IModule>? ConfigureForTest { get; set; }
 306}

Methods/Properties

<Main>$()
get_ConfigureForTest()