Introducción
Este documento describe cómo una organización matriz puede administrar organizaciones secundarias con las API de Umbrella mediante el encabezado X-Umbrella-OrgID.
Overview
Una organización matriz puede administrar organizaciones secundarias en las API de Umbrella de dos maneras:
- Mediante la creación de claves API en nombre de cada organización secundaria y el uso de dichas claves para las solicitudes API (ya sea en la IU o mediante programación).
- Realizando solicitudes de API directas en nombre de cada organización secundaria mediante una única clave de API de organización principal.
Por ejemplo, una oficina central (organización principal) puede generar un informe de seguridad global que incluya datos de eventos de todas las sucursales (organizaciones secundarias) realizando solicitudes de API para cada sucursal y combinando su información de eventos.
Realizar solicitudes de API en nombre de organizaciones infantiles
Para realizar solicitudes de API para una organización secundaria:
- El administrador de la oficina central crea una clave de API en la organización principal.
- Al realizar una solicitud de API, agregue
el encabezado X-Umbrella-OrgID con el OrgID de la organización secundaria.
- Utilice el token de acceso de la clave de la API de organización principal para autenticar la solicitud.
Ejemplo:
Para generar un informe de eventos de seguridad combinado para varias sucursales, la oficina central realiza llamadas de API para cada sucursal, utilizando el encabezado X-Umbrella-OrgID correcto para cada solicitud.
