API-klienterKopier lenke til overskriften

Team kan opprette, rotere og tilbakekalle sine egne påloggingsdetaljer for Strise Connect API direkte i Innstillinger, uten å vente på at Strise utsteder dem. En påloggingsdetalj er en OAuth-klient: en klient-ID og en klienthemmelighet som integrasjonen din bytter mot et kortlevd tilgangstoken.

En klient som opprettes her handler på vegne av det Teamet den ble opprettet i, og bare det Teamet. Den arver ingenting fra den personlige tilgangen til personen som opprettet den.

Hvor finner du detKopier lenke til overskriften

Innstillinger → Utvikler → API-nøkler. Fanen vises når Strise har aktivert selvbetjening for Teamet ditt, og bare for brukere som har tillatelsen Vis API-klienter. Å opprette, rotere og tilbakekalle krever i tillegg Opprett API-klienter. Blant de innebygde rollene har Team Admin begge; Analyst, Manager og Auditor har ingen av dem, fordi påloggingsdetaljer er Team-konfigurasjon og ikke saksbehandling. Se Medlemmer for hvordan roller tildeles.

Opprette en klientKopier lenke til overskriften

Opprett OAuth-klient åpner en dialog med to felt:

Ved lagring vises klient-ID og klienthemmelighet én gang. Kopier hemmeligheten til hemmelighetslageret ditt før du lukker dialogen. Strise lagrer bare en hash av den og kan ikke vise den igjen – hvis den går tapt, roter hemmeligheten for å få en ny.

Bruke påloggingsdetaljeneKopier lenke til overskriften

Integrasjonen din bytter klient-ID og hemmelighet mot et bearer-token med mutasjonen clientAccessTokenGenerate i Connect API, og sender deretter tokenet i Authorization-headeren på hver forespørsel:

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

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

Tokenet er gyldig i den levetiden du valgte da du opprettet klienten. Be om et nytt når det utløper – det er ingen grense for hvor ofte en klient kan gjøre det. Den fullstendige gjennomgangen av autentisering, inkludert skjemautforskeren, finner du i Connect API-referansen.

KlientlistenKopier lenke til overskriften

Skjul tilbakekalte er på som standard; fjern haken for å se alle klienter Teamet noen gang har opprettet.

Rotere en hemmelighetKopier lenke til overskriften

Roter hemmelighet utsteder en ny hemmelighet for en eksisterende klient. Klient-ID-en endres ikke, så ingenting i integrasjonen din må registreres på nytt – bare hemmeligheten byttes.

Dialogen spør hvor lenge den nåværende hemmeligheten skal fortsette å virke:

Den nye hemmeligheten vises én gang, akkurat som ved opprettelse. En klient beholder maks én forrige hemmelighet: roterer du igjen mens et vindu fortsatt er åpent, avvikles den tidligere hemmeligheten umiddelbart, uansett hvilket vindu den fikk.

Rotasjon ugyldiggjør ikke tilgangstoken som allerede er utstedt. De fortsetter å virke til de utløper, som er maks klientens token-levetid.

Tilbakekalle en klientKopier lenke til overskriften

Tilbakekall stopper permanent en klient fra å be om nye tilgangstoken. Token den allerede har fortsetter å virke til de utløper – så etter tilbakekalling opphører klientens API-tilgang innenfor den konfigurerte token-levetiden, maks 24 timer. En tilbakekalt klient blir stående i listen som referanse, men kan ikke reaktiveres; opprett en ny klient i stedet.

Grense for påloggingsdetaljerKopier lenke til overskriften

Et Team kan ha maks 5 aktive påloggingsdetaljer. Telleren ved siden av listen viser hvor mange som er i bruk. Ved grensen er Opprett OAuth-klient deaktivert til du tilbakekaller en klient du ikke lenger bruker. Tilbakekalte klienter teller ikke mot grensen.

Klienter delt med et annet TeamKopier lenke til overskriften

Noen klienter som Strise satte opp før selvbetjening betjener mer enn ett Team. For disse er Roter hemmelighet og Tilbakekall deaktivert, fordi begge handlinger ville bryte det andre Teamets integrasjon. Kontakt tech@strise.ai for å endre en slik klient.

RevisjonssporKopier lenke til overskriften

Å opprette en klient, rotere hemmeligheten og tilbakekalle den registreres hver for seg i Teamets Aktivitetslogg, med hvem som gjorde det, klientens navn og når. Sammen med kolonnen Sist brukt lar dette deg svare på «hvem opprettet denne påloggingsdetaljen, og er den fortsatt i bruk?» uten å involvere Strise.

Når selvbetjening slås avKopier lenke til overskriften

Selvbetjening styrer bare opprettelsen av nye klienter. Hvis Strise slår det av for Teamet ditt, fortsetter klientene du allerede har å virke, og du kan fortsatt liste, rotere og tilbakekalle dem. For å kutte et Teams API-tilgang, tilbakekall klientene.

RelatertKopier lenke til overskriften

• Strise Connect API – hva API-et tilbyr og hvor referansen finnes.
• Webhooks – push-varsler fra Strise til systemene dine.
• Medlemmer – tildeling av rollene som har API-klienttillatelsene.