Box: Configuración de la Integración de Acciones de Remediación

Prev Next

"Visión general"

XOps integrations let you take response actions in connected third-party applications as part of an investigation. You can revoke a user’s sessions or disable their account in your single sign-on (SSO) provider or a specific application. These actions help you contain threats by restricting access to affected accounts. To enable these actions, configure a connector for the relevant third-party application.

For more information, see Mitigating Threats in XOps Stories.

To configure the Remediation Actions integration, you need to:

  1. Configure the required settings in the SaaS application

  2. Create the API connector in the CMA

A XOps license is required for Remediation Actions integrations.

Beneficios de Conectar Box

El conector de Acciones de Remediación de Box permite a Cato tomar acciones de respuesta en los usuarios de Box durante una investigación. Utiliza una Aplicación de Plataforma Box dedicada con acceso de escritura, sin afectar a otros conectores de Box, como Actividades de Aplicaciones y Descubrimiento de Datos.

  • Deshabilitar Usuario: Encuentra al usuario gestionado de Box cuyo inicio de sesión coincide con el correo electrónico solicitado, ignorando mayúsculas y minúsculas, y establece el estado de la cuenta en Inactivo. El usuario ya no puede iniciar sesión y se le cierra sesión de todas las aplicaciones de Box. Las carpetas y archivos del usuario están ocultos para los colaboradores hasta que se reactive la cuenta. Los colaboradores mantienen sus niveles de permiso. Se retienen el contenido del usuario, los grupos y el asiento. Si el usuario ya está inactivo, la acción informa esa condición y tiene éxito.

  • Revocar Sesiones de Inicio de Sesión: Encuentra al usuario gestionado de la misma manera y solicita a Box que finalice todas las sesiones activas. La cuenta permanece activa y la contraseña no cambia, por lo que el usuario puede iniciar sesión nuevamente. Box ejecuta la finalización de sesiones como un trabajo en segundo plano. La acción tiene éxito cuando Box acepta el trabajo y el resultado del trabajo aparece en los eventos de administración de Box. La acción también se ejecuta para un usuario inactivo.

Cada acción se ejecuta para un usuario, identificado por correo electrónico, e informa Completado o Fallido con una razón. Las razones de falla incluyen un correo electrónico faltante, ningún usuario coincidente o un error de Box durante la búsqueda del usuario o la solicitud de acción. Cuando Box devuelve un código de error y un mensaje, estos aparecen en el resultado.

Configuración de la Integración de Box

Para configurar la integración, cree y autorice una Aplicación de Plataforma Box dedicada, luego cree el conector en la Aplicación de Gestión de Cato (CMA).

"Requisitos previos"

  • Una licencia Box Enterprise
  • Un Administrador de Box que pueda crear una Aplicación de Plataforma y aprobarla para la empresa
  • Autenticación de dos factores activada en la cuenta Box que crea la aplicación. Sin ella, el Secreto del Cliente no está disponible.

El Alcance para gestionar usuarios otorga amplios permisos sobre los usuarios gestionados, incluyendo cambiar inicios de sesión, restablecer contraseñas, modificar roles y gestionar su contenido empresarial. Use una Aplicación de Plataforma dedicada para este conector. No agregue este alcance a la aplicación utilizada por otros conectores Box.

Paso 1: Configurar la Integración en Box

Cree una Aplicación de Plataforma dedicada con acceso empresarial y permiso para gestionar usuarios.

Para configurar la integración en Box:

  1. Inicie sesión en la Consola de Desarrolladores de Box en https://<your_tenant>.app.box.com/developers/console.
  2. Cree una Aplicación de Plataforma.
  3. Elija Aplicación Personalizada e introduzca un nombre. Seleccione Integración como el propósito y Seguridad & Cumplimiento como la categoría.
  4. Elija Autenticación del Servidor (Concesión de Credenciales del Cliente) y haga clic en Crear Aplicación.
  5. En la página de Configuración General, copie y guarde el ID de Empresa para que pueda ingresarse en el CMA. Ingrese este valor como el ID del Asunto Box.
  6. En la página de Configuración, haga clic en Obtener Secreto del Cliente. Copie y guarde el ID del Cliente y el Secreto del Cliente para poder ingresarlos en el CMA.
  7. En la página de Configuración, establezca Nivel de Acceso a la Aplicación en Acceso a la Aplicación + Empresa. Esta configuración proporciona acceso a usuarios de toda la empresa, en lugar de solo a los usuarios propios de la aplicación.
  8. En Alcances de la Aplicación, seleccione Gestionar usuarios, luego haga clic en Guardar Cambios. Este alcance es necesario para buscar usuarios por correo electrónico, deshabilitar usuarios y finalizar sesiones de inicio de sesión.
  9. Vaya a la página de Autorización y haga clic en Revisar y Enviar.
  10. Haga que el Administrador de Box apruebe la aplicación para la empresa usando la notificación por correo electrónico.

Almacene el Client Secret de manera segura. No lo coloque en el control de origen, entradas o chat. Si cambia los alcances de la aplicación, el Administrador de Box debe reautorizar la aplicación desde Consola de Admin > Plataforma > Aplicaciones de Plataforma.

Paso 2: Crear el Conector API en la CMA

Después de haber configurado una integración con la aplicación requerida, agrega los detalles en el CMA.

Para Box, seleccione Autenticación OAuth2 para Box e ingrese las credenciales del Paso 1.

Para crear el conector API en el CMA:

  1. Desde el menú de navegación, haz clic en Recursos > Integraciones.
  2. Haz clic en la pestaña Integraciones Activas.
  3. Haga clic en Nuevo. Se abre el panel de Nueva Integración.
  4. Seleccione la Aplicación SaaS que desea agregar.
  5. En el menú desplegable de Capacidad, seleccione Acciones de Remediación.
  6. Agrega los detalles creados durante el primer paso.
    • Aplicación SaaS: Box
    • Seleccione Autenticación OAuth2 para Box
    • ID de Cliente: Ingrese el ID de Cliente del Paso 1
    • Client Secret: Ingrese el Client Secret del Paso 1
    • ID de Asunto de Box (ID de Empresa): Ingrese el ID de Empresa del Paso 1
    • Ingrese un nombre para la integración
    • (Opcional) Ingrese una descripción
  7. Haga clic en Guardar.

La aplicación es visible en la tabla de Aplicaciones Integradas con un estado de Conectado.

Limitaciones conocidas

  • Solo usuarios gestionados: Ambas acciones solo hacen búsqueda de usuarios gestionados en su empresa Box. Los colaboradores externos no se encuentran, incluso si su inicio de sesión coincide con el correo electrónico solicitado. El informe de la acción no encuentra coincidencia de usuarios.

  • Cuenta de servicio del conector: La cuenta de servicio del conector no se puede dirigir. Las cuentas de servicio no son devueltas por las búsquedas de usuarios de Box. Una acción dirigida al inicio de sesión de esa cuenta informa que no hay coincidencia de usuarios.

  • Inicios de sesión posteriores: Los inicios de sesión posteriores no son bloqueados por Revocar Sesiones de Inicio de Sesión. La cuenta permanece activa y la contraseña no se cambia. El usuario, o cualquier persona con sus credenciales, puede iniciar sesión nuevamente. Use Deshabilitar Usuario para bloquear el acceso.

  • Resultados de la terminación de sesión: El número de sesiones finalizadas no se informa por Revocar Sesiones de Inicio de Sesión. Box acepta la solicitud antes de que el trabajo en segundo plano se ejecute, sin verificarla contra las sesiones del usuario. Revise los eventos del administrador de Box para obtener el resultado del trabajo.

  • Acceso del usuario colaborador al contenido: Los archivos y carpetas del usuario están ocultos para los colaboradores por Deshabilitar Usuario hasta que la cuenta sea reactivada. El contenido permanece en Box. Para restaurar el acceso de inicio de sesión y colaborador, establezca el estado del usuario en Activo en la consola de administrador de Box.

  • Estado de la conexión: Solo el inicio de sesión y la búsqueda de usuarios son verificados por la prueba de conexión. Conectado confirma que Cato puede autenticar con las credenciales de la aplicación y listar usuarios gestionados por la empresa. Un permiso faltante para deshabilitar usuarios o finalizar sesiones se reporta cuando se ejecuta una acción, como un resultado Fallido con el error de Box.

  • Autenticación: Solo se admite el flujo de credenciales de cliente OAuth 2.0.