Microsoft - IIS-Server

Das Hosten Ihrer Document360-Wissensdatenbank in einem Unterordner auf IIS, wie zum Beispiel example.document360.io/help, ermöglicht es Ihnen, Ihre Dokumentation direkt innerhalb Ihrer bestehenden Domain mithilfe von URL-Umschreibregeln bereitzustellen.

Ersetzen Sie die Beispieldomain in der untenstehenden Konfiguration durch Ihre eigene, von Document360 bereitgestellte Domain oder benutzerdefinierte Domain.

Bevor du anfängst

• Subordner-Hosting funktioniert nur, wenn sowohl der Unterordnerpfad (zum Beispiel /docs) als auch der Site-API-Pfad (zum Beispiel /api) in Document360 mit entsprechender Konfiguration auf Ihrem Server definiert sind.
• Installiere das Application Request Routing-Modul für IIS.
• Installiere das URL-Rewrite-Modul für IIS.

Wie man einen Unterordnerpfad in IIS konfiguriert

1. Installiere das URL-Rewrite-Modul für IIS.
2. Installiere das Application Request Routing-Modul und prüfe, dass es aktiviert ist.
3. Füge folgende Umschreibregel hinzu, um web.config Inhalte aus deiner Dokumentation /helpzu routen:

<?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>

Die web.config Datei befindet sich in deinem IIS-Root-Verzeichnis. Sichere die Datei, bevor du Änderungen vornimmst.

Was passiert als Nächstes

Sobald IIS konfiguriert ist, ist deine Wissensdatenbank-Seite in deinem eigenen Unterordner aktiv. Die bestehende Document360-URL bedient weiterhin Anfragen – zum Beispiel verweisen sowohl example.document360.io und example.com/help (wenn /help dein Ordnerpfad ist) auf deine Wissensdatenbank-Seite. Ersetzen Sie diese Beispieldomänen durch Ihre eigenen, zum Beispiel yourcompany.document360.io und yourcompany.com/help.

Dies führt zu doppelten Inhalten in Suchmaschinen wie Google und Bing.

Best Practices

• Sichern Sie web.config sich vor der Bearbeitung, da eine einzelne fehlerhafte Regel das IIS-Routing brechen kann.
• Halte den Unterordnerpfad und den Site-API-Pfad zwischen dem Document360-Portal und deinen IIS-Umschreibregeln identisch, um fehlerhaftes Routing zu vermeiden.
• Bestätigen Sie, dass sowohl das Application Request Routing- als auch das URL-Rewrite-Modul installiert und aktiviert sind, bevor unerwartetes Routing-Verhalten behoben wird.

FAQ