Tutorial: Criar relatórios de isolamento entre locatários

Este tutorial demonstra como usar as ferramentas de programação para criar relatórios de isolamento entre locatários.

Neste tutorial, saiba como:

Criar um relatório
Listar todos os relatórios para o inquilino
Obter um único relatório
Localizar o ambiente para uma ligação reportada

Importante

Para obter mais detalhes sobre o isolamento de inquilinos, consulte Restrições de entrada e de saída entre inquilinos.

Criar um relatório

Use as informações a seguir para encontrar várias maneiras de criar um novo relatório.

Nota

Só pode criar um relatório por inquilino por dia de calendário.

Power Automate / Aplicativos lógicos
PowerShell

Adicione uma nova ação à tela, procurando por "Criar uma solicitação para gerar um relatório de conexão entre locatários para um locatário ou retornar um relatório existente". A ação não requer parâmetros.

Relatório de conexão entre locatários cria captura de tela.

Utilize o seguinte script do PowerShell para criar o relatório.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

try 
{
    # Create a cross tenant connections report
    $tenantReportCreateResponse = Invoke-RestMethod -Method Post -Uri "https://api.powerplatform.com/governance/crossTenantConnectionReports?api-version=2022-03-01-preview" -Headers $Headers -Body ""
    $reportId = $tenantReportCreateResponse.reportId
    $reportStatus = $tenantReportCreateResponse.status

    Write-Host "Cross tenant connections report created with ID=$reportId and status=$reportStatus" 

} catch {
    # Dig into the exception to get the Response details.
    Write-Host "Response CorrelationId:" $_.Exception.Response.Headers["x-ms-correlation-id"]
    Write-Host "StatusCode:" $_.Exception.Response.StatusCode.value__ 
    Write-Host "StatusDescription:" $_.Exception.Response.StatusDescription
    $result = $_.Exception.Response.GetResponseStream()
        $reader = New-Object System.IO.StreamReader($result)
        $reader.BaseStream.Position = 0
        $reader.DiscardBufferedData()
        $responseBody = $reader.ReadToEnd();

        Write-Host $responseBody
}

Referência da API da Power Platform: Criar relatório de conexão entre locatários

Listar todos os relatórios para o inquilino

Power Automate / Aplicativos lógicos
PowerShell

Adicione uma nova ação ao canvas e procure por Listar relatórios de ligação entre inquilinos para um inquilino. A ação não requer parâmetros.

Liste relatórios de conexão entre locatários para uma captura de tela de locatário.

Use o seguinte script PowerShell para listar todos os relatórios disponíveis para o seu inquilino.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

try 
{
     # Get all available cross tenant connections reports for a tenant
    $tenantListReportResponse = Invoke-RestMethod -Method Get -Uri "https://api.powerplatform.com/governance/crossTenantConnectionReports?api-version=2022-03-01-preview" -Headers $Headers
    $report = $tenantListReportResponse | ConvertTo-Json -Depth 3 
    Write-Host $report 

} catch {
    # Dig into the exception to get the Response details.
    Write-Host "Response CorrelationId:" $_.Exception.Response.Headers["x-ms-correlation-id"]
    Write-Host "StatusCode:" $_.Exception.Response.StatusCode.value__ 
    Write-Host "StatusDescription:" $_.Exception.Response.StatusDescription
    $result = $_.Exception.Response.GetResponseStream()
        $reader = New-Object System.IO.StreamReader($result)
        $reader.BaseStream.Position = 0
        $reader.DiscardBufferedData()
        $responseBody = $reader.ReadToEnd();

        Write-Host $responseBody
}

Referência da API da Power Platform: Obter relatório de conexão entre locatários

Adicione uma nova ação à tela e procure por Obter um relatório de ligação entre inquilinos por ID de relatório para um inquilino. Forneça o ID do relatório dos passos anteriores.

Obtenha um relatório de conexão entre locatários por ID de relatório para uma captura de tela de locatário.

Utilize o seguinte script do PowerShell para obter um único relatório para o inquilino sobre ligações utilizadas no inquilino.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

try 
{
   # Get one cross tenant connections report for a tenant
    $tenantListReportResponse = Invoke-RestMethod -Method Get -Uri "https://api.powerplatform.com/governance/crossTenantConnectionReports/{$reportId}?api-version=2022-03-01-preview" -Headers $Headers
    $report = $tenantListReportResponse | ConvertTo-Json -Depth 2 
    Write-Host $report
    Write-Host "" 

} catch {
    # Go through the exception to get the Response details.
    Write-Host "Response CorrelationId:" $_.Exception.Response.Headers["x-ms-correlation-id"]
    Write-Host "StatusCode:" $_.Exception.Response.StatusCode.value__ 
    Write-Host "StatusDescription:" $_.Exception.Response.StatusDescription
    $result = $_.Exception.Response.GetResponseStream()
        $reader = New-Object System.IO.StreamReader($result)
        $reader.BaseStream.Position = 0
        $reader.DiscardBufferedData()
        $responseBody = $reader.ReadToEnd();

        Write-Host $responseBody
}

Referência da API da Power Platform: Listar relatórios de conexão entre locatários

Compreenda o que o relatório contém

Cada relatório concluído inclui um connections array. Cada entrada descreve uma ligação entre inquilinos observada durante a janela de reporte e inclui:

tenantId: o inquilino externo que a ligação alcança.
connectionType: a direção da ligação, seja outbound (do seu inquilino para o inquilino externo) ou inbound.
connectionId: o identificador da ligação. Este valor corresponde ao da name ligação (o último segmento do ID de recurso da ligação) no ambiente onde a ligação existe.

Nota

O relatório regista as tentativas de ligação entre inquilinos observadas durante a janela de reporte, não apenas as ligações que já existem. Este tipo de ligação inclui tentativas que foram bloqueadas pelo isolamento do inquilino no seu inquilino ou no inquilino alvo. Como resultado, a connectionId no relatório pode não corresponder a uma ligação que existe em nenhum dos seus ambientes atualmente. Não consegues localizar tentativas de ligação bloqueadas (e ligações que foram depois apagadas) usando os passos da secção seguinte.

Localizar o ambiente para uma ligação reportada

Um relatório identifica cada ligação por connectionId, mas não inclui o ambiente onde a ligação existe. Para encontrar o ambiente, enumera os ambientes no teu tenant, lista as ligações de cada ambiente e faz a correspondência na ligação name.

Use o seguinte script PowerShell para pesquisar nos seus ambientes um arquivo reportado connectionId. Enumere os seus IDs de ambiente como preferir — por exemplo, do centro de administração do Power Platform ou de uma API de ambientes — e forneça os connectionId valores do relatório.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "******"}

# The connectionId values from the report you fetched in the previous step.
$reportConnectionIds = @('<connectionId-1>', '<connectionId-2>')

# The environments in your tenant to search.
$environmentIds = @('<environment-id-1>', '<environment-id-2>')

foreach ($environmentId in $environmentIds)
{
    try
    {
        # List the connections in the environment.
        $uri = "https://api.powerplatform.com/connectivity/environments/$environmentId/connections?api-version=2024-10-01"
        $connections = (Invoke-RestMethod -Method Get -Uri $uri -Headers $Headers).value

        foreach ($connectionId in $reportConnectionIds)
        {
            # The report's connectionId matches the connection's 'name'.
            $match = $connections | Where-Object { $_.name -eq $connectionId }
            if ($match)
            {
                Write-Host "connectionId $connectionId is in environment $environmentId (connector: $($match.properties.apiId), display name: $($match.properties.displayName))"
            }
        }
    }
    catch
    {
        Write-Host "Could not list connections for environment ${environmentId}: $($_.Exception.Message)"
    }
}

Se um reportado connectionId não for encontrado em nenhum ambiente, provavelmente foi uma tentativa bloqueada (ver a nota anterior) ou uma ligação que foi apagada após a geração do relatório.

Referência da API Power Platform: Listar ligações num ambiente

Referência da API da Power Platform - Relatórios de conexão entre locatários

Referência da API Power Platform - Conectividade

Comentários

Esta página foi útil?

Last updated on 2026-08-13