Microsoft - IIS-server

Het hosten van een kennisbank in een submap biedt een naadloze manier om documentatie te integreren in uw bestaande websitestructuur. Als u bijvoorbeeld een pad voor een submap instelt, hebben /help gebruikers rechtstreeks toegang tot uw kennisbank binnen uw domein, zoals example.document360.io/help.

Zorg er om te beginnen voor dat u het voorbeelddomein in de configuraties vervangt door uw eigen door Document360 geleverde domein of uw aangepaste domein.

Vereisten

• Application Request Routing module voor IIS

• URL Rewrite Module voor IIS

Een pad naar een submap instellen

1. Installeer de URL-herschrijfmodule voor IIS-server

2. Installeer de module Application Request Routing en zorg ervoor dat deze is ingeschakeld.

3. Voeg de volgende herschrijfregel toe web.config om de inhoud van uw documentatie te herschrijven op /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>

Het web.config bestand bevindt zich in de IIS-hoofdmap. Zorg ervoor dat u een back-up van het bestand maakt voordat u wijzigingen aanbrengt.

NOTITIE

Als u zich op KB Site 2.0 bevindt en uw kennisbank als een submap wilt hosten, moet u zowel het pad naar de submap als het pad naar de site-API definiëren.

Wat gebeurt er daarna?

Zodra u de webserver met succes hebt geconfigureerd, is uw kennisbanksite live op uw aangepaste submap/submap.

De bestaande URL voor uw project zal echter de verzoeken verwerken.

Bijvoorbeeld example.document360.io en example.com/help (als /help dit uw mappad is) verwijst naar de Knowledge base site.

Vergeet niet om en example.com/help te vervangen example.document360.io met uw domein. Bijvoorbeeld, yourcompany.document360.io en yourcompany.com/help.

Dit zal dubbele inhoud veroorzaken in zoekmachines (Google, Bing en meer.). Hiervoor moet u een URL-omleiding inschakelen. Als u een URL-omleiding inschakelt, voorkomt u dat zoekmachines zoals Google of Bing dubbele inhoud indexeren, wat een negatieve invloed kan hebben op de zoekresultaten van uw site.

NOTITIE

Om de omleiding van example.document360.io naar uw aangepaste submap example.com/helpin te schakelen, neemt u contact met ons op via support@document360.com.