ASP.NET Serveur central

Héberger votre base de connaissances Document360 dans un sous-dossier sur ASP.NET Core, comme example.document360.io/help, vous permet de servir votre documentation directement dans votre domaine existant via un reverse proxy.

Remplacez le domaine d’exemple dans la configuration ci-dessous par votre propre domaine fourni par Document360 ou un domaine personnalisé.

Avant que tu commences

• L’hébergement de sous-dossiers ne fonctionne que lorsque le chemin des sous-dossiers (par exemple, /docs) et le chemin de l’API du site (par exemple, /api) sont définis dans Document360, avec une configuration proxy correspondante sur votre serveur.
• Installez le proxy ASP.NET Core.

Comment configurer un chemin de sous-dossier dans ASP.NET Core

Dans votre Startup.cs fichier, configurez la Configure méthode pour acheminer à la fois les requêtes UI et API, y compris les correspondances proxy pour le chemin du sous-dossier (par exemple, /docs) et le chemin de l’API Site (par exemple, /api ou /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"
        }));
}

Que se passe-t-il ensuite

Une fois votre serveur configuré, votre site de base de connaissances est en ligne dans votre sous-dossier personnalisé. L’URL existante de Document360 continue également de répondre aux requêtes — par exemple, les deux example.document360.io et example.com/docs pointera vers votre site de base de connaissances. Cela provoque des doublons de contenu dans les moteurs de recherche comme Google et Bing.

Meilleures pratiques

• Gardez le chemin des sous-dossiers et le chemin de l’API du site identiques entre le portail Document360 et votre configuration ASP.NET Core pour éviter les défaillances du routage.
• Testez la configuration du proxy dans un environnement non de production avant de l’appliquer à votre domaine en ligne.