Gerenciar organizações filho com APIs de guarda-chuva usando X-Umbrella-OrgID
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:
- O administrador do escritório central cria uma chave de API na empresa matriz.
- Ao fazer uma solicitação de API, adicione
o cabeçalho X-Umbrella-OrgID com a OrgID da organização filha. - 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.
Histórico de revisões
| Revisão | Data de publicação | Comentários |
|---|---|---|
1.0 |
22-Oct-2025
|
Versão inicial |
Feedback