Opplæring: Opprette isolasjonsrapporter på tvers av leier

Denne opplæringen viser hvordan du bruker programmerbarhetsverktøyene til å opprette isolasjonsrapporter på tvers av leier.

I denne opplæringen lærer du hvordan du kan gjøre følgende:

• Opprette en rapport
• Vis alle rapporter for leieren
• Hente én enkelt rapport
• Finn miljøet for en rapportert tilkobling

Viktig!

Hvis du vil ha mer informasjon om leierisolasjon, kan du se Innkommende og utgående begrensninger på tvers av leier.

Opprette en rapport

Bruk følgende informasjon til å finne ulike måter du kan opprette en ny rapport på.

Notat

Du kan bare opprette én rapport per leier per kalenderdag.

Power Automate/ Logic Apps

Legg til en ny handling på lerretet, søk etter «Opprett en forespørsel om å generere en tilkoblingsrapport på tvers av leier for en leier, eller returner en eksisterende rapport». Handlingen krever ingen parametere.

PowerShell

Bruk følgende PowerShell-skript til å opprette rapporten.

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-referanse for Power Platform: Opprett tilkoblingsrapport på tvers av leier

Vis alle rapporter for leieren

Power Automate/ Logic Apps

Legg til en ny handling på lerretet, og søk etter koblingsrapporter over flere leiere for en leier. Handlingen krever ingen parametere.

PowerShell

Bruk følgende PowerShell-skript til å vise alle tilgjengelige rapporter for leieren.

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-referanse for Power Platform: Hent tilkoblingsrapport på tvers av leier

Hente én enkelt rapport

Power Automate/ Logic Apps

Legg til en ny handling på lerretet, og søk etter Få en tilkoblingsrapport på tvers av leier etter rapport-ID for en leier. Oppgi rapport-ID-en fra tidligere trinn.

PowerShell

Bruk PowerShell-skriptet nedenfor til å hente én enkelt rapport for leieren om tilkoblinger som brukes i leieren.

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-referanse for Power Platform: Liste over tilkoblingsrapporter på tvers av leier

Forstå hva rapporten inneholder

Hver fullførte rapport inneholder en connections matrise. Hver oppføring beskriver en tilkobling på tvers av leier som ble observert under rapporteringsvinduet, og inkluderer:

• tenantId: den eksterne leieren som tilkoblingen når.
• connectionType: retningen på tilkoblingen, enten outbound (fra leieren til den eksterne leieren) eller inbound.
• connectionId: identifikatoren for tilkoblingen. Denne verdien samsvarer med tilkoblingens name (det siste segmentet av tilkoblingens ressurs-ID) i miljøet der tilkoblingen er plassert.

Notat

Rapporten logger tilkoblingsforsøk på tvers av leier som ble observert under rapporteringsvinduet , ikke bare tilkoblinger som for øyeblikket finnes. Denne tilkoblingstypen inkluderer forsøk som ble blokkert av leierens isolering på leieren eller målleieren. Det kan derfor hende at en connectionId i rapporten ikke samsvarer med en tilkobling som finnes i noen av miljøene dine i dag. Du finner ikke blokkerte tilkoblingsforsøk (og tilkoblinger som senere ble slettet) ved hjelp av trinnene i neste del.

Finn miljøet for en rapportert tilkobling

En rapport identifiserer hver tilkobling etter connectionId, men den inkluderer ikke miljøet der tilkoblingen er plassert. Hvis du vil finne miljøet, nummererer du miljøene i leieren, lister opp hvert miljøs tilkoblinger og samsvarer med tilkoblingen name.

Bruk følgende PowerShell-skript til å søke i miljøene etter en rapportert connectionId. Nummerer miljø-ID-ene dine slik du foretrekker, for eksempel fra administrasjonssenteret for Power Platform eller et miljø-API, og oppgi connectionId verdiene fra rapporten.

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

Hvis en rapportert connectionId ikke finnes i noe miljø, var det mest sannsynlig et blokkert forsøk (se forrige notat) eller en tilkobling som ble slettet etter at rapporten ble generert.

Power Platform API-referanse: Listetilkoblinger i et miljø

---

Relatert innhold

API-referanse for Power Platform – tilkoblingsrapporter på tvers av leier

API-referanse for Power Platform – tilkobling