Projekt und Domains

Projektname, gebrandete Subdomains und die destruktive Löschzone.

Projekteinstellungen

Tab „Einstellungen“: links „Start“, „Subdomains“, „Eigene Domains“, „API-Schlüssel“ und Teamzugriff.

1. Öffnen Sie „Einstellungen“.
2. Unter „Home“ Projektname und Beschreibung ändern.
3. Speichern Sie Änderungen in der Kopfzeilen-/Formular-UI.

Projekteinstellungen: Name, Beschreibung, Löschen.

Subdomains

Eine Subdomain ergibt eine Adresse wie https://name.<service-domain>/…. Subdomains gehören zum Konto und können projektübergreifend genutzt werden.

1. „Einstellungen“ → „Subdomains“ → „+ Subdomain“.
2. Namen festlegen → „Erstellen“.
3. Wählen Sie diese Subdomain im Link-Builder.

• Badges: „hier“ — von Links im aktuellen Projekt genutzt; „anderswo“ — in anderen Projekten; „gelöscht · wiederherstellbar“ — Soft-Delete.
• Nach dem Löschen einer Subdomain funktionieren Links darauf nicht mehr; die Karte zeigt „Subdomain gelöscht“.
• „Wiederherstellen“ bringt die Subdomain zurück; Links funktionieren wieder, außer manuell deaktivierte.

Subdomain-Liste und Erstellen.

WARNUNG: „Subdomain löschen“ unterbricht öffentliche URLs unter diesem Namen sofort, bis Sie sie wiederherstellen. Prüfen Sie zuerst, welche Links davon abhängen.

Eigene Domains

Eigene FQDN (zum Beispiel go.company.eu) statt einer Subdomain der Service-Zone. Nach TXT-Eigentumsnachweis und Wildcard-CNAME öffnen Links auf Ihrer Domain.

1. „Einstellungen“ → „Eigene Domains“ → „+ Domain“ → FQDN ohne https:// eingeben.
2. Fügen Sie in DNS den Eigentums-TXT-Eintrag hinzu (Schritt 1 der Anleitung).
3. CNAME für das Muster `*.your-zone` hinzufügen → Redirect-Edge des Dienstes (Schritt 2).
4. „DNS prüfen“ klicken. Wenn der Status „Aktiv“ ist, die Domain im Link-Builder wählen.

Abschnitt „Eigene Domains“: Liste, Status, „+ Domain“.

Schritt 1 — Eigentum (TXT). Ein TXT-Eintrag ist erforderlich. Host ist üblicherweise `_urlshortener.{your-domain}` (manche Registrar wollen nur `_urlshortener` im Namen, ohne die Zone). Wert: `urlshortener-verify=<token>` aus der Anleitung. TTL: 300–3600.

DNS-Bereich: TXT `_urlshortener…` mit dem Token aus der Anleitung hinzufügen.

Schritt 2 — Routing (CNAME). Ein CNAME auf dem Apex (`@`) ist bei den meisten Registraren nicht erlaubt. Muster verwenden: Host `*.company.eu` → Wert `edge.kkoroch.ru` (exakter Host steht in der Anleitung). Das Muster deckt go.company.eu und andere Zonen-Subdomains ab. Wenn Sie den Apex (company.eu) registrieren, brauchen Sie ggf. auch A/ALIAS auf `@` — siehe den Hinweis in der App.

DNS-Panel: Wildcard-CNAME `*.zone` zum Redirect-Edge.

• Service-Subdomain und eigene Domain schließen sich für einen Link gegenseitig aus.
• Status: „Warte auf TXT“ → „CNAME erforderlich“ → „Aktiv“. Nur Aktiv kann im Builder ausgewählt werden.
• Das Löschen einer Domain deaktiviert Links darauf (Status „Domain gelöscht“).
• Das Limit eigener Domains wird vom Tarif gesetzt (auf Free+ oft 0).
• Zwischen DNS-Prüfungen — ca. 15 s Pause.

Domain im Status „Aktiv“ nach erfolgreicher DNS-Prüfung.

WARNUNG: DNS-Einträge werden oft verzögert wirksam (Minuten, manchmal Stunden wegen TTL und Resolver-Cache). Wenn nach „DNS prüfen“ der Status noch nicht „Aktiv“ ist — warten und erneut versuchen; erneutes Speichern der Einträge ist meist unnötig.

WARNUNG: Sie können das Muster `*.company.eu` nicht als eigene Domain selbst registrieren — nur eine konkrete FQDN. Der Routing-Eintrag ist ein separates Wildcard-CNAME bei Ihrem Registrar.

Nach der Aktivierung die Domain unter „Eigene Domains“ im Link-Builder wählen. Die öffentliche URL sieht aus wie https://go.company.eu/promo.

API-Schlüssel

„API-Schlüssel“ ermöglicht scoped Schlüssel für Integrationen (CRM, Skripte, CI), Berechtigungen zu begrenzen und Zugriff zu widerrufen.

1. „Einstellungen“ → „API-Schlüssel“ → „Schlüssel erstellen“.
2. Integrationsname und Berechtigungen festlegen: „Vollzugriff“ oder bestimmte Scopes wählen.
3. Speichern Sie den geheimen Schlüssel sofort nach der Erstellung — er wird nicht erneut angezeigt.
4. Zum Ändern von Name oder Berechtigungen „Bearbeiten“; zum Deaktivieren — „Schlüssel widerrufen“.

• Der Schlüssel ist an das aktuelle Projekt (Scope) gebunden und funktioniert außerhalb davon nicht.
• Rotieren durch Widerrufen des alten Schlüssels und Erstellen eines neuen: das Geheimnis kann nicht per Bearbeitung geändert werden.
• Wenn das Projekt-Schlüssel-Limit erreicht ist, zeigt die Oberfläche die Tarifbeschränkung.

Berechtigungen beim Erstellen eines API-Schlüssels wählen.

WARNUNG: Der geheime Schlüssel wird einmal angezeigt. Legen Sie ihn nicht in clientseitiges JavaScript oder öffentliche Repos; speichern Sie ihn in Umgebungsvariablen oder einem Secrets-Manager.

Projekt löschen

Unten in den Einstellungen — „Projekt löschen“ mit einer ausführlichen Bestätigung.

1. „Einstellungen“ → Löschzone → „Projekt löschen“.
2. Warten Sie auf den Bestätigungstimer (ca. 10 s) → „Endgültig löschen“.

WARNUNG: Das Löschen eines Projekts zerstört dauerhaft dessen Ordner und Links. Konto-Subdomains bleiben erhalten. Nicht mit dem Löschen eines einzelnen Links oder Ordners verwechseln.

• Links und Ordner
• Arbeitsbereich
• Teamzusammenarbeit
• Export und Import

Alle Dokumentationsabschnitte · KKOROCHE