Contents

Introdução

Este documento descreve como uma empresa matriz pode gerenciar organizações filhas com APIs Umbrella usando o cabeçalho X-Umbrella-OrgID.

Overview

Uma empresa matriz pode gerenciar organizações filhas em APIs Umbrella de duas maneiras:

- Criando chaves de API em nome de cada organização filha e usando essas chaves para solicitações de API (na UI ou programaticamente).

- Ao fazer solicitações diretas de API em nome de cada organização filha usando uma única chave de API da organização pai.

Por exemplo, um escritório central (organização matriz) pode gerar um relatório de segurança global que inclua dados de eventos de todas as filiais (organizações filhas) fazendo solicitações de API para cada filial e combinando suas informações de eventos.

Fazer Solicitações de API em Nome de Organizações Filhas

Para fazer solicitações de API para uma organização-filho:

1. O administrador do escritório central cria uma chave de API na empresa matriz.

2. Ao fazer uma solicitação de API, adicione o cabeçalho X-Umbrella-OrgID com a OrgID da organização filha.

3. Use o token de acesso da chave de API da organização pai para autenticar a solicitação.

Exemplo:

Para gerar um relatório de evento de segurança combinado para várias filiais, o escritório central faz chamadas de API para cada filial, usando o cabeçalho X-Umbrella-OrgID correto para cada solicitação.