Organisaties, groepen en API-toegang
Een organisatie kan haar werk in groepen indelen. Een groep is een gedeelde werkruimte voor leden, voertuigen en bedrijfsdossiers waartoe zij toegang hebben. Leden krijgen geen afzonderlijke kopie van een voertuig of inspectie; hun effectieve acties blijven afhankelijk van rol, rechten en groepsinstellingen.
Praktijkvoorbeeld
Section titled “Praktijkvoorbeeld”| Ruimte | Typisch gebruik | Gebruikers |
|---|---|---|
| Operationele groep | Centraal team en gedeeld toezicht | Beheerders en managers |
| Subgroep vestiging Noord | Lokale voertuigen en inspecties | Medewerkers van vestiging Noord |
| Subgroep vestiging Zuid | Lokale voertuigen en inspecties | Medewerkers van vestiging Zuid |
Subgroepen zijn optioneel. Een klein verhuurbedrijf kan één groep gebruiken; een organisatie met meerdere locaties kan teams en toegang hiërarchisch indelen. Hiërarchie en rollen bepalen of een bovenliggende of naastliggende groep een resource kan zien of wijzigen. Lidmaatschap is geen onbeperkte toegang tot alle onderliggende groepen.
Wat een API-sleutel vertegenwoordigt
Section titled “Wat een API-sleutel vertegenwoordigt”Een beheerder maakt in API & integraties benoemde sleutels voor één specifieke groep. Sleutels hebben rechten en eventueel een vervaldatum en kunnen worden vervangen of ingetrokken. Een sleutel identificeert software die namens die groep handelt; het is geen persoonlijke login en geen automatische hoofdsleutel voor de organisatie. Ga er niet van uit dat een sleutel van een bovenliggende groep elke subgroep bereikt. Plan bij geïsoleerde vestigingen één sleutel en gegevensstroom per bedoelde groep.
De publieke API begrenst externe ID’s en resources tot de geauthenticeerde groep. RES-1042 in de ene groep is dus anders dan RES-1042 in een andere. Bewaar bij elk extern en publiek ID ook de gebruikte groep.
Een link verleent geen lidmaatschap
Section titled “Een link verleent geen lidmaatschap”Een tijdelijke launch_url lokaliseert de inspectie, maar de medewerker meldt zich nog steeds aan en moet toegang hebben tot de groep en handeling. Stuur de groepssleutel nooit naar de browser en neem hem niet op in de link. Zie authenticatie en toegang en integratiemodellen.