Zum Hauptinhalt springen
Connic
Verbindungen

Custom Domains

Verbindungs-URLs sind unter einem eigenen Hostnamen erreichbar. Connic verwaltet die TLS-Zertifikate.

Zuletzt aktualisiert

Gib Partnern und Kunden Verbindungs-URLs mit einem eigenen Hostnamen statt connect.connic.co. Der Hostname verwendet ein TLS-Zertifikat, das für die Domain ausgestellt wurde.

Standard

https://connect.connic.co/webhook/3b0a9d…

Alle Projekte teilen sich denselben Host.

Eigene Domain

https://hooks.acme.com/webhook/3b0a9d…

Ein eigener Hostname für dieselbe Verbindung.

ID, Konfiguration und generierte Secrets der Verbindung bleiben gleich. Nur der Host ändert sich.

Ab Pro verfügbar
Custom Domains sind in Pro und Enterprise enthalten. Nach dem Wechsel auf einen Plan ohne Custom Domains geben Anfragen an bestehende Custom Domains ab Inkrafttreten des Downgrades einen 404-Fehler zurück. Die standardmäßigen Verbindungs-URLs funktionieren weiterhin.

Domain hinzufügen

Füge Domains unter Projekt-Settings → Domains hinzu. Voraussetzungen:

  • Eine Subdomain unter eigener Kontrolle. Apex-Domains und Wildcards werden nicht unterstützt. Verwende nur ASCII und für IDNs Punycode.
  • DNS-Zugriff auf diese Subdomain. Lege zwei Records an: einen CNAME, der Traffic an Connic weiterleitet, und einen TXT-Record als Eigentumsnachweis, damit ein TLS-Zertifikat ausgestellt werden kann.

Die Domain kann ausgewählt werden, sobald beide DNS-Records aufgelöst werden und das TLS-Zertifikat aktiv ist.

Domain für eine Verbindung verwenden

Das Feld Domain gilt für Verbindungs-URLs von HTTP Webhook, MCP Server, S3, Stripe, Telegram und WebSocket. Wähle im Dialog zum Erstellen oder Bearbeiten eine aktive Domain aus, um diesen Host zu verwenden. ID, Konfiguration und generierte Secrets der Verbindung bleiben unverändert.

  • Die Standard-URL bleibt aktiv. Das Zuweisen einer Domain schaltet connect.connic.co nicht ab. Beide führen zur selben Verbindung, sodass Partner nacheinander umgestellt werden können.
  • Domains gelten pro Projekt. Eine Domain kann Verbindungen in allen Environments des Projekts bedienen.

Domain entfernen

Beim Löschen einer Domain wird der Hostname freigegeben. Alle Verbindungen, die ihn verwendet haben, werden automatisch auf den Standard-Host zurückgesetzt. Aktualisiere zuerst alle Drittanbieter, die den alten Hostnamen aufrufen. Nach dem Entfernen der Domain erhalten diese Anfragen 404-Fehler.

Zugriffskontrolle

Projekt-Berechtigungen steuern, wer Domains ansehen, hinzufügen oder entfernen und Verbindungen aktualisieren darf. Domainverwaltung und Verbindungsaktualisierungen werden im Audit Log erfasst.

Fehlerbehebung

Prüfe, ob der Record exakt unter dem im Dashboard angegebenen Namen existiert. dig TXT _acme-challenge.your.host sollte den von Connic bereitgestellten Wert zurückgeben. Einige DNS-Anbieter entfernen das abschließende Label; füge den Namen genau wie angezeigt ein.

Der CNAME muss auf connect.connic.co zeigen. Ein abgeflachter ALIAS oder ANAME kann funktionieren; ein A-Record auf eine IP-Adresse funktioniert nicht.

Meist waren die Records kurzzeitig vorhanden und wurden danach geändert oder entfernt. Die Zeile zeigt die Ursache des Fehlers. Lösche die Domain und füge den Hostnamen erneut hinzu, um den Ablauf neu zu starten.

Der Hostname wird korrekt geroutet, der Pfad benötigt jedoch die ID der Verbindung. Kopiere die vollständige URL aus der Detailansicht der Verbindung, statt die URL manuell zusammenzusetzen.

Die Domain bleibt Pending, bis die DNS-Records aufgelöst werden und das TLS-Zertifikat aktiv ist. Prüfe die Records über einen externen DNS-Resolver, bevor die Fehlerbehebung fortgesetzt wird.