Microsoft - Servidor IIS

Alojar tu base de conocimiento de Document360 en una subcarpeta de IIS, como example.document360.io/help, te permite servir tu documentación directamente dentro de tu dominio existente usando reglas de reescritura de URL.

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 correspondiente en tu servidor.
• Instala el módulo de Enrutamiento de Solicitudes de Aplicaciones para IIS.
• Instala el módulo de reescritura de URL para IIS.

Cómo configurar la ruta de una subcarpeta en IIS

1. Instala el módulo de reescritura de URL para IIS.
2. Instala el módulo de Enrutamiento de Solicitudes de Aplicaciones y confirma que está habilitado.
3. Añade la siguiente regla de reescritura para web.config enrutar contenido de tu 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>
                <rule name="ReverseProxy_API" enabled="true" stopProcessing="true">
                    <match url="^api/(.*)" />
                    <action type="Rewrite" url="https://example.document360.io/api/{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="&quot;/help&quot;" />
                    <action type="Rewrite" value="&quot;/help&quot;" />
                </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 está ubicado en tu directorio raíz del IIS. Haz una copia de seguridad del archivo antes de hacer cambios.

¿Qué pasa después?

Una vez configurado IIS, tu sitio de base de conocimientos estará activo en tu subcarpeta personalizada. La URL existente de Document360 sigue atendiendo solicitudes también — por ejemplo, tanto example.document360.io y example.com/help (si /help es la ruta de tu carpeta) apuntarán a tu sitio de base de conocimiento. Sustituye estos dominios de ejemplo por los tuyos propios, por ejemplo yourcompany.document360.io y yourcompany.com/help.

Esto provoca contenido duplicado en motores de búsqueda como Google y Bing.

Mejores prácticas

• Haz una copia de seguridad web.config antes de editarlo, ya que una sola regla mal formada puede romper el enrutamiento IIS.
• Mantén la ruta de subcarpetas y la ruta de la API del sitio idénticas entre el portal Document360 y las reglas de reescritura de tu IIS para evitar enrutamientos rotos.
• Confirma que tanto los módulos de Enrutamiento de Solicitud de Aplicación como de Reescritura de URL están instalados y habilitados antes de solucionar el comportamiento de enrutamiento inesperado.

Preguntas frecuentes