Inleiding

In dit document wordt beschreven hoe een bovenliggende organisatie met behulp van de X-Umbrella-OrgID-header kinderorganisaties met Umbrella API's kan beheren.

Overzicht

Een moederorganisatie kan kinderorganisaties in Umbrella API's op twee manieren beheren:

• Door API-sleutels te maken namens elke onderliggende organisatie en deze sleutels te gebruiken voor API-verzoeken (hetzij in de gebruikersinterface of programmatisch).
• Door directe API-verzoeken namens elke onderliggende organisatie te doen met behulp van een enkele ouder-org API-sleutel.

Een centraal kantoor (parent org) kan bijvoorbeeld een globaal beveiligingsrapport genereren dat gebeurtenisgegevens van alle filialen (child org's) bevat door API-verzoeken voor elke vestiging te maken en hun gebeurtenisinformatie te combineren.

API-verzoeken indienen namens kinderorganisaties

Om API-aanvragen voor een kinderorganisatie te maken:

1. De beheerder van het centrale kantoor maakt een API-sleutel in de bovenliggende organisatie.
2. Wanneer u een API-verzoek indient, voegt u de X-Umbrella-OrgIDheader toe met de OrgID van de onderliggende organisatie.
3. Gebruik de toegangstoken van de API-sleutel van de bovenliggende org om het verzoek te verifiëren.

Voorbeeld:
Om een gecombineerd security event report te genereren voor meerdere branches, doet het centrale kantoor API calls voor elk filiaal, met behulp van de juiste X-Umbrella-OrgID header voor elk verzoek.