Microsoft - servidor IIS

Hospedar sua base de conhecimento Document360 em uma subpasta no IIS, como example.document360.io/help, permite que você sirva sua documentação diretamente dentro do seu domínio existente usando regras de reescrita de URL.

Substitua o domínio de exemplo na configuração abaixo pelo seu próprio domínio fornecido pelo Document360 ou domínio personalizado.

Antes de começar

• A hospedagem de subpastas funciona apenas quando tanto o caminho da subpasta (por exemplo, /docs) quanto o caminho da API do Site (por exemplo, /api) são definidos no Document360, com configuração correspondente no seu servidor.
• Instale o módulo de Roteamento de Solicitação de Aplicação para o IIS.
• Instale o módulo de Reescrita de URL para IIS.

Como configurar um caminho de subpasta no IIS

1. Instale o módulo de Reescrita de URL para IIS.
2. Instale o módulo de Roteamento de Solicitação de Aplicação e confirme que está ativado.
3. Adicione a seguinte regra de reescrita para web.config rotear conteúdo da sua documentação em /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>

O web.config arquivo está localizado no seu diretório raiz do IIS. Faça backup do arquivo antes de fazer alterações.

O que acontece a seguir

Uma vez configurado o IIS, seu site da base de conhecimento fica disponível na sua subpasta personalizada. A URL existente do Document360 continua a atender solicitações também — por exemplo, tanto example.document360.io e example.com/help (se /help for o caminho da sua pasta) apontarão para o site da sua base de conhecimento. Substitua esses domínios de exemplo pelos seus próprios, por exemplo yourcompany.document360.io e yourcompany.com/help.

Isso causa conteúdo duplicado em mecanismos de busca como Google e Bing.

Melhores práticas

• Faça backup web.config antes de editar, pois uma única regra mal formada pode quebrar o roteamento do IIS.
• Mantenha o caminho da Subpasta e o caminho da API do Site idênticos entre o portal Document360 e as regras de reescrita do IIS para evitar roteamento quebrado.
• Confirme que tanto os módulos de Roteamento de Solicitação de Aplicação quanto de Reescrita de URL estão instalados e ativados antes de solucionar o comportamento inesperado de roteamento.

FAQ