userProtectionScopeContainer: proceso

Espacio de nombres: microsoft.graph

Calcular las políticas y acciones de protección de datos aplicables a un usuario específico en función de su contexto.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) ProtectionScopes.Compute.User ProtectionScopes.Compute.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación ProtectionScopes.Compute.User ProtectionScopes.Compute.All

Solicitud HTTP

POST /me/dataSecurityAndGovernance/protectionScopes/compute

Nota:

Para llamar al punto de conexión /me, se requiere un usuario con la sesión iniciada y, por lo tanto, un permiso delegado. Los permisos de aplicación no se admiten al usar el /me punto de conexión.

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

Nota:

Si solo tiene el userPrincipalName del usuario, use la siguiente dirección URL para recuperar su identificador de objeto.

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.
client-request-id Cadena (se recomienda GUID). Opcional. Identificador único de esta solicitud, que se usa para el seguimiento y la depuración en los registros y las interacciones de soporte técnico. Si no se proporciona un identificador, es posible que se genere uno automáticamente. Se recomienda especificar el identificador para facilitar el seguimiento y la depuración. El mismo identificador que se envió en la solicitud se devuelve en la respuesta.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.

Parámetro Tipo Descripción
activities microsoft.graph.security.userActivityTypes Opcional. Especifica las actividades de usuario que admite la aplicación de llamada o en las que está interesada. Esta enumeración marcada permite seleccionar varios miembros simultáneamente. Los valores posibles son: none, uploadText, uploadFile, downloadText, downloadFile, unknownFutureValue, copyToClipboard, pasteFromClipboard, print y accessDebugTools. Use el encabezado de solicitud Prefer: include-unknown-enum-members para obtener los siguientes valores en esta enumeración evolutiva: copyToClipboard, pasteFromClipboard, print, accessDebugTools.
deviceMetadata deviceMetadata Opcional. Información sobre el dispositivo del usuario (tipo, SO) usado para la evaluación contextual de directivas.
integratedAppMetadata integratedApplicationMetadata Opcional. Información sobre la aplicación de llamada (nombre, versión) que se integra con Microsoft Purview.
locations policyLocation collection Opcional. Lista de ubicaciones específicas en las que está interesada la aplicación. Si se proporcionan, los resultados se recortan en las directivas que cubren estas ubicaciones. Use la aplicación de ubicación de directivas para ubicaciones de aplicaciones, el dominio de ubicación de directivas para ubicaciones de dominio o la dirección URL de ubicación de directivas para ubicaciones de direcciones URL. Debes especificar la @odata.type propiedad para declarar el tipo de policyLocation. Por ejemplo, "@odata.type": "microsoft.graph.policyLocationApplication".
pivotOn microsoft.graph.policyPivotProperty Opcional. Especifica cómo se deben agregar los resultados. Si se omite o none, los resultados pueden ser menos agregados. Los valores posibles son activity,location, none.

Encabezados de respuesta

Nombre Descripción
ETag Un indicador de si el estado de la directiva configurada por el administrador cambió. Si almacenó en caché el valor Etag y coincide con ETag de los resultados anteriores de esta API, no es necesario analizar la respuesta y almacenar en caché los resultados analizados. Almacene en caché este valor para las llamadas destinadas a procesar contenido.

Respuesta

Si se realiza correctamente, esta acción devuelve un 200 OK código de respuesta y una colección de objetos policyUserScope en el cuerpo de la respuesta. Cada objeto representa un conjunto de ubicaciones y actividades gobernadas por un conjunto común de acciones de directiva y modo de ejecución para el usuario especificado.

Ejemplos

Ejemplo 1: Ámbito de protección de proceso para una aplicación de empresa

Solicitud

En el ejemplo siguiente se calcula el ámbito de protección de un usuario que realiza cargas y descargas de texto.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta. Indica que para la uploadText actividad de la aplicación integrada con id. 83ef208a-0396-4893-9d4f-d36efbffc8bd, las directivas requieren una evaluación en línea. Para la uploadFile actividad de la aplicación integrada con id. 83ef208a-0396-4893-9d4f-d36efbffc8bd, las directivas requieren una evaluación sin conexión y desencadenan una restrictAccess acción (probablemente bloqueando cargas basadas en información contextual; por ejemplo, bloqueando cargas para usuarios o grupos específicos).

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

Ejemplo 2: Ámbito de protección de proceso para una aplicación de proveedor de redes

Solicitud

En el ejemplo siguiente se calcula el ámbito de protección de todo el inquilino para las cargas y descargas de texto y las cargas y descargas de archivos, interesadas en una aplicación específica.

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

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

Respuesta

En el ejemplo siguiente se muestra la respuesta. Indica que las actividades uploadText, downloadText, uploadFile o downloadFile para 'subdomain.domain1.com', 'domain2.com' o 'https://subdomain.domain3.com/content/subcontent' requieren evaluación sin conexión. La actividad UploadText para "subdomain.domain1.com", "domain2.com" o "https://subdomain.domain3.com/content/subcontent" requiere evaluación en línea.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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": []
    }
  ]
}
  • Se actualizó por última vez el