Autenticazione

Ogni richiesta che la CLI invia porta una chiave API del tuo progetto. Salva le chiavi una volta con status200 login, un contesto per ogni ambiente, oppure passale a un comando in flag o variabili d'ambiente, come fanno gli script. Questa pagina mostra ogni modo, e quale usa un comando quando ce ne sono diversi.

Prima di iniziare#

Ti serve una chiave API del tuo progetto. Creane una in Impostazioni del progetto → Avanzato → Chiavi API con Crea: Chiave API, e dalle l'accesso che servono ai tuoi comandi: vedi Creare una chiave API. Una chiave fa ciò che i suoi permessi consentono: una chiave che può solo leggere i record può elencarli e leggerli, ma non modificarli.

Su Status200 Cloud, le chiavi API funzionano solo finché il progetto ha il piano Growth o superiore. Al di sotto, ogni comando risponde API error (402) con un messaggio che nomina il piano, finché il progetto non passa a un piano superiore; allora la stessa chiave funziona di nuovo. Vedi Chiavi API e SCIM sotto il loro piano.

Accedere#

status200 login salva una chiave API e l'indirizzo del tuo Status200 come contesto, e lo rende il contesto attuale:

status200 login <api-key> <instance-url> [--context-name <name>]

Per esempio, un contesto chiamato production:

status200 login <api-key> https://status200.ru --context-name production

Risponde Logged in successfully. Context "production" is now active. Una barra alla fine dell'indirizzo viene rimossa, e un nuovo accesso con lo stesso nome sostituisce quel contesto.

Contesti#

Un contesto è un accesso salvato: un nome, un indirizzo e una chiave API. Salvane uno per ogni progetto o ambiente, poi scegline uno per tutti i comandi che seguono, o per un singolo comando.

1. Salvare un contesto per ogni ambiente#

   Bash

   status200 login <production-api-key> https://status200.ru --context-name production
   status200 login <staging-api-key> https://status200.example.com --context-name staging

   Ogni accesso rende attuale il proprio contesto, quindi ora l'attuale è staging.

2. Elencarli#

   Bash

   status200 context list

   ┌───┬────────────┬───────────────────────────────┐
   │   │ Name       │ URL                           │
   ├───┼────────────┼───────────────────────────────┤
   │   │ production │ https://status200.ru          │
   ├───┼────────────┼───────────────────────────────┤
   │ * │ staging    │ https://status200.example.com │
   └───┴────────────┴───────────────────────────────┘

   L'* segna il contesto attuale. Le chiavi API non vengono mai elencate.

3. Passare a un altro contesto#

   Bash

   status200 context use production

   Risponde Switched to context "production". e i comandi che seguono lo usano.

4. Usare un contesto per un solo comando#

   Bash

   status200 incident list --context staging

   Il contesto attuale resta com'era.

Quali credenziali usa un comando#

Un comando ha bisogno di una chiave API e di un URL. Prende ciascuno dei due dal primo di questi posti che lo ha:

Puoi quindi combinarli: per esempio una chiave API da una variabile d'ambiente con l'URL del contesto attuale. Le variabili d'ambiente sono adatte a script e job di CI, che non hanno contesti salvati:

export STATUS200_API_KEY=<api-key>
export STATUS200_URL=https://status200.ru
status200 incident list

export STATUS200_API_KEY=<api-key>
export STATUS200_URL=https://status200.ru
status200 incident list

$env:STATUS200_API_KEY = "<api-key>"
$env:STATUS200_URL = "https://status200.ru"
status200 incident list

I flag vengono prima di tutto il resto, per un singolo comando:

status200 --api-key <api-key> --url https://status200.ru incident list

Verificare che cosa userà la CLI#

status200 whoami mostra l'URL e la chiave API che userà il prossimo comando, e il contesto da cui provengono:

status200 whoami

URL:     https://status200.ru
API Key: 4f1c****0a13
Context: production

Della chiave vengono mostrati solo i primi quattro e gli ultimi quattro caratteri. La riga Context compare solo quando l'URL e la chiave sono quelli del contesto stesso, non valori sostituiti da un flag o da una variabile d'ambiente. whoami legge le tue impostazioni senza chiamare Status200: mostra che cosa invierà un comando, non se Status200 lo accetta. Senza nulla di salvato o impostato, risponde:

Not authenticated. Run `status200 login` to authenticate.

Il file di configurazione#

status200 login salva i contesti in ~/.oneuptime/config.json, nella tua cartella home (%USERPROFILE%\.oneuptime\config.json su Windows). La CLI lo crea in modo che solo il tuo utente possa leggerlo e scriverlo (modalità 0600):

{
  "currentContext": "production",
  "contexts": {
    "production": {
      "name": "production",
      "apiUrl": "https://status200.ru",
      "apiKey": "<api-key>"
    },
    "staging": {
      "name": "staging",
      "apiUrl": "https://status200.example.com",
      "apiKey": "<api-key>"
    }
  }
}

Il file contiene le chiavi API così come sono: tienilo fuori da cartelle condivise, backup e repository. Per uscire da un contesto, eliminalo con status200 context delete <name>; per uscire da tutti, elimina il file. Una chiave che potrebbe essere trapelata resta valida finché non la elimini in Status200, in Impostazioni del progetto → Avanzato → Chiavi API.

I formati di output e le dimensioni degli elenchi non vengono salvati qui: passa -o e --limit a ogni comando.

Risoluzione dei problemi#

Passi successivi#