Visibilidade tenant-wide de políticas de rede no Microsoft Fabric

A API List Networking Communication Policies fornece uma visão tenant-wide e paginada das configurações de rede de entrada e saída de todos os workspaces do Microsoft Fabric. Ela ajuda administradores a auditar regras de acesso público, firewalls de IP, políticas de Git, gateways e endpoints privados gerenciados.

Para que serve

Imagine que você precisa auditar quais workspaces no tenant possuem acesso público bloqueado ou regras restritivas de saída configuradas. Com esta API, você pode:

• Obter o inventário completo das regras de rede de entrada e saída de todos os workspaces.
• Filtrar workspaces com base nas políticas de direção de entrada ou saída.
• Auditar endpoints privados gerenciados e conexões permitidas.

Como usar

Você pode consultar os dados fazendo uma requisição HTTP GET para o endpoint administrativo.

GET https://api.fabric.microsoft.com/v1/admin/workspaces/networking/communicationpolicies

O que acontece nesse código:

1. A requisição é enviada para o endpoint de administração de políticas de rede do Fabric.
2. O serviço valida as permissões de administrador do chamador.
3. A API retorna a lista paginada com as políticas de rede de todos os workspaces do tenant.

Para filtrar apenas workspaces com negação de acesso público de entrada, utilize o parâmetro de filtro:

GET https://api.fabric.microsoft.com/v1/admin/workspaces/networking/communicationpolicies?filter=inbound/publicAccessRules/defaultAction eq 'deny'

O que acontece nesse código:

1. O parâmetro de filtro é aplicado à URL da requisição.
2. O Fabric processa a expressão para isolar os workspaces correspondentes.
3. O resultado retorna apenas os itens que atendem ao critério de negação de entrada.

Limitações e requisitos

• Estágio: Generally Available (GA).
• Permissões: O chamador deve ser um administrador do Fabric ou autenticar-se usando um service principal.
• Escopos delegados necessários: Tenant.Read.All ou Tenant.ReadWrite.All.