Didacticiel : Créer des rapports d’isolation entre clients (version préliminaire)

Article
10/16/2024

[Cet article fait partie de la documentation préliminaire et peut faire l’objet de modifications.]

Ce didacticiel démontre comment utiliser l’API Power Platform (version préliminaire) pour créer des rapports d’isolation entre clients.

Dans ce didacticiel, découvrez comment :

Authentifier à l’aide de l’API Power Platform
Créer un rapport
Lister tous les rapports pour le locataire
Récupérer un seul rapport

Important

Cette fonctionnalité est une fonctionnalité en version préliminaire.
Les fonctionnalités préliminaires ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.
Le nom d’hôte et les contrats de données peuvent changer pendant la période de version préliminaire de cette fonctionnalité.
Pour plus de détails sur l’isolation du client, consultez Restrictions entrantes et sortantes entre clients.

Étape 1. Authentifier à l’aide de l’API Power Platform

Utilisez le script PowerShell suivant pour authentifier avec l’API Power Platform.

Note

Les utilisateurs disposant du rôle Power Platform Administrateur Entra ID sont autorisés à exécuter le rapport d’impact isolation du client.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '49676daf-ff23-4aac-adcc-55472d4e2ce0' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

Étape 2. Créer un état

Utilisez le script PowerShell suivant pour créer le rapport.

Note

Vous ne pouvez créer qu’un seul rapport par client et par jour calendaire.

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
}

Référence de l’API Power Platform : Créer un rapport de connexion entre clients

Étape 3. Répertorier tous les rapports pour le client

Utilisez le script PowerShell suivant pour répertorier tous les rapports disponibles pour votre client.

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
}

Référence de l’API Power Platform : Obtenir un rapport de connexion entre clients

Étape 4. Récupérer un seul rapport

Utilisez le script PowerShell suivant pour récupérer un rapport unique pour votre client sur les connexions utilisées au sein du client.

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
}

Référence de l’API Power Platform : Répertorier les rapports de connexion entre clients

Voir aussi

Power Platform Référence API - Rapports de connexion entre locataires

Partager via