Opetusohjelma: Vuokraajienvälisten eristysraporttien luominen

Tässä opetusohjelmassa näytetään, miten voit luoda vuokraajien välisiin eristysraportteihin ohjelmoitavuustyökalujen avulla.

Tässä opetusohjelmassa opit tekemään seuraavat toiminnot:

• Raportin luominen
• Vuokraajan kaikkien raporttien luettelo
• Yksittäisen raportin hakeminen
• Etsi ilmoitettujen yhteyksien ympäristö

Tärkeää

Lisätietoja vuokraajan eristyksestä: Vuokraajien välisen saapuvan ja lähtevän liikenteen rajoitukset.

Raportin luominen

Seuraavien tietojen avulla voit löytää eri tapoja, joilla voit luoda uuden raportin.

Muistiinpano

Voit luoda vain yhden raportin vuokraajaa ja kalenteripäivää kohti.

Power Automate/Logic Apps

Lisää uusi toiminto pohjaan ja etsi "Luo pyyntö, joka luo vuokraajan välisen yhteysraportin vuokraajalle tai palauta aiemmin luotu raportti". Toiminto ei edellytä parametreja.

PowerShell

Luo raportti seuraavan PowerShell-skriptin avulla.

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
}

Power Platform -ohjelmointirajapinnan viittaus: vuokraajien välisen yhteysraportin luominen

Vuokraajan kaikkien raporttien luettelo

Power Automate/Logic Apps

Lisää uusi toiminto pohjaan ja tee haku hakusanalla Luetteloi vuokraajien välisen yhteyden raportit. Toiminto ei edellytä parametreja.

PowerShell

Seuraavan PowerShell-komentosarjan avulla voit luetella kaikki vuokraajasi käytettävissä olevat raportit.

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
}

Power Platform -ohjelmointirajapinnan viittaus: Hae vuokraajien välinen yhteysraportti

Yksittäisen raportin hakeminen

Power Automate/Logic Apps

Lisää uusi toiminto pohjaan ja tee haku hakusanoilla Raporttien välisen yhteysraportin hankkiminen vuokraajan raporttitunnuksen mukaan. Anna raporttitunnus aiemmista vaiheista.

PowerShell

Seuraavan PowerShell-komentosarjan avulla voit noutaa vuokraajan yksittäisen raportin vuokraajan yhteyksistä.

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
}

Power Platform -ohjelmointirajapinnan viittaus: Luetteloi vuokraajien välisen yhteyden raportit

Ymmärrät, mitä raportti sisältää

Kukin valmis raportti sisältää connections matriisin. Jokainen merkintä kuvaa raportointiikkunan aikana havaittua vuokraajien välistä yhteyttä ja sisältää seuraavat:

• tenantId: ulkoisen vuokraajan, jonka yhteys tavoittaa.
• connectionType: yhteyden suunta joko outbound (vuokraajasta ulkoiseen vuokraajaan) tai inbound.
• connectionId: yhteyden tunnus. Tämä arvo vastaa yhteyden name (yhteyden resurssitunnuksen viimeisen segmentin) ympäristöä, jossa yhteys on.

Muistiinpano

Raporttilokien vuokraajien välillä muodostetut yhteysyritykset , jotka on havaittu raportointiikkunan aikana, ei vain tällä hetkellä olemassa olevat yhteydet. Tämä yhteystyyppi sisältää yritykset, jotka vuokraajan eristäminen esti vuokraajassa tai kohdevuokraajassa. Tämän vuoksi raportissa oleva connectionId ei ehkä vastaa yhteyttä, joka on olemassa missään ympäristössäsi tällä hetkellä. Et voi etsiä estettyjä yhteysyrityksiä (ja myöhemmin poistettuja yhteyksiä) seuraavan osan vaiheiden avulla.

Etsi ilmoitettujen yhteyksien ympäristö

Raportti tunnistaa kunkin yhteyden :n avulla connectionId, mutta se ei sisällä ympäristöä, jossa yhteys on. Ympäristön löytämiseksi luettele vuokraajasi ympäristöt, luettele kunkin ympäristön yhteydet ja vastaa yhteyttä name.

Käytä seuraavaa PowerShell-komentosarjaa, kun haluat hakea ympäristöstäsi ilmoitettua connectionIdkohdetta . Luettele ympäristötunnukset haluamallasi tavalla – esimerkiksi Power Platform -hallintakeskuksesta tai ympäristöjen ohjelmointirajapinnasta – ja anna connectionId raportin arvot.

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

Jos ilmoitettua connectionId ei löydy mistään ympäristöstä, se oli mitä todennäköisimmin estetty yritys (katso edellinen huomautus) tai yhteys, joka poistettiin raportin luomisen jälkeen.

Power Platform -ohjelmointirajapinnan viittaus: Yhteyksien luettelo ympäristössä

---

Liittyvä sisältö

Power Platform -ohjelmointirajapinnan viittaus – vuokraajien välisen yhteyden raportit

Power Platform -ohjelmointirajapinnan viittaus – yhteydet