Web App auf einer eigenen Domain

Unser Custom-Domain-Feature ermöglicht es, die Web App auf einer eigenen Domain zu hosten. Dies kann eine Hauptdomain (z.B. bbc.com) oder eine Subdomain (z.B. app.bbc.com) sein. Sie haben die freie Wahl.

Das Einrichten einer eigenen Domain für die tchop™ Web App bietet mehrere wichtige Vorteile:

• Verbesserte Markenidentität: Das Hosting Ihrer App auf einer Domain Ihrer Marke, (z.B. app.ihredomain.com), verstärkt die Präsenz Ihrer Marke und sorgt für ein konsistentes Benutzererlebnis (spez. auch, wenn Nutzende zwischen Ihrer Website und der Web App wechseln).

• Erhöhtes Vertrauen und Glaubwürdigkeit: Eine personalisierte Domain signalisiert Professionalität und fördert ein größeres Vertrauen bei Ihren Nutzern.

• Verbesserte Auffindbarkeit: Benutzerdefinierte Domains (auch Subdomains) können sich positiv auf Ihre Suchmaschinenoptimierung (SEO) auswirken, was es potenziellen Nutzern erleichtert, Ihr Angebot online zu finden.

Als Standard hat unsere Webanwendung keinen Einfluss auf die SEO ("no index"), aber es gibt natürlich Möglichkeiten, wie Sie alle nutzergenerierten Inhalte zu Ihrem Vorteil nutzen können.

Wie man eine benutzerdefinierte Domain einrichtet

Das Einrichten einer benutzerdefinierten Domain erfordert einige Schritte von Ihnen, bevor wir dann unsererseits die Integration auf technisch abschließen. Im folgenden erklären wir Schritt-für-Schritt was zu tun ist:

1. Schritt: Benutzerdefinierte Domain festlegen

Lassen Sie uns wissen, ob Sie Ihre Webanwendung auf einer Hauptdomain (z.B. ihredomain.com) oder einer Subdomain (z.B. app.ihredomain.com) hosten möchten. Dies ist für die folgende ordnungsgemäße Konfiguration erforderlich.

2. Schritt: Fügen Sie einen CNAME-Eintrag zu Ihrem DNS hinzu

Wichtig für die Einrichtung ist der Zugriff auf Ihre DNS-Einstellungen bzw. die Möglichkeit hier Änderungen vorzunehmen. Oft ist dies Administratoren oder DevOps-Experten vorbehalten.

Je nachdem, wo Ihre Webanwendung bei uns gehostet wird (AWS oder Hetzner-Server), müssen Sie einen CNAME-Eintrag zu den DNS-Einstellungen Ihrer Domain hinzufügen:

Für AWS-gehostete Webanwendungen:

• Typ: CNAME

• Name: *.ihredomain.com

• Inhalt: webapp-custom-domain.tchop.io

Für Hetzner-gehostete Webanwendungen:

• Typ: CNAME

• Name:*.ihredomain.com

• Inhalt: webapp-custom-domain.tchop.it

Der "*" ermöglicht Ihnen flexibel weitere Kanäle zu starten ohne diesen Eintrag anpassen zu müssen.Ihre Organisation in tchop kann viele verschiedene Kanäle für unterschiedliche Zielgruppen bieten. Die Kanäle sind auf unserer Plattform in folgender Struktur Ihrer tchop URL vorangestellt: kanal-organisation.tchop.io

Ist es Ihnen nicht möglich "*" in dem DNS Eintrag voranzustellen, muss der Eintrag leicht angepasst werden, ausserdem muss für jeden Kanal ein weiterer Eintrag erstellt werden:

Für AWS-gehostete Webanwendungen:

• Typ: CNAME

• Name: yourorgname.ihredomain.com

• Inhalt: webapp-custom-domain.tchop.io

• Typ: CNAME

• Name: channelname-yourorgname.ihredomain.com

• Inhalt: webapp-custom-domain.tchop.io

Für Hetzner-gehostete Webanwendungen:

Typ: CNAME

• Name: yourorgname.ihredomain.com

• Inhalt: webapp-custom-domain.tchop.it

• Typ: CNAME

• Name: channelname-yourorgname.ihredomain.com

• Inhalt: webapp-custom-domain.tchop.it

Natürlich liefern wir Ihnen die genauen URLs auch noch im direkten Austausch, um sicherzugehen, dass alles passt.

3. Schritt: Stellen Sie ein SSL-Wildcard-Zertifikat zur Verfügung

Um die Vertrauenswürdigkeit der Web App sicherzustellen, muss ein SSL Zertifikat hinterlegt werden.

Sie können ein Wildcard-SSL-Zertifikat bereitstellen, das Ihre Hauptdomain (ihredomain.com) und alle Subdomains (*.ihredomain.com) abdeckt. Dies gewährleistet sicheren Zugriff auf Ihre Webanwendung.

Wir benötigen dazu zwei oder drei Dateien von Ihnen:

• Privater Schlüssel

• Zertifikatdatei

✅ Wir benötigen nur die NGINX-kompatiblen SSL-Dateien für die Implementierung.

Zur Referenz werfen Sie einen Blick auf ein Beispiel für die SSL-Einrichtung: Lilien.app SSL-Beispiel

2. Unser Einrichtungsprozess (auf tchop-Seite)

Sobald Sie die oben genannten Schritte abgeschlossen haben, kümmern wir uns um den Rest:

Verlinkung Ihrer benutzerdefinierten Domain:

• Wir verbinden die bereitgestellte Domain mit Ihrer Organisation in unserem System.

interface OrganisationCustomDomainSchema {

	// {channel}-webapp.tchop.live

	channelHostStructure: string;

	

	// webapp.tchop.live

	organisationHost: string;

	

	// tchop.live

	baseHost: string;

	

	isHttps: boolean;

}

Bereitstellung:

• Sobald konfiguriert, wird Ihre Webanwendung (einschließlich der nutzerseitigen Seite und des Admin-Dashboards) unter Ihrer benutzerdefinierten Domain verfügbar sein.

Wichtige Hinweise

Deep-Link-URLs:

• Benutzerdefinierte Domains unterstützen keine Deeplinks. Deeplinks führen Nutzender direkt in den richtigen Inhalt, an die richtige Stelle Ihrer Community. Diese Links erfordern spezifisches Handling für mobile Apps und müssen daher auf unseren Standarddomänen (tchop.io oder tchop.it) verbleiben.

Zugriffsflexibilität:

• Selbst nach der Einrichtung Ihrer benutzerdefinierten Domain wird Ihre Webanwendung weiterhin sowohl über Ihre benutzerdefinierte URL als auch über unsere Standard-tchop-URL zugänglich sein.

Für Fragen oder Unterstützung stehen Ihnen unser Support-Team gerne zur Verfügung!