Godkendelse

Hver anmodning, CLI'en sender, bærer en API-nøgle til dit projekt. Gem nøgler én gang med status200 login, én kontekst til hvert miljø, eller giv dem til en kommando i flag eller miljøvariabler, som scripts gør. Denne side viser hver måde, og hvilken en kommando bruger, når der er flere.

Før du begynder#

Du skal bruge en API-nøgle til dit projekt. Opret en under Projektindstillinger → Avanceret → API-nøgler med Opret API-nøgle, og giv den den adgang, dine kommandoer har brug for: se Opret en API-nøgle. En nøgle gør, hvad dens tilladelser tillader: en nøgle, der kun må læse poster, kan vise og læse dem, men ikke ændre dem.

På Status200 Cloud virker API-nøgler kun, mens projektet har abonnementet Growth eller højere. Under det svarer hver kommando med API error (402) og en meddelelse, der nævner abonnementet, indtil projektet opgraderes; så virker den samme nøgle igen. Se API-nøgler og SCIM under deres abonnement.

Log ind#

status200 login gemmer en API-nøgle og adressen på din Status200 som en kontekst og gør den til den aktuelle kontekst:

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

For eksempel en kontekst ved navn production:

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

Den svarer Logged in successfully. Context "production" is now active. En skråstreg i slutningen af adressen fjernes, og et nyt login under det samme navn erstatter den kontekst.

Kontekster#

En kontekst er et gemt login: et navn, en adresse og en API-nøgle. Gem én til hvert projekt eller miljø, og vælg så én til alle de kommandoer, der følger, eller til en enkelt kommando.

1. Gem en kontekst til hvert miljø#

   Bash

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

   Hvert login gør sin kontekst til den aktuelle, så nu er staging den aktuelle.

2. Vis dem#

   Bash

   status200 context list

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

   * markerer den aktuelle kontekst. API-nøgler vises aldrig.

3. Skift til en anden kontekst#

   Bash

   status200 context use production

   Den svarer Switched to context "production". og de kommandoer, der følger, bruger den.

4. Brug en kontekst til én kommando#

   Bash

   status200 incident list --context staging

   Den aktuelle kontekst forbliver, som den var.

Hvilke legitimationsoplysninger en kommando bruger#

En kommando skal bruge en API-nøgle og en URL. Den tager hver af de to fra det første af disse steder, der har den:

Du kan altså blande dem: for eksempel en API-nøgle fra en miljøvariabel med URL'en fra den aktuelle kontekst. Miljøvariabler passer til scripts og CI-job, som ikke har gemte kontekster:

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

Flag går forud for alt andet, for én kommando:

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

Tjek, hvad CLI'en vil bruge#

status200 whoami viser den URL og API-nøgle, den næste kommando vil bruge, og den kontekst, de kommer fra:

status200 whoami

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

Kun nøglens første fire og sidste fire tegn vises. Linjen Context vises kun, når URL'en og nøglen er kontekstens egne, ikke værdier, som et flag eller en miljøvariabel har erstattet. whoami læser dine indstillinger uden at kalde Status200: den viser, hvad en kommando vil sende, ikke om Status200 accepterer det. Er intet gemt eller sat, svarer den:

Not authenticated. Run `status200 login` to authenticate.

Konfigurationsfilen#

status200 login gemmer kontekster i ~/.oneuptime/config.json i din hjemmemappe (%USERPROFILE%\.oneuptime\config.json på Windows). CLI'en opretter den, så kun din bruger kan læse og skrive den (tilstand 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>"
    }
  }
}

Filen indeholder API-nøglerne, som de er: hold den ude af delte mapper, sikkerhedskopier og repositories. Log ud af én kontekst ved at slette den med status200 context delete <name>; log ud af alle ved at slette filen. En nøgle, der kan være lækket, er gyldig, indtil du sletter den i Status200 under Projektindstillinger → Avanceret → API-nøgler.

Outputformater og listestørrelser gemmes ikke her: giv -o og --limit til hver kommando.

Fejlfinding#

Næste skridt#