ASP.NET Servidor central

Alojar tu base de conocimiento de Document360 en una subcarpeta de ASP.NET Core, como example.document360.io/help, te permite servir tu documentación directamente dentro de tu dominio existente usando un proxy inverso.

Sustituye el dominio de ejemplo en la configuración de abajo por tu propio dominio proporcionado por Document360 o dominio personalizado.

Antes de que empieces

• El alojamiento de subcarpetas solo funciona cuando tanto la ruta de subcarpeta (por ejemplo, /docs) como la ruta de la API del sitio (por ejemplo, /api) están definidas en Document360, con la configuración de proxy correspondiente en tu servidor.
• Instala el paquete proxy ASP.NET Core.

Cómo configurar una ruta de subcarpeta en ASP.NET Core

En tu Startup.cs archivo, configura el Configure método para enrutar tanto las solicitudes de la interfaz como las de la API, incluyendo mapeos de proxy para la ruta de la subcarpeta (por ejemplo, /docs) y la ruta de la API del sitio (por ejemplo, /api o /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"
        }));
}

¿Qué pasa después?

Una vez configurado tu servidor, tu base de conocimiento estará activo en tu subcarpeta personalizada. La URL existente de Document360 sigue atendiendo solicitudes también — por ejemplo, ambas example.document360.io y example.com/docs apuntará a tu sitio de base de conocimiento. Esto provoca contenido duplicado en motores de búsqueda como Google y Bing.

Mejores prácticas

• Mantén la ruta de subcarpetas y la ruta de la API del sitio idénticas entre el portal Document360 y tu configuración ASP.NET Core para evitar enrutamientos rotos.
• Prueba la configuración del proxy en un entorno no productivo antes de aplicarla a tu dominio en vivo.