Посібник. Створення звітів про ізоляцію між клієнтами

У цьому посібнику показано, як створювати звіти про ізоляцію між клієнтами за допомогою інструментів програмування.

У цьому уроці ви дізнаєтеся, як:

• Створити звіт
• Перерахуйте всі звіти по орендарю
• Отримання одного звіту
• Знайдіть середовище для зв'язку, про яке повідомляється

Важливо

Щоб дізнатися більше про ізоляцію орендарів, перегляньте статтю Обмеження на вхід і вихід між орендарями.

Створити звіт

Щоб знайти різні способи створення звіту, скористайтеся наведеними нижче відомостями.

Нотатка

На кожен клієнт можна створювати лише один звіт на календарний день.

Power Automate / Logic Apps

Додайте нову дію до полотна, виконайте пошук за запитом "Створення запиту на створення звіту про підключення між клієнтами для клієнта або повернення наявного звіту". Для дії не потрібні параметри.

PowerShell

Для створення звіту використовуйте наведений нижче сценарій PowerShell.

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
}

Довідка з API платформи Power Platform: створення звіту про підключення між клієнтами

Перерахуйте всі звіти по орендарю

Power Automate / Logic Apps

Додайте нову дію до полотна та знайдіть звіти про підключення між клієнтами списку для клієнта. Для дії не потрібні параметри.

PowerShell

Використовуйте наведений нижче сценарій PowerShell, щоб перелічити всі доступні звіти для свого клієнта.

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
}

Довідка з API платформи Power Platform: звіти про підключення між клієнтами

Отримання одного звіту

Power Automate / Logic Apps

Додайте нову дію до полотна та виконайте пошук за запитом Отримання звіту про підключення між клієнтами за ідентифікатором звіту для клієнта. Укажіть ідентифікатор звіту з попередніх кроків.

PowerShell

Використовуйте наведений нижче сценарій PowerShell, щоб отримати один звіт для свого клієнта про підключення, що використовуються в межах клієнта.

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
}

Довідка з API платформи Power Platform: отримання звіту про підключення між клієнтами

Дізнайтеся, що містить звіт

Кожен завершений connections звіт містить масив. Кожен запис описує підключення між клієнтами, яке спостерігається під час вікна звітування, і включає в себе:

• tenantId: зовнішній клієнт, до якої досягає підключення.
• connectionType: напрямок підключення outbound (від клієнта до зовнішнього клієнта) або inbound.
• connectionId: ідентифікатор підключення. Це значення відповідає підключенню name (останньому сегменту ідентифікатора ресурсу підключення) у середовищі, де проживає підключення.

Нотатка

Звіт реєструє спроби підключення між клієнтами, які спостерігаються під час вікна звітування, а не лише наявні підключення. Цей тип підключення включає спроби, заблоковані ізоляцією клієнта в клієнті або цільовому клієнті. У результаті звіт може не відповідати підключенню, connectionId яке існує в жодному з ваших середовищ сьогодні. Не вдалося знайти заблоковані спроби підключення (і зв'язки, які пізніше було видалено), виконавши кроки, описані в наступному розділі.

Знайдіть середовище для зв'язку, про яке повідомляється

Звіт визначає кожне підключення за connectionId, але не включає середовище, у якому розташовано підключення. Щоб знайти середовище, перелічіть середовища в клієнті, перелічіть підключення кожного середовища та збігайтеся з підключенням name.

Скористайтеся наведеним нижче сценарієм PowerShell, щоб шукати в середовищах звіт connectionId. Перелічіть ідентифікатори середовища, як ви віддаєте перевагу, наприклад у Центрі адміністрування Power Platform або API середовищ, і надайте connectionId значення зі звіту.

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)"
    }
}

Якщо повідомлення connectionId не знайдено в жодному середовищі, імовірно, це була заблокована спроба (див. попередню нотатку) або підключення, видалене після створення звіту.

Довідка з API платформи Power Platform: підключення до списку в середовищі

---

Пов’язаний вміст

Довідка з API платформи Power Platform – звіти про підключення між клієнтами

Довідка з API платформи Power Platform – підключення