Soluciona problemas mediante el solucionador de problemas de políticas de BeyondCorp Enterprise

BeyondCorp Enterprise proporciona una herramienta de solución de problemas que los administradores pueden usar para clasificar y analizar el acceso del usuario final.

BeyondCorp Enterprise permite que las empresas creen reglas avanzadas que proporcionen acceso a las aplicaciones en función del contexto. Sin embargo, cuando aplicas varias reglas de acceso a los recursos, desde restricciones de ubicación hasta reglas de dispositivos, puede resultar difícil comprender cómo se evalúan las políticas y por qué un usuario final tiene o no acceso al recurso de destino.

El solucionador de problemas de políticas le permite identificar por qué el acceso se realiza correctamente o no, y, si es necesario, cambiar la política y, luego, indicarle al usuario final que modifique su contexto para permitir el acceso o quitar la vinculación a fin de denegar el acceso inesperado.

El solucionador de problemas de políticas es una herramienta útil para organizaciones que necesitan aplicar varias reglas a distintos recursos para distintos grupos de usuarios.

Antes de comenzar

El solucionador de problemas de políticas es una función premium y requiere una licencia BeyondCorp Enterprise.

Para maximizar la eficacia del solucionador de problemas de políticas, asegúrate de tener el rol de revisor de seguridad (roles/iam.securityReviewer). Esto garantiza que puedas leer todas las políticas de Cloud IAM aplicables.

A fin de solucionar problemas de acceso para un dispositivo, debes tener permiso para ver los detalles. Si las políticas asociadas al recurso de destino contienen políticas de dispositivo, como un nivel de acceso que requiere que el dispositivo esté encriptado, es posible que no obtengas resultados precisos, a menos que se verifique el permiso para recuperar los detalles de dispositivo del principal de destino. Los administradores avanzados de Google Workspace, de administrador de servicios y de administrador de dispositivos móviles suelen tener acceso para ver los detalles del dispositivo. Para permitir que un usuario que no es administrador avanzado, administrador de dispositivos móviles o de servicio solucione problemas de acceso, sigue estos pasos:

  1. Crea un rol de administrador de Google Workspace personalizado que contenga el privilegio Servicios > Administración de dispositivos móviles > Administrar dispositivos y configuración (que se encuentra en Privilegios de la Consola del administrador).
  2. Asigna la función a los usuarios mediante la Consola del administrador

A fin de solucionar problemas de acceso a un recurso proporcionado por un grupo de Google Cloud, debes tener permiso para ver a sus miembros. Si las políticas contienen un grupo, debes tener permiso para ver los detalles del grupo antes de abrirlo. Los administradores de grupo y los administradores avanzados de Google Workspace suelen tener acceso para ver las membresías del grupo. Para permitir que un usuario que no es administrador avanzado ni administrador de grupo solucione problemas de acceso, completa los siguientes pasos:

  1. Crea un rol de administrador de Google Workspace personalizado que contenga el privilegio Grupos > Lectura (ubicado en Privilegios de la API de Admin).
  2. Asigna el rol al usuario. Esto le permite al usuario ver la membresía de todos los grupos de tu dominio y solucionar problemas de acceso de manera más eficaz.

El permiso del rol personalizado es opcional. Si no tienes permiso para ver un rol personalizado, es posible que no puedas saber si una principal tiene acceso a ella desde las vinculaciones con roles personalizados.

Descripción general del flujo de trabajo del solucionador de problemas

Soluciona problemas de acceso denegado

Para solucionar problemas de acceso denegado, puedes activar la función para un recurso de IAP en la configuración de IAP. Para esto, haz clic en los tres puntos que se encuentran a la derecha de la aplicación protegida con IAP, Configuración y, luego, selecciona Generar una URL de solución de problemas. Para maximizar la eficacia del solucionador de problemas de políticas, asegúrate de tener el rol de administrador de configuración de IAP (roles/iap.settingsAdmin). Esto garantiza que puedas recuperar y actualizar la configuración de IAP de todos los recursos de IAP.

Las URL de solución de problemas solo se presentan en las páginas 403 predeterminadas si están habilitadas.

El solucionador de problemas de políticas proporciona una interfaz de usuario en la que puede ver los resultados de la evaluación detallados de todas las políticas eficaces para el recurso de IAP de destino. Cuando el acceso de un usuario falla, la página 403 muestra una URL de solución de problemas. Cuando se visita, el solucionador de problemas de políticas muestra los detalles de las vinculaciones fallidas y el análisis de los niveles de acceso con errores, si existen en las vinculaciones. También puede usar la herramienta para solucionar problemas a fin de obtener una vista detallada del acceso de un usuario a un recurso.

Se denegó el acceso de los usuarios

Cuando un usuario no tiene el permiso o no cumple con la condición requerida para acceder a un recurso de IAP, se lo dirige a una página de error de acceso 403. La página 403 incluye una URL de solución de problemas que se puede copiar y enviar de forma manual al propietario de la aplicación o al administrador de seguridad, o bien puede hacer clic en Enviar correo electrónico en la interfaz de usuario.

Cuando un usuario hace clic en Enviar correo electrónico, se envía un correo electrónico a la dirección de correo electrónico de asistencia (supportEmail) que se configuró en la pantalla de consentimiento de OAuth. Para obtener más información sobre cómo configurar la pantalla de consentimiento de OAuth, consulta Crea clientes de OAuth de manera programática para IAP.

Cómo solucionar problemas de acceso con errores

Cuando recibe un vínculo de una solicitud de acceso con errores de un usuario final, puede hacer clic en la URL, que se abrirá en el navegador predeterminado. Si no accediste a Google Cloud Console en tu navegador predeterminado, es posible que se te redireccione a otra página de acceso para acceder a la página de análisis del solucionador de problemas de políticas.

La página de análisis del solucionador de problemas de políticas proporciona una vista resumida, una vista de las políticas de IAM y una tabla que muestran el contexto de un usuario y el dispositivo, como la dirección principal, el ID de dispositivo y el recurso de IAP al que se accede, entre otros.

La vista resumida proporciona una vista global de todos los resultados de políticas y membresías relevantes. La vista de la política de IAM proporciona una lista de los resultados de la evaluación de las vinculaciones de IAM efectivas, otorgadas o no, junto con una vista de alto nivel de dónde se produjeron las fallas, como La principal no es miembro y no cumple con las condiciones.

Para analizar aún más el acceso con errores, puedes ver los Detalles de vinculación. En Detalles de la vinculación, puedes ver los componentes de las vinculaciones Función, Principal y Condición. El componente con permisos suficientes indicará No se requiere ninguna acción. Los componentes en los que se produjo un error de acceso, las brechas en los permisos se explican de manera explícita, como Categoría principal: agrega una principal a los grupos que aparecen a continuación.

Observe que, en la interfaz de usuario, la sección Vinculaciones relevantes está activada de forma predeterminada. Las vinculaciones que se mencionan en la sección Vinculaciones relevantes no son una lista completa, sino que son las vinculaciones más relevantes que podrían interesarte cuando solucionas un problema de acceso específico. Las políticas eficaces asociadas con un recurso específico pueden contener muchas vinculaciones, que no son relevantes para el recurso, como un permiso de Cloud Storage otorgado a nivel de proyecto. Se filtran los detalles irrelevantes.

Para investigar aún más una condición con errores, consulte las explicaciones del nivel de acceso. Los detalles del nivel de acceso indican dónde se produjo el error y sugieren soluciones para solucionarlo. Puedes propagar las acciones necesarias al usuario o corregir las políticas, si es necesario. Por ejemplo, puedes enviar la siguiente acción al usuario: La solicitud falló porque el dispositivo no es propiedad de la empresa.

Habilita la URL de solución de problemas para tu página de error personalizada Access Denied

Para agregar la URL del solucionador de problemas de políticas a la página de error Access Denied de tu cliente, completa los siguientes pasos:

  1. Para redireccionar a tus usuarios a tu página personalizada en lugar de a la página de error predeterminada de IAP, completa el siguiente paso: Configura una página de error de acceso denegado personalizada.
  2. Activa la función de URL del solucionador de problemas de políticas en la configuración de IAP.

Después de configurar la URL de la página access denied en la configuración de IAP, la URL del solucionador de problemas de políticas se incorpora como un parámetro de búsqueda con escape. La clave del parámetro de búsqueda es troubleshooting-url.

Soluciona problemas de acceso de los usuarios de forma proactiva

Puede usar el solucionador de problemas de políticas, ubicado en el panel Seguridad de la página de destino de BeyondCorp Enterprise, para solucionar eventos hipotéticos y obtener estadísticas y visibilidad de sus políticas de seguridad. Por ejemplo, puede comprobar el acceso de un usuario a un recurso protegido por IAP en particular e investigar si este es realmente necesario. Otro ejemplo es cuando realiza un cambio en la política de un recurso protegido por IAP y desea asegurarse de que el administrador avanzado aún tenga acceso. Puedes ir a la Consola del administrador de Google para obtener el ID de dispositivo del administrador avanzado y, luego, usarlo en el solucionador de problemas para verificar el acceso.

Con la solución de problemas de solicitudes hipotéticas, puedes verificar que un usuario tenga los permisos adecuados para acceder a un recurso IAP antes de que se produzca un evento de denegación real. Para hacerlo, puedes usar el correo electrónico del usuario, el recurso de destino de IAP y cualquier contexto de solicitud opcional, incluida la dirección IP, la marca de tiempo, el ID de dispositivo o el contexto del dispositivo.

Al solucionar problemas de solicitudes hipotéticas con el ID del dispositivo, asegúrate de que el dispositivo pertenezca al correo electrónico principal de destino. Puede obtener el ID de dispositivo desde el registro de auditoría de IAP o en Consola del administrador de Google -> Dispositivos > Dispositivos móviles y extremos > Dispositivos.

Cuando se solucionan problemas de solicitudes hipotéticas con contextos de dispositivos, el solucionador de problemas admite los siguientes atributos:

  • is_secured_with_screenlock
  • encryption_status
  • os_type
  • os_version
  • verified_chrome_os
  • is_admin_approved_device
  • is_corp_owned_device

Situaciones de solución de problemas comunes

A continuación, se describen algunas situaciones comunes que pueden surgir cuando trabajas con el solucionador de problemas de políticas:

  • Proporciona un elemento de acción al usuario final después de solucionar el problema, como indicarle al usuario final que cambie a un dispositivo empresarial o que actualice el sistema operativo.
  • Descubres que no asignaste el permiso correcto al usuario final, por lo que debes crear una vinculación nueva para el principal de destino en la interfaz de IAP (roles/iap.httpsResourceAccessor).
  • Descubre que creaste un nivel de acceso incorrectamente por los siguientes motivos de ejemplo:
    • Creaste restricciones complicadas de atributos anidados, como las subredes corporativas, que ya no se aplican porque los empleados ahora trabajan desde casa.
    • Aplicó parámetros de nivel de acceso incorrectos. Por ejemplo, especificó que los usuarios pueden crear un nivel personalizado con restricciones de proveedores, pero comparan los atributos con diferentes tipos. Por ejemplo, device.vendors["vendorX"].data.["should_contain_boolean_value"] == "true". Ten en cuenta que el lado izquierdo muestra un valor booleano, mientras que el lado derecho muestra una string true. Debido a los atributos equivalentes, es difícil detectar el error en la construcción de la política. El solucionador de problemas de políticas ayuda a explicar que esto se evalúa como un error con resultados de evaluaciones parciales detallados en ambos lados.

Comportamiento previsto del solucionador de problemas

La solución de problemas se realiza en los accesos restringidos mediante las políticas actuales y la información del dispositivo con la marca de tiempo actual. Por lo tanto, si sincronizaste tu dispositivo o cambiaste las políticas luego de la denegación del acceso restringido, no estás solucionando problemas usando los contextos y los datos anteriores. Estás solucionando problemas usando los contextos y los datos actuales.

Sugerencias para solucionar problemas relacionados con vinculaciones

Para cualquier componente (rol, principal, condición) de cualquier vinculación con errores de autorización, otorga los permisos necesarios si deseas verificar los resultados de la solución de problemas de esas vinculaciones.

Si la verificación de rol falla en una vinculación, completa las siguientes acciones:

  • Verifica otras vinculaciones o crea una vinculación nueva mediante la interfaz de IAP para otorgar el rol roles/iap.httpsResourceAccessor a la principal con niveles de acceso aplicados, si es necesario.
  • Si es un rol personalizado, puedes agregar el permiso de destino al rol personalizado para otorgar el permiso (después de corregir cualquier falla de principal y de condición, si corresponde). Ten en cuenta que agregar permisos a un rol personalizado existente puede otorgar otras vinculaciones con este rol personalizado con más permisos de los necesarios. No hagas esto a menos que conozcas el alcance del rol personalizado y el riesgo de tu operación.
  • Si no es un rol personalizado, verifica otras vinculaciones o crea una nueva mediante la interfaz de IAP para otorgar el rol roles/iap.httpsResourceAccessor a la principal con niveles de acceso aplicados, si es necesario.

Si la verificación de rol tiene éxito, pero la verificación de principal falla, completa las siguientes acciones:

  • Si los miembros contienen un grupo, puede agregar el principal a este para otorgar los permisos (después de corregir cualquier falla de la condición, cuando corresponda). Ten en cuenta que si agregas un principal a un grupo existente, es posible que se le otorgue más permiso del necesario. No lo hagas a menos que conozcas el alcance del grupo y el riesgo de tu operación.
  • Si los miembros no contienen un grupo, verifica otras vinculaciones o crea una nueva mediante la interfaz de IAP para otorgar el roles/iap.httpsResourceAccessor a la principal con los niveles de acceso aplicados, si es necesario.

Si la verificación de rol y principal tiene éxito, pero la condición falla, comprueba los detalles de solución de problemas de cada nivel de acceso individual que se enumera en la condición, si la condición solo consiste en niveles de acceso conectados con el operador lógico OR.