Microsoft - Servidor IIS

Alojar una base de conocimientos en una subcarpeta ofrece una forma perfecta de integrar la documentación en la estructura de su sitio web existente. Por ejemplo, la configuración de una ruta de subcarpeta como /help permite a los usuarios acceder a su base de conocimientos directamente dentro de su dominio, como example.document360.io/help.

Para empezar, asegúrese de sustituir el dominio de ejemplo en las configuraciones por su propio dominio proporcionado por Document360 o su dominio personalizado.

Requisitos previos

• Application Request Routing module para IIS

• URL Rewrite Module para IIS

Configuración de una ruta de subcarpeta

1. Instalación del módulo de reescritura de direcciones URL para el servidor IIS

2. Instale el módulo de enrutamiento de solicitudes de aplicaciones y asegúrese de que esté habilitado.

3. Agregue la siguiente regla web.config de reescritura para reescribir el contenido de la documentación en /help.

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="ReverseProxy_HomePage" enabled="true" stopProcessing="true">
                    <match url="^help$" />
                    <action type="Rewrite" url="https://example.document360.io/v1" />
                    <serverVariables>
                        <set name="HTTP_requested_by" value="proxy" />
                        <set name="HTTP_X_ORIGINAL_ACCEPT_ENCODING" value="{HTTP_ACCEPT_ENCODING}" />
                        <set name="HTTP_ACCEPT_ENCODING" value="" />
                    </serverVariables>
                </rule>
        <rule name="ReverseProxy_DocsPage" enabled="true" stopProcessing="true">
                    <match url="^help/(.*)" />
                    <action type="Rewrite" url="https://example.document360.io/help/{R:1}" />
                    <serverVariables>
                        <set name="HTTP_requested_by" value="proxy" />
                        <set name="HTTP_X_ORIGINAL_ACCEPT_ENCODING" value="{HTTP_ACCEPT_ENCODING}" />
                        <set name="HTTP_ACCEPT_ENCODING" value="" />
                    </serverVariables>
                </rule>
            </rules>
            <outboundRules>
                <rule name="RestoreAcceptEncoding" preCondition="NeedsRestoringAcceptEncoding">
                    <match serverVariable="HTTP_ACCEPT_ENCODING" pattern="^(.*)" />
                    <action type="Rewrite" value="{HTTP_X_ORIGINAL_ACCEPT_ENCODING}" />
                </rule>
        <rule name="RewriteLinksToSourceDomain1" preCondition="ResponseIsHtml">
                    <match filterByTags="None" pattern="^https://example.document360.io/(.*)" />
                    <action type="Rewrite" value="https://example.com/{R:1}" />
                </rule>
        <rule name="RewriteLinksToSourceDomain2" preCondition="ResponseIsHtml">
                    <match filterByTags="None" pattern=""/help"" />
                    <action type="Rewrite" value=""/help"" />
                </rule>
        <rule name="RewriteLinksToSourceDomain3" preCondition="ResponseIsHtml" patternSyntax="ECMAScript">
                    <match filterByTags="A" pattern="(.*)/docs/(.*)" />
                    <action type="Rewrite" value="/help/{R:2}" />
                </rule>
                <preConditions>
        <preCondition name="ResponseIsHtml">
                        <add input="{RESPONSE_CONTENT_TYPE}" pattern="^text/html" />
                    </preCondition>
                    <preCondition name="NeedsRestoringAcceptEncoding">
                        <add input="{HTTP_X_ORIGINAL_ACCEPT_ENCODING}" pattern=" .+" />
                    </preCondition>
                </preConditions>
            </outboundRules>
        </rewrite>
    </system.webServer>  
</configuration>

El web.config archivo se encuentra en el directorio raíz de IIS. Asegúrese de hacer una copia de seguridad del archivo antes de realizar cambios.

NOTA

Si se encuentra en KB Site 2.0 y desea alojar su base de conocimientos como una subcarpeta, debe definir la ruta de la subcarpeta, así como la ruta de la API del sitio.

¿Qué pasa después?

Una vez que haya configurado correctamente el servidor web, el sitio de la base de conocimientos estará activo en la subcarpeta/subdirectorio personalizado.

Sin embargo, la URL existente de tu proyecto atenderá las solicitudes.

Por ejemplo example.document360.io y example.com/help (si /help es la ruta de su carpeta) apuntará al Knowledge base site.

Recuerde reemplazar example.document360.io y example.com/help con su dominio. Por ejemplo, yourcompany.document360.io y yourcompany.com/help.

Esto provocará contenido duplicado en los motores de búsqueda (Google, Bing y más). Para ello, deberá habilitar una redirección de URL. Habilitar un redireccionamiento de URL evita que los motores de búsqueda como Google o Bing indexen contenido duplicado, lo que puede afectar negativamente la clasificación de búsqueda de su sitio.

NOTA

Para habilitar el redireccionamiento desde example.document360.io su subcarpeta example.com/helppersonalizada, contáctenos en support@document360.com.

Preguntas frecuentes