userProtectionScopeContainer : compute

Espace de noms: microsoft.graph

Calculer les stratégies et actions de protection des données applicables à un utilisateur spécifique en fonction de son contexte.

Disponibilité de l’API

Cette API est disponible dans les déploiements cloud nationaux suivants.

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ✅ ✅ ❌

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) ProtectionScopes.Compute.User ProtectionScopes.Compute.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application ProtectionScopes.Compute.User ProtectionScopes.Compute.All

Requête HTTP

POST /me/dataSecurityAndGovernance/protectionScopes/compute

Remarque

L’appel du point de terminaison /me nécessite un utilisateur connecté et par conséquent une autorisation déléguée. Les autorisations d’application ne sont pas prises en charge lors de l’utilisation du point de /me terminaison.

POST /users/{usersId}/dataSecurityAndGovernance/protectionScopes/compute

Remarque

Si vous n’avez que le nom principal de l’utilisateur, utilisez l’URL suivante pour récupérer son ID d’objet.

GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}?$select=id

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Content-Type application/json. Obligatoire.
client-request-id Chaîne (GUID recommandé). Facultatif. Identificateur unique de cette requête, qui est utilisé pour le suivi et le débogage dans les journaux et les interactions de support. Si aucun ID n’est fourni, il se peut qu’il soit généré automatiquement. Nous vous recommandons de spécifier l’ID pour faciliter le suivi et le débogage. Le même ID que celui envoyé dans la demande est renvoyé dans la réponse.

Corps de la demande

Dans le corps de la demande, indiquez un objet JSON avec les paramètres suivants.

Paramètre Type Description
activités microsoft.graph.security.userActivityTypes Facultatif. Spécifie les activités de l’utilisateur que l’application appelante prend en charge ou qui l’intéressent. Cette énumération avec indicateur permet de sélectionner plusieurs membres simultanément. Les valeurs possibles sont none, uploadText, uploadFile, downloadText, downloadFile, unknownFutureValue, copyToClipboard, pasteFromClipboard, print, accessDebugTools. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les valeurs suivantes dans cette énumération évolutive : copyToClipboard, pasteFromClipboard, print, accessDebugTools.
deviceMetadata deviceMetadata Facultatif. Informations sur l’appareil de l’utilisateur (type, système d’exploitation) utilisées pour l’évaluation de la stratégie contextuelle.
integratedAppMetadata integratedApplicationMetadata Facultatif. Informations sur l’intégration de l’application appelante (nom, version) à Microsoft Purview.
emplacements collection policyLocation Facultatif. Liste des emplacements spécifiques qui intéressent l’application. Le cas échéant, les résultats sont tronqués en fonction des politiques applicables à ces emplacements. Utilisez l’application Emplacement de stratégie pour les emplacements d’application, le domaine Emplacement de stratégie pour les emplacements de domaine ou l’URL d’emplacement de stratégie pour les emplacements d’URL. Vous devez spécifier la @odata.type propriété pour déclarer le type de policyLocation. Par exemple : "@odata.type": "microsoft.graph.policyLocationApplication".
pivotOn Microsoft.Graph.PolicyPivotProperty Facultatif. Spécifie la façon dont les résultats doivent être agrégés. Si cette option est omise, les nonerésultats peuvent être moins agrégés. Les valeurs possibles sont activity,location, none.

En-têtes de réponse

Nom Description
ETag Indicateur si l’état de la stratégie configurée par l’administrateur a changé. Si vous avez mis en cache la valeur Etag et qu’elle correspond à ETag des résultats précédents de cette API, il n’est pas nécessaire d’analyser la réponse et de mettre en cache les résultats analysés. Mettez en cache cette valeur pour les appels afin de traiter le contenu.

Réponse

En cas de succès, cette action retourne un 200 OK code de réponse et une collection d’objets policyUserScope dans le corps de la réponse. Chaque objet représente un ensemble d’emplacements et d’activités régis par un ensemble commun d’actions de stratégie et de mode d’exécution pour l’utilisateur spécifié.

Exemples

Exemple 1 : Étendue de protection du calcul pour une application d’entreprise

Demande

L’exemple suivant calcule l’étendue de protection pour un utilisateur effectuant des chargements et téléchargements de texte.

POST https://graph.microsoft.com/v1.0/users/7c1f8f10-cba8-4a8d-9449-db4b876d1ef70/dataSecurityAndGovernance/protectionScopes/compute
Content-type: application/json
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736

{
   "activities": "uploadText,downloadText",
   "locations": [
      {
         "@odata.type": "microsoft.graph.policyLocationApplication",
         "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
      }
   ]
}

Réponse

L’exemple suivant illustre la réponse. Il indique que pour l’activité de l’application uploadText intégrée avec id 83ef208a-0396-4893-9d4f-d36efbffc8bd, les stratégies nécessitent une évaluation en ligne. Pour l’activité de l’application intégrée avec l’id uploadFile 83ef208a-0396-4893-9d4f-d36efbffc8bd, les stratégies nécessitent une évaluation hors ligne et déclenchent une restrictAccess action (probablement en bloquant les chargements en fonction des informations contextuelles ; par exemple, en bloquant les chargements pour des utilisateurs ou des groupes spécifiques).

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.policyUserScope)",
  "value": [
    {
      "activities": "uploadText",
      "executionMode": "evaluateInline",
      "locations": [
        {
          "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
        }
      ],
      "policyActions": []
    },
    {
      "activities": "uploadFile",
      "executionMode": "evaluateOffline",
      "locations": [
        {
          "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
        }
      ],
      "policyActions": [
        {
            "@odata.type": "#microsoft.graph.restrictAccessAction",
            "action": "restrictAccess",
            "restrictionAction": "block"
        }
     ]
    }
  ]
}

Exemple 2 : Étendue de protection du calcul pour une application de fournisseur réseau

Demande

L’exemple suivant calcule l’étendue de la protection à l’échelle du client pour les chargements et téléchargements de texte et les chargements et téléchargements de fichiers, intéressé par une application spécifique.

POST https://graph.microsoft.com/v1.0/security/dataSecurityAndGovernance/protectionScopes/compute
Content-type: application/json

{
    "activities": "uploadText,downloadText, uploadFile,downloadFile"
}

Réponse

L’exemple suivant illustre la réponse. Elle indique que les activités uploadText, downloadText, uploadFile ou downloadFile pour 'subdomain.domain1.com', 'domain2.com' ou '' nécessitenthttps://subdomain.domain3.com/content/subcontent une évaluation hors ligne. L’activité UploadText pour 'subdomain.domain1.com', 'domain2.com' ou '' nécessitent unehttps://subdomain.domain3.com/content/subcontent évaluation en ligne.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.policyTenantScope)",
  "value": [
    {
      "activities": "uploadText,uploadFile,downloadText,downloadFile",
      "executionMode": "evaluateOffline",
      "locations": [
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "subdomain.domain1.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "domain2.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationUrl",
          "value": "https://subdomain.domain3.com/content/subcontent"
        }
      ],
      "policyActions": []
    },
    {
      "activities": "uploadText",
      "executionMode": "evaluateInline",
      "locations": [
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "subdomain.domain1.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "domain2.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationUrl",
          "value": "https://subdomain.domain3.com/content/subcontent"
        }
      ],
      "policyActions": []
    }
  ]
}