ASP.NET Core-server

Door je Document360-kennisbank te hosten in een submap op ASP.NET Core, zoals example.document360.io/help, kun je je documentatie direct binnen je bestaande domein serveren via een reverse proxy.

Vervang het voorbeelddomein in de onderstaande configuratie door je eigen door Document360 geleverde domein of aangepaste domein.

Voordat je begint

• Subfolderhosting werkt alleen wanneer zowel het Subfolderpad (bijvoorbeeld /docs) als het Site API-pad (bijvoorbeeld /api) zijn gedefinieerd in Document360, met bijpassende proxyconfiguratie op je server.
• Installeer het ASP.NET Core proxypakket.

Hoe configureer je een submappad in ASP.NET Core

Configureer in je Startup.cs bestand de Configure methode om zowel UI- als API-verzoeken te routeren, inclusief proxy-mappings voor het Subfolderpad (bijvoorbeeld /docs) en het Site API-pad (bijvoorbeeld /api of /docs-api):

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    // Proxy for /docs (Subfolder path)
    app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/docs"),
        builder => builder.RunProxy(new ProxyOptions()
        {
            Scheme = "https",
            Host = "example.document360.io"
        }));

    // Proxy for /api (Site API path)
    app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/api"),
        builder => builder.RunProxy(new ProxyOptions()
        {
            Scheme = "https",
            Host = "example.document360.io"
        }));
}

Wat gebeurt er daarna

Zodra je server is geconfigureerd, staat je kennisbanksite live in je aangepaste submap. De bestaande Document360-URL blijft ook verzoeken bedienen — bijvoorbeeld, zowel example.document360.io en example.com/docs verwijzen naar je kennisbanksite. Dit veroorzaakt dubbele inhoud in zoekmachines zoals Google en Bing.

Best practices

• Houd het Subfolderpad en het Site API-pad identiek tussen het Document360-portaal en je ASP.NET Core-configuratie om gebroken routering te voorkomen.
• Test de proxyconfiguratie in een niet-productieomgeving voordat je het toepast op je live domein.