Zum Inhalt springen

Erstelle dein erstes Flag

In den nächsten paar Minuten legst du ein FortressFlag-Konto an, schaltest ein echtes Flag um und siehst die Änderung in derselben API-Antwort landen, die deine Apps lesen werden. Noch keine SDK-Installation nötig — nur ein Terminal am Ende.

Geh zur Registrierungsseite des Dashboards und leg deine Organisation an. Du wählst einen Namen, setzt E-Mail-Adresse und Passwort und akzeptierst die Dienstvereinbarungen — ein Häkchen, das das Bündel der direkt daneben verlinkten Dokumente abdeckt.

Das ist das ganze Formular. Deine Testphase beginnt sofort, enthält 1.000 monatlich aktive Geräte und läuft nie zeitlich ab — evaluiere in deinem eigenen Tempo.

Du landest angemeldet als Owner der Organisation, und es gibt schon etwas zu sehen: ein Example-Projekt mit zwei Umgebungen — dev und production — und drei Boolean-Flags in glaubwürdigen Zuständen:

  • new-checkout — überall aus, wartet auf seinen Rollout
  • dark-mode — an in dev, aus in production
  • beta-banner — an in beiden

Das ist dein Sandkasten. Alles, was du im Rest dieser Seite tust, passiert in der dev-Umgebung, wo du frei alles ändern kannst.

Öffne das Example-Projekt, such new-checkout und schalte es in dev an. Das ist eine echte Änderung: Sie ist live für jedes Gerät, das diese Umgebung liest, sie steht in deinem Audit-Log, und du siehst sie gleich von der API aus.

(Probier dasselbe in production, und du wirst merken, dass das Dashboard es anders behandelt — Umgebungen mit Produktionsklasse bekommen eine auffälligere Darstellung und strengere Regeln. Das ist Rollen und Sicherheit bei der Arbeit.)

Um Flags so zu lesen, wie eine App es tut, brauchst du einen Client-Schlüssel. Öffne im Example-Projekt SDK-Schlüssel und erstelle einen für die dev-Umgebung.

Der vollständige Schlüssel — er beginnt mit ffc_dev_ — wird einmal angezeigt, jetzt gerade. Kopier ihn. Nach diesem Bildschirm zeigt die Liste nur genug, um ihn zu erkennen. (Verloren? Erstell einen weiteren und widerrufe den ersten — Schlüssel sind billig, und Widerrufen ist sofort wirksam.)

Frag die Client-API nach den Flags dieses Geräts — dieselbe Anfrage, die jedes SDK stellt. Leg den Schlüssel, den du gerade kopiert hast, in eine Variable, und dann:

Terminal window
export FF_SDK_KEY="(der ffc_dev_-Schlüssel, den du gerade erstellt hast)"
curl -s "https://edge.fortressflag.com/v1/client/flags?environment=dev" \
-H "Authorization: Bearer $FF_SDK_KEY" \
-H "X-FF-Device: dev_8KqW3nR2vT7yLp0aZxQmBg" \
| jq -r .payload | tr '_-' '/+' | base64 -d | jq

(Die Antwort verpackt ihre Daten in eine kodierte payload — die letzten drei Pipe-Stufen packen sie aus. Der Header X-FF-Device trägt eine Geräteidentität; SDKs erzeugen ihre eigene, und für ein Terminal-Experiment funktioniert jede wohlgeformte.)

Du bekommst genau das zurück, was ein Gerät in dev bekommt:

{
"v": 1,
"tenant": "…die ID deiner Organisation…",
"environment": "dev",
"device": "dev_8KqW3nR2vT7yLp0aZxQmBg",
"issuedAt": "2026-08-23T15:00:00Z",
"expiresAt": "2026-08-23T15:30:00Z",
"flags": {
"new-checkout": true,
"dark-mode": true,
"beta-banner": true
}
}

Da steht new-checkout: true — deine Umschaltung, ausgeliefert. Schalte es im Dashboard wieder aus, führ den curl erneut aus und sieh zu, wie es folgt. Das war’s — du hast deine erste Flag-Änderung gemacht und sie von der Datenebene gelesen.