Microsoft - IIS-server

Door je Document360-kennisbank te hosten in een submap op IIS, zoals example.document360.io/help, kun je je documentatie direct binnen je bestaande domein serveren met behulp van URL-herschrijfregels.

Vervang het voorbeelddomein in de onderstaande configuratie door je eigen door Document360 geleverde domein of aangepaste domein.

Voordat je begint

• Subfolderhosting werkt alleen wanneer zowel het Submappad (bijvoorbeeld /docs) als het Site API-pad (bijvoorbeeld /api) in Document360 zijn gedefinieerd, met een bijpassende configuratie op je server.
• Installeer de Application Request Routing-module voor IIS.
• Installeer de URL Rewrite-module voor IIS.

Hoe configureer je een submappad in IIS

1. Installeer de URL Rewrite module voor IIS.
2. Installeer de Application Request Routing-module en bevestig dat deze is ingeschakeld.
3. Voeg de volgende herschrijfregel web.config toe om inhoud uit je documentatie te routeren 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>
                <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>

Het web.config bestand bevindt zich in je IIS-rootmap. Maak een back-up van het bestand voordat je wijzigingen aanbrengt.

Wat gebeurt er daarna

Zodra IIS is geconfigureerd, staat je kennisbanksite live in je aangepaste submap. De bestaande Document360-URL blijft ook verzoeken leveren — bijvoorbeeld, zowel example.document360.io en example.com/help (als /help het je mappad is) zullen naar je kennisbanksite verwijzen. Vervang deze voorbeelddomeinen door je eigen, bijvoorbeeld yourcompany.document360.io en yourcompany.com/help.

Dit veroorzaakt dubbele inhoud in zoekmachines zoals Google en Bing.

Best practices

• Maak web.config een back-up voordat je het bewerkt, want één enkele verkeerd gevormde regel kan de IIS-routering breken.
• Houd het Subfolderpad en het Site API-pad identiek tussen het Document360-portaal en je IIS-herschrijfregels om gebroken routering te voorkomen.
• Controleer of zowel de Application Request Routing- als de URL Rewrite-modules zijn geïnstalleerd en ingeschakeld voordat je onverwacht routeringsgedrag opzoekt.

FAQ