Microsoft - serveur IIS

Héberger votre base de connaissances Document360 dans un sous-dossier sur IIS, comme example.document360.io/help, vous permet de servir votre documentation directement dans votre domaine existant en utilisant des règles de réécriture d’URL.

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 correspondante sur votre serveur.
• Installez le module de routage de requête d’application pour IIS.
• Installez le module de réécriture d’URL pour IIS.

Comment configurer un chemin de sous-dossier dans IIS

1. Installez le module URL Rewrite pour IIS.
2. Installez le module de routage des demandes d’application et confirmez qu’il est activé.
3. Ajoutez la règle de réécriture suivante pour web.config router le contenu de votre documentation à /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>

Le web.config fichier se trouve dans votre répertoire racine IIS. Sauvegardez le fichier avant d’apporter des modifications.

Que se passe-t-il ensuite

Une fois l’IIS 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/help (si /help c’est le chemin de votre dossier) pointeront vers le site de votre base de connaissances. Remplacez ces domaines d’exemple par les vôtres, par exemple yourcompany.document360.io et yourcompany.com/help.

Cela provoque des doublons de contenu dans les moteurs de recherche comme Google et Bing.

Meilleures pratiques

• Sauvegardez web.config avant de l’éditer, car une seule règle mal formée peut casser le routage IIS.
• Gardez le chemin des sous-dossiers et l’API du site identiques entre le portail Document360 et vos règles de réécriture IIS pour éviter les routages défaillants.
• Confirmez que les modules de Routage de Requête d’Application et de Réécriture d’URL sont installés et activés avant de résoudre des comportements de routage inattendus.

FAQ