Hospedar sua base de conhecimento Document360 em uma subpasta no ASP.NET Core, como example.document360.io/help, permite que você sirva sua documentação diretamente dentro do seu domínio existente usando um reverse proxy.
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 de proxy correspondente no seu servidor. - Instale o pacote proxy ASP.NET Core.
Como configurar um caminho de subpasta no ASP.NET Core
No seu Startup.cs arquivo, configure o Configure método para rotear tanto requisições UI quanto API, incluindo mapeamentos de proxy para o caminho da Subpasta (por exemplo, /docs) e o caminho da API do Site (por exemplo, /api ou /docs-api):
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
// Proxy for /docs (Subfolder path)
app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/docs"),
builder => builder.RunProxy(new ProxyOptions()
{
Scheme = "https",
Host = "example.document360.io"
}));
// Proxy for /api (Site API path)
app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/api"),
builder => builder.RunProxy(new ProxyOptions()
{
Scheme = "https",
Host = "example.document360.io"
}));
}
Substitua /docs e /api pelos valores exatos configurados em caminho de Subpasta e caminho da API do Site no portal Document360.
O que acontece a seguir
Depois que seu servidor está configurado, seu site da base de conhecimento fica ativo na sua subpasta personalizada. A URL existente do Document360 continua atendo a solicitações também — por exemplo, tanto example.document360.io example.com/docs quanto apontam para o seu site de base de conhecimento. Isso causa conteúdo duplicado em mecanismos de busca como Google e Bing.
Para habilitar um redirecionamento do seu subdomínio Document360 para sua subpasta personalizada, entre em contato com o suporte do Document360.
Melhores práticas
- Mantenha o caminho da Subpasta e o caminho da API do Site idênticos entre o portal do Document360 e a configuração do seu ASP.NET Core para evitar roteamento quebrado.
- Teste a configuração do proxy em um ambiente não de produção antes de aplicá-la ao seu domínio ativo.