Microsoft - Serveur IIS

L’hébergement d’une base de connaissances dans un sous-dossier offre un moyen transparent d’intégrer la documentation dans la structure existante de votre site Web. Par exemple, la configuration d’un chemin d’accès au sous-dossier permet /help aux utilisateurs d’accéder à votre base de connaissances directement dans votre domaine, par example.document360.io/helpexemple .

Pour commencer, assurez-vous de remplacer l’exemple de domaine dans les configurations par votre propre domaine fourni par Document360 ou votre domaine personnalisé.

Pré-requis

• Application Request Routing module pour IIS

• URL Rewrite Module pour IIS

Configuration du chemin d’accès à un sous-dossier

1. Installer le module de réécriture d’URL pour le serveur IIS

2. Installez le module Routage des demandes d’application et assurez-vous qu’il est activé.

3. Ajoutez la règle de réécriture suivante pour web.config réécrire le contenu de votre documentation à l’adresse /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="&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 le répertoire racine de votre IIS. Assurez-vous de sauvegarder le fichier avant d’y apporter des modifications.

NOTE

Si vous êtes sur KB Site 2.0 et que vous souhaitez héberger votre base de connaissances en tant que sous-dossier, vous devez définir le chemin du sous-dossier ainsi que le chemin de l’API du site.

Que se passe-t-il ensuite ?

Une fois que vous avez correctement configuré le serveur Web, le site de votre base de connaissances est en ligne dans votre sous-dossier/sous-répertoire personnalisé.

Toutefois, l’URL existante de votre projet servira les demandes.

Par exemple example.document360.io et example.com/help (si /help est le chemin de votre dossier) pointera vers le Knowledge base site.

N’oubliez pas de remplacer example.document360.io et example.com/help par votre domaine. Par exemple, yourcompany.document360.io et yourcompany.com/help.

Cela entraînera du contenu dupliqué dans les moteurs de recherche (Google, Bing, etc.). Pour cela, vous devrez activer une redirection d’URL. L’activation d’une redirection d’URL empêche les moteurs de recherche tels que Google ou Bing d’indexer le contenu dupliqué, ce qui peut avoir un impact négatif sur le classement de votre site dans les résultats de recherche.

NOTE

Pour activer la redirection depuis votre example.document360.io sous-dossier example.com/helppersonnalisé, veuillez nous contacter à l’adresse support@document360.com.