Wenn Sie Ihre Document360-Wissensdatenbank in einem Unterordner auf ASP.NET Core hosten, wie z. example.document360.io/helpB. , können Sie Ihre Dokumentation direkt innerhalb Ihrer bestehenden Domain über einen Reverse-Proxy bereitstellen.
Ersetzen Sie die Beispieldomain in der untenstehenden Konfiguration durch Ihre eigene, von Document360 bereitgestellte Domain oder benutzerdefinierte Domain.
Bevor du anfängst
- Das Hosting von Unterordnern funktioniert nur, wenn sowohl der Unterordnerpfad (zum Beispiel
/docs) als auch der Site-API-Pfad (zum Beispiel/api) in Document360 mit entsprechender Proxy-Konfiguration auf Ihrem Server definiert sind. - Installiere das ASP.NET Core Proxy-Paket.
Wie man einen Unterordnerpfad in ASP.NET Core konfiguriert
Konfigurieren Sie in Ihrer Startup.cs Datei die Methode Configure so, dass sowohl UI- als auch API-Anfragen weitergeleitet werden, einschließlich Proxy-Mappings für den Unterordnerpfad (zum Beispiel /docs) und den Site-API-Pfad (zum Beispiel /api oder /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"
}));
}
Ersetzen Sie /docs und /api durch die exakten Werte, die unter Unterordnerpfad und Site-API-Pfad im Document360-Portal konfiguriert sind.
Was passiert als Nächstes
Sobald dein Server konfiguriert ist, ist deine Wissensdatenbank in deinem benutzerdefinierten Unterordner online. Die bestehende Document360-URL bedient weiterhin Anfragen – zum Beispiel verweist sowohl als auch example.document360.io example.com/docs auf Ihre Wissensdatenbank-Website. Dies führt zu doppelten Inhalten in Suchmaschinen wie Google und Bing.
Um eine Weiterleitung von Ihrer Document360-Subdomain in Ihren benutzerdefinierten Unterordner zu ermöglichen, wenden Sie sich an den Document360-Support.
Best Practices
- Halte den Unterordnerpfad und den Site-API-Pfad zwischen dem Document360-Portal und deiner ASP.NET Core-Konfiguration identisch, um fehlerhaftes Routing zu vermeiden.
- Teste die Proxy-Konfiguration in einer Nicht-Produktionsumgebung, bevor du sie auf deine Live-Domain anwendest.