API-klienterKopiera länk till rubriken

Team kan skapa, rotera och återkalla sina egna autentiseringsuppgifter för Strise Connect API direkt i Inställningar, utan att vänta på att Strise utfärdar dem. En autentiseringsuppgift är en OAuth-klient: ett klient-ID och en klienthemlighet som din integration byter mot en kortlivad åtkomsttoken.

En klient som skapas här agerar på uppdrag av det team den skapades i, och enbart det teamet. Den ärver ingenting från den personliga åtkomsten hos den som skapade den.

Var du hittar detKopiera länk till rubriken

Inställningar → Utvecklare → API-nycklar. Fliken visas när Strise har aktiverat självbetjäning för ditt team, och bara för användare som har behörigheten Visa API-klienter. Att skapa, rotera och återkalla kräver dessutom Skapa API-klienter. Bland de inbyggda rollerna har Team Admin båda; Analyst, Manager och Auditor har ingen av dem, eftersom autentiseringsuppgifter är teamkonfiguration och inte ärendehantering. Se Medlemmar för hur roller tilldelas.

Skapa en klientKopiera länk till rubriken

Skapa OAuth-klient öppnar en dialog med två fält:

När du sparar visas klient-ID och klienthemlighet en gång. Kopiera hemligheten till ditt hemlighetslager innan du stänger dialogen. Strise lagrar bara en hash av den och kan inte visa den igen – om den går förlorad, rotera hemligheten för att få en ny.

Använda autentiseringsuppgifternaKopiera länk till rubriken

Din integration byter klient-ID och hemlighet mot en bearer-token med mutationen clientAccessTokenGenerate i Connect API, och skickar sedan den token i Authorization-headern i varje begäran:

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

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

Token är giltig under den livslängd du valde när du skapade klienten. Begär en ny när den går ut – det finns ingen gräns för hur ofta en klient får göra det. Den fullständiga genomgången av autentisering, inklusive schemautforskaren, finns i Connect API-referensen.

KlientlistanKopiera länk till rubriken

Dölj återkallade är på som standard; avmarkera för att se alla klienter teamet någonsin har skapat.

Rotera en hemlighetKopiera länk till rubriken

Rotera hemlighet utfärdar en ny hemlighet för en befintlig klient. Klient-ID:t ändras inte, så ingenting i din integration behöver registreras om – bara hemligheten byts ut.

Dialogen frågar hur länge den nuvarande hemligheten ska fortsätta fungera:

Den nya hemligheten visas en gång, precis som vid skapandet. En klient behåller högst en föregående hemlighet: roterar du igen medan ett fönster fortfarande är öppet avvecklas den tidigare hemligheten omedelbart, oavsett vilket fönster den fick.

Rotation ogiltigförklarar inte åtkomsttoken som redan har utfärdats. De fortsätter fungera tills de går ut, vilket är högst klientens tokenlivslängd.

Återkalla en klientKopiera länk till rubriken

Återkalla hindrar permanent en klient från att begära nya åtkomsttoken. Token den redan har fortsätter fungera tills de går ut – så efter återkallandet upphör klientens API-åtkomst inom dess konfigurerade tokenlivslängd, högst 24 timmar. En återkallad klient står kvar i listan som referens men kan inte återaktiveras; skapa en ny klient i stället.

Gräns för autentiseringsuppgifterKopiera länk till rubriken

Ett team kan ha högst 5 aktiva autentiseringsuppgifter. Räknaren bredvid listan visar hur många som används. Vid gränsen är Skapa OAuth-klient inaktiverad tills du återkallar en klient du inte längre använder. Återkallade klienter räknas inte mot gränsen.

Klienter som delas med ett annat teamKopiera länk till rubriken

Vissa klienter som Strise satte upp före självbetjäning betjänar mer än ett team. För dessa är Rotera hemlighet och Återkalla inaktiverade, eftersom båda åtgärderna skulle bryta det andra teamets integration. Kontakta tech@strise.ai för att ändra en sådan klient.

RevisionsspårKopiera länk till rubriken

Att skapa en klient, rotera dess hemlighet och återkalla den registreras var för sig i teamets Aktivitetslogg, med vem som gjorde det, klientens namn och när. Tillsammans med kolumnen Senast använd låter detta dig svara på ”vem skapade den här autentiseringsuppgiften, och används den fortfarande?” utan att involvera Strise.

När självbetjäning stängs avKopiera länk till rubriken

Självbetjäning styr bara skapandet av nya klienter. Om Strise stänger av det för ditt team fortsätter klienterna du redan har att fungera, och du kan fortfarande lista, rotera och återkalla dem. För att stänga av ett teams API-åtkomst, återkalla dess klienter.

RelateratKopiera länk till rubriken

• Strise Connect API – vad API:et erbjuder och var referensen finns.
• Webhooks – push-notiser från Strise till dina system.
• Medlemmar – tilldelning av rollerna som bär API-klientbehörigheterna.