API-klienterKopiér link til overskriften

Teams kan oprette, rotere og tilbagekalde deres egne legitimationsoplysninger til Strise Connect API direkte i Indstillinger uden at vente på, at Strise udsteder dem. En legitimationsoplysning er en OAuth-klient: et klient-id og en klienthemmelighed, som din integration bytter til et kortlivet adgangstoken.

En klient, der oprettes her, handler på vegne af det team, den blev oprettet i, og kun det team. Den arver intet fra den personlige adgang hos den person, der oprettede den.

Hvor finder du detKopiér link til overskriften

Indstillinger → Udvikler → API-nøgler. Fanen vises, når Strise har aktiveret selvbetjening for dit team, og kun for brugere med tilladelsen Vis API-klienter. Oprettelse, rotation og tilbagekaldelse kræver desuden Opret API-klienter. Blandt de indbyggede roller har Team Admin begge; Analyst, Manager og Auditor har ingen af dem, fordi legitimationsoplysninger er teamkonfiguration og ikke sagsbehandling. Se Medlemmer for, hvordan roller tildeles.

Oprette en klientKopiér link til overskriften

Opret OAuth-klient åbner en dialog med to felter:

Ved gem vises klient-id og klienthemmelighed én gang. Kopiér hemmeligheden til dit hemmelighedslager, før du lukker dialogen. Strise gemmer kun en hash af den og kan ikke vise den igen – hvis den går tabt, så rotér hemmeligheden for at få en ny.

Brug af legitimationsoplysningerneKopiér link til overskriften

Din integration bytter klient-id og hemmelighed til et bearer-token med mutationen clientAccessTokenGenerate i Connect API og sender derefter tokenet i Authorization-headeren på hver anmodning:

mutation ClientAccessTokenGenerate {
  clientAccessTokenGenerate(clientId: "YOUR_CLIENT_ID", clientSecret: "YOUR_CLIENT_SECRET") {
    expires
    token
  }
}

{
  "Authorization": "Bearer <token>"
}

Tokenet er gyldigt i den levetid, du valgte, da du oprettede klienten. Anmod om et nyt, når det udløber – der er ingen grænse for, hvor ofte en klient må gøre det. Den fulde gennemgang af godkendelse, inklusive schema explorer, findes i Connect API-referencen.

KlientlistenKopiér link til overskriften

Skjul tilbagekaldte er slået til som standard; fjern fluebenet for at se alle klienter, teamet nogensinde har oprettet.

Rotere en hemmelighedKopiér link til overskriften

Rotér hemmelighed udsteder en ny hemmelighed til en eksisterende klient. Klient-id'et ændres ikke, så intet i din integration skal registreres igen – kun hemmeligheden udskiftes.

Dialogen spørger, hvor længe den nuværende hemmelighed skal blive ved med at virke:

Den nye hemmelighed vises én gang, præcis som ved oprettelsen. En klient beholder højst én forrige hemmelighed: roterer du igen, mens et vindue stadig er åbent, afvikles den tidligere hemmelighed straks, uanset hvilket vindue den fik.

Rotation ugyldiggør ikke adgangstokens, der allerede er udstedt. De virker fortsat, indtil de udløber, hvilket højst er klientens tokenlevetid.

Tilbagekalde en klientKopiér link til overskriften

Tilbagekald forhindrer permanent en klient i at anmode om nye adgangstokens. Tokens, den allerede har, virker fortsat, indtil de udløber – så efter tilbagekaldelsen ophører klientens API-adgang inden for dens konfigurerede tokenlevetid, højst 24 timer. En tilbagekaldt klient bliver stående i listen som reference, men kan ikke genaktiveres; opret en ny klient i stedet.

Grænse for legitimationsoplysningerKopiér link til overskriften

Et team kan højst have 5 aktive legitimationsoplysninger. Tælleren ved siden af listen viser, hvor mange der er i brug. Ved grænsen er Opret OAuth-klient deaktiveret, indtil du tilbagekalder en klient, du ikke længere bruger. Tilbagekaldte klienter tæller ikke med i grænsen.

Klienter delt med et andet teamKopiér link til overskriften

Nogle klienter, som Strise oprettede før selvbetjening, betjener mere end ét team. For dem er Rotér hemmelighed og Tilbagekald deaktiveret, fordi begge handlinger ville bryde det andet teams integration. Kontakt tech@strise.ai for at ændre en sådan klient.

RevisionssporKopiér link til overskriften

Oprettelse af en klient, rotation af dens hemmelighed og tilbagekaldelse registreres hver for sig i teamets Aktivitetslog med, hvem der gjorde det, klientens navn og hvornår. Sammen med kolonnen Sidst brugt lader det dig svare på "hvem oprettede denne legitimationsoplysning, og er den stadig i brug?" uden at involvere Strise.

Når selvbetjening slås fraKopiér link til overskriften

Selvbetjening styrer kun oprettelsen af nye klienter. Hvis Strise slår det fra for dit team, virker de klienter, du allerede har, fortsat, og du kan stadig liste, rotere og tilbagekalde dem. For at afskære et teams API-adgang skal du tilbagekalde dets klienter.

RelateretKopiér link til overskriften

• Strise Connect API – hvad API'et tilbyder, og hvor referencen findes.
• Webhooks – push-notifikationer fra Strise til dine systemer.
• Medlemmer – tildeling af de roller, der bærer API-klienttilladelserne.