Salta ai contenuti
FortressFlag Docs

Crea il tuo primo flag

Nei prossimi minuti creerai un account FortressFlag, cambierai un flag vero e vedrai la modifica arrivare nella stessa risposta dell’API che leggeranno le tue app. Nessuna installazione di SDK ancora — solo un terminale alla fine.

1. Registrati

Sezione intitolata “1. Registrati”

Vai alla pagina di registrazione della dashboard e crea la tua organizzazione. Sceglierai un nome, imposterai email e password, e accetterai i contratti di servizio — una sola casella, che copre il pacchetto di documenti linkato lì accanto.

Questo è tutto il modulo. La tua prova parte subito, include 1.000 dispositivi attivi mensili e non scade mai per tempo — valuta con i tuoi ritmi.

2. Conosci il mondo demo

Sezione intitolata “2. Conosci il mondo demo”

Atterri già connesso come Owner dell’organizzazione, e c’è già qualcosa da guardare: un progetto Example con due ambienti — dev e production — e tre flag booleani in stati credibili:

  • new-checkout — spento ovunque, in attesa del suo rollout
  • dark-mode — acceso in dev, spento in production
  • beta-banner — acceso in entrambi

Questa è la tua sandbox. Tutto quello che fai nel resto di questa pagina avviene nell’ambiente dev, dove puoi cambiare qualsiasi cosa liberamente.

3. Attiva un flag

Sezione intitolata “3. Attiva un flag”

Apri il progetto Example, trova new-checkout e accendilo in dev. È una modifica vera: è attiva per ogni dispositivo che legge questo ambiente, è nel tuo log di audit, e tra un momento la vedrai dall’API.

(Prova la stessa cosa in production e noterai che la dashboard lo tratta diversamente — gli ambienti di classe produzione hanno uno stile più vistoso e regole più severe. Sono ruoli e sicurezza all’opera.)

4. Genera una chiave SDK

Sezione intitolata “4. Genera una chiave SDK”

Per leggere i flag come fa un’app, ti serve una chiave client. Nel progetto Example, apri Chiavi SDK e generane una per l’ambiente dev.

La chiave completa — inizia con ffc_dev_ — viene mostrata una volta sola, adesso. Copiala. Dopo questa schermata, l’elenco mostra solo quanto basta per identificarla. (L’hai persa? Generane un’altra e revoca la prima — le chiavi costano poco, e la revoca è istantanea.)

5. Leggilo come farebbe un dispositivo

Sezione intitolata “5. Leggilo come farebbe un dispositivo”

Chiedi all’API client i flag di questo dispositivo — la stessa richiesta che fa ogni SDK. Metti la chiave che hai appena copiato in una variabile, poi:

Terminal window
export FF_SDK_KEY="(la chiave ffc_dev_ che hai appena generato)"


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

(La risposta racchiude i suoi dati in un payload codificato — gli ultimi tre passaggi della pipe lo aprono. L’header X-FF-Device trasporta un’identità del dispositivo; gli SDK generano la propria, e per un esperimento da terminale ne va bene una qualsiasi ben formata.)

Riceverai esattamente ciò che riceve un dispositivo in dev:

{
  "v": 1,
  "tenant": "…l'id della tua organizzazione…",
  "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
  }
}

Eccolo, new-checkout: true — il tuo interruttore, servito. Rispegnilo nella dashboard, rilancia il curl e guardalo seguire. Fatto — hai eseguito la tua prima modifica a un flag e l’hai letta dal data plane.

Prossimi passi

Sezione intitolata “Prossimi passi”