Startup.cs

using System.Collections.Generic;
using System.IO;

using Microsoft.AspNetCore.Authentication;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.PlatformAbstractions;
using Microsoft.OpenApi.Models;

using OneTooXRestArchiveTest.Security;
using OneTooXRestArchiveTest.User;

namespace OneTooXRestArchiveTest
{
    using System.Diagnostics;

    using Microsoft.Extensions.FileProviders;

    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
        {
            services.Configure<ArchiveControllerSettings>(Configuration);
            services.AddDirectoryBrowser();
            services.AddControllers().AddXmlSerializerFormatters();
            services.AddScoped<IUserService, UserService>();
            services.AddAuthentication("BasicAuthentication")
                .AddScheme<AuthenticationSchemeOptions, BasicAuthenticationHandler>("BasicAuthentication", null);

            services.AddApiVersioning(o =>
            {
                o.ReportApiVersions = true;
                o.AssumeDefaultVersionWhenUnspecified = true;
                o.DefaultApiVersion = new ApiVersion(1, 0);
            });
            services.AddSwaggerGen(c =>
            {
                c.SwaggerDoc("v1.0", new OpenApiInfo { Title = "OneTooX Archive API", Version = "v1.0" });
                foreach (var xml in XmlCommentsFilePaths) c.IncludeXmlComments(xml);

                c.AddSecurityDefinition("basic", new OpenApiSecurityScheme
                {
                    Name = "Authorization",
                    Type = SecuritySchemeType.Http,
                    Scheme = "basic",
                    In = ParameterLocation.Header,
                    Description = "Basic Authentication."
                });

                c.AddSecurityRequirement(new OpenApiSecurityRequirement
                {
                    {
                        new OpenApiSecurityScheme
                        {
                            Reference = new OpenApiReference
                            {
                                Type = ReferenceType.SecurityScheme,
                                Id = "basic"
                            }
                        },
                        new string[] {}
                    }
                });
            });
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            var archiveFolder = Configuration.GetValue<string>("ArchiveFolder");
            if (!Path.IsPathRooted(archiveFolder)) archiveFolder = Path.Combine(env.WebRootPath ?? Directory.GetCurrentDirectory(), archiveFolder);
            Trace.TraceInformation($"Setting /archived/ to '{archiveFolder}'");
            app.UseStaticFiles(
                new StaticFileOptions
                {
                    FileProvider = new PhysicalFileProvider(Path.GetFullPath(archiveFolder)),
                    RequestPath = "/Archived"
                });
            app.UseDirectoryBrowser(
                new DirectoryBrowserOptions
                {
                    FileProvider = new PhysicalFileProvider(Path.GetFullPath(archiveFolder)),
                    RequestPath = "/Archived"
                });
            app.UseRouting();
            app.UseAuthentication();
            app.UseAuthorization();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
            });
            app.UseSwagger();
            app.UseSwaggerUI(c =>
            {
                c.SwaggerEndpoint("/swagger/v1.0/swagger.json", "OneTooX Archive API");
            });
        }

        private static IEnumerable<string> XmlCommentsFilePaths
            => Directory.EnumerateFiles(PlatformServices.Default.Application.ApplicationBasePath, "OneTooX*.xml", SearchOption.AllDirectories);
    }
}