Integraties

Wie het ziet

Integraties wordt aangeboden aan een lid met een rol die rollen en de instellingen van de organisatie mag beheren. Hetzelfde recht draagt Meldingen en Instellingen.

Waar het staat

Onder Account in het menu. De oude adressen API-sleutels en Webhooks werken nog en openen deze pagina, want alle drie de onderwerpen wonen er nu op.

Waar het voor is

De pagina stelt het in één regel: hoe een ander systeem met deze organisatie praat.

Er zijn twee richtingen, en de tabbladen scheiden ze. Een sleutel is uitgaand: het andere systeem roept ons ermee aan. Een webhook is inkomend: wij roepen het andere systeem aan. Ze worden samen ingericht en samen onderzocht, en daarom delen ze een pagina.

API-sleutels

123

1. 1Met een sleutel roept een ander systeem ons aan. Met een webhook roepen wij een ander systeem aan. Een serviceaccount is een machinelid.
2. 2Geeft een sleutel uit. Hij wordt één keer getoond en kan daarna niet worden teruggelezen.
3. 3Elke sleutel, en wanneer hij voor het laatst is gebruikt — en dat is wat je vertelt of hij nog nodig is.

Create API Key vraagt om een naam en geeft de sleutel uit.

De sleutel wordt één keer getoond, en het paneel zegt dat ook: kopieer deze sleutel nu, je kunt hem niet nog een keer zien. Er is geen manier om hem later terug te lezen. Raak je hem kwijt, trek hem dan in en maak een andere.

De tabel somt elke sleutel op met Name, Key, Last Used en Created. Last Used is wat je vertelt of een sleutel nog nodig is.

Een sleutel die hier wordt uitgegeven draagt gezag over de webhooks én over de klanten en de verificatie. Eén sleutel, niet één per tabblad. Behandel hem daarnaar, en geef elk systeem zijn eigen sleutel, zodat er één intrekken de rest niet stillegt.

Webhooks

Met een webhook kunnen wij een ander systeem aanroepen wanneer er iets gebeurt, zoals een klant die wordt geactiveerd, geschorst of ingetrokken.

Webhook toevoegen vraagt om een Endpoint-URL en de Gebeurtenissen die je wilt. Bij het aanmaken wordt één keer een ondertekengeheim getoond, met dezelfde waarschuwing als bij een sleutel. Met dat geheim bevestigt je server dat de aanroep werkelijk van ons kwam.

Elke webhook toont zijn laatste succes, hoeveel mislukkingen hij heeft gehad, en of hij Actief, Gepauzeerd of Uitgeschakeld is.

Testbericht sturen roept je endpoint nu aan en meldt wat er terugkwam, als de statuscode. Gebruik het wanneer het endpoint is gewijzigd, in plaats van te wachten tot een echte gebeurtenis het je vertelt.

Serviceaccounts

Een serviceaccount is een machinelid van deze organisatie. Het draait de desktopclient op een server en verifieert codes zonder mens. Het heeft geen mailbox en is niet zichtbaar voor de andere leden van een verbinding.

Er een aanmaken vraagt om een naam en geeft het identiteitscodegeheim terug. Eén keer getoond, zoals alles hier.

Elk serviceaccount toont hoeveel verbindingen het houdt, en draagt zijn eigen lijst met API-sleutels, met Nieuwe sleutel en Intrekken.

De reden om er een te gebruiken in plaats van het account van een collega: geautomatiseerde verificatie die op een server draait hoort niet te stoppen wanneer iemand vertrekt, en hoort niet zichtbaar te zijn voor de mensen aan de andere kant van een verbinding.

Intrekken

Elke sleutel, webhook en serviceaccount kan hier worden verwijderd. Een sleutel intrekken stopt het systeem dat hem gebruikt onmiddellijk, dus ga na wat hem houdt voordat je het doet.