Reautenticación de IAP

La reautenticación de IAP permite que los propietarios o Google Cloud administradores de servicios y aplicaciones requieran que los usuarios finales autenticados se vuelvan a autenticar después de un período específico cuando accedan a un servicio o una aplicación protegidos por IAP y limiten el tiempo que un usuario puede acceder a un servicio o una aplicación protegidos por IAP antes de que se requiera la autenticación.

La reautenticación de IAP (o reautenticación) está diseñada para aplicar políticas de reautenticación para servicios y aplicaciones (o apps) protegidos por IAP. Con este servicio, puedes aplicar políticas de reautenticación para servicios y aplicaciones fundamentales que manejan información confidencial. Por ejemplo, puedes especificar que los usuarios que acceden a una aplicación de RR.HH. fundamental se vuelvan a autenticar cada hora con un segundo factor.

Métodos de reautenticación compatibles

Puedes usar los siguientes métodos para administrar la configuración de reautenticación:

  • Acceso: Los usuarios finales se vuelven a autenticar con sus credenciales de acceso.
  • Llave segura: Los usuarios finales se vuelven a autenticar con su llave de seguridad configurada.
  • Segundos factores inscritos: Los usuarios finales se vuelven a autenticar con uno de sus segundos factores inscritos.

Para obtener más información, consulta IapSettings.

Configura una política de reautenticación

Los reauthSettings se incluyen como parte de IapSettings y se pueden establecer en cualquier tipo de recurso de la jerarquía de recursos. Puedes establecer reauthSettings a nivel de la organización, la carpeta, el proyecto o el servicio para aplicar restricciones. Por ejemplo, puedes limitar la duración de la sesión a un máximo de una hora para todas las aplicaciones de una organización o para una aplicación específica.

Existen dos tipos de políticas que puedes usar para configurar la reautenticación:

  • Mínimo: Si el tipo de política se establece en MINIMUM en un recurso, como una organización, cuando se evalúa la configuración de reautenticación en el recurso de nivel inferior, como una carpeta, se combinan los dos parámetros de configuración. Si el recurso de nivel inferior no tiene parámetros de configuración de reautenticación, el resultado de la combinación es la configuración no vacía del recurso de nivel superior. De lo contrario, la combinación toma la duración de sesión más corta y el método de reautenticación de mayor prioridad entre los dos recursos. El tipo de política combinada resultante se establece en MINIMUM.

  • Predeterminado: Si el tipo de política se establece como DEFAULT en un recurso, como una organización, cuando se evalúa la configuración de reautenticación en el recurso de nivel inferior, como una carpeta, se usa la configuración del recurso de nivel inferior si está configurada; de lo contrario, se aplica la configuración de reautenticación del recurso de nivel superior.

Para ambos tipos de políticas, se repite el proceso de evaluación para determinar la reauthSettings del servicio o la aplicación de destino. La reauthSettings efectiva en cualquier nivel se determina de la siguiente manera:

  • Herencia: La configuración del recurso de nivel superior se combina con la configuración del recurso de nivel inferior.

  • Reglas de combinación: Si el recurso de nivel inferior no tiene parámetros de configuración de reautenticación específicos, hereda la configuración del nivel superior.

    Si ambos niveles tienen reauthSettings, el resultado combinado usa lo siguiente:

    • La duración de sesión más corta
    • El método de reautenticación con la mayor prioridad
    • La prioridad es Secure key (más alta), Enrolled second factors (media) y Login (más baja).
  • Tipo de política resultante: El tipo de política de la configuración combinada es MINIMUM.

En los siguientes ejemplos, se muestra la configuración antes y después de la evaluación. Durante la evaluación, se combinan reauthSettings de la carpeta y la organización, lo que da como resultado el cambio del tipo de política de la carpeta a MINIMUM. Luego, se usa la configuración combinada para combinarla con la reauthSettings del servicio o la aplicación.

Organización IapSettings:

accessSettings:
  reauthSettings:
    method: "ENROLLED_SECOND_FACTORS"
    maxAge: "3600s"
    policyType: "MINIMUM"

Carpeta IapSettings:

accessSettings:
  reauthSettings:
    method: "LOGIN"
    maxAge: "1200s"
    policyType: "DEFAULT"

Servicio o aplicación IapSettings:

accessSettings:
  reauthSettings:
    method: "SECURE_KEY"
    maxAge: "7200s"
    policyType: "DEFAULT"

Configuración después de la combinación:

Organización IapSettings:

accessSettings:
  reauthSettings:
    method: "ENROLLED_SECOND_FACTORS"
    maxAge: "3600s"
    policyType: "MINIMUM"

Carpeta IapSettings:

accessSettings:
  reauthSettings:
    method: "ENROLLED_SECOND_FACTORS"
    maxAge: "1200s"
    policyType: "MINIMUM"

Servicio o aplicación IapSettings:

accessSettings:
  reauthSettings:
    method: "SECURE_KEY"
    maxAge: "1200s"
    policyType: "MINIMUM"

En este ejemplo, si el tipo de política de cada recurso se establece en DEFAULT, se usa la reauthSettings del servicio o la aplicación.

MaxAge

Usa el parámetro maxAge para especificar la frecuencia con la que un usuario final debe volver a autenticarse, indicado en segundos. Por ejemplo, para establecer una política de reautenticación de una hora, establece los segundos en 3600, como se muestra en el siguiente ejemplo:

accessSettings:
  reauthSettings:
    method: "LOGIN"
    maxAge: "3600s"
    policyType: "MINIMUM"

El valor mínimo para maxAge es de 300 segundos o cinco minutos.

Para establecer una política de reautenticación, completa los siguientes pasos.

Console

  1. Ve a la página de IAP.
    Ir a la página Identity-Aware Proxy
  2. Selecciona un proyecto y, luego, el recurso en el que deseas establecer una política de reautenticación.

  3. Abre la Configuración del recurso y, en Política de reautenticación, selecciona Configurar reautenticación.

  4. Especifica la configuración de reautenticación y, luego, haz clic en Guardar.

gcloud

Puedes establecer una política de reautenticación en recursos y servicios a nivel de la organización, el proyecto y la carpeta. A continuación, se incluyen algunos ejemplos de comandos para establecer una política de reautenticación.

Para obtener más información, consulta gcloud iap settings set.

Ejecuta el siguiente comando:

gcloud iap settings set SETTING_FILE [--organization=ORGANIZATION --folder=FOLDER --project=/PROJECT --resource-type=RESOURCE_TYPE --service=SERVICE --version=VERSION

Para establecer una política de reautenticación en los recursos de una organización, ejecuta el siguiente comando:

gcloud iap settings set SETTING_FILE --organization=ORGANIZATION

Para establecer una política de reautenticación en los recursos de una carpeta, ejecuta el siguiente comando:

gcloud iap settings set SETTING_FILE --folder=FOLDER

Para establecer una política de reautenticación en todos los recursos de tipo web de un proyecto, ejecuta el siguiente comando:

gcloud iap settings set SETTING_FILE --project=PROJECT --resource-type=iap_web

Para establecer una política de reautenticación en un servicio de App Engine dentro de un proyecto, ejecuta el siguiente comando:

gcloud iap settings set SETTING_FILE --project=PROJECT --resource-type=app-engine --service=SERVICE

En el ejemplo anterior, SETTING_FILE es:

accessSettings:
  reauthSettings:
    method: "LOGIN"
    maxAge: "3600s"
    policyType: "MINIMUM"

Reemplaza lo siguiente:

  • FOLDER: El ID de la carpeta.
  • ORGANIZATION: El ID de la organización.
  • PROJECT: El ID del proyecto
  • RESOURCE_TYPE: El tipo de recurso de IAP. Debe ser app-engine, iap_web, compute, organization o folder.
  • SERVICE: El nombre del servicio (opcional cuando resource-type se establece en compute o app-engine).
  • VERSION: El nombre de la versión (no se aplica al tipo de recurso compute y es opcional para el tipo de recurso app-engine).

API

Ejecuta el siguiente comando para preparar un archivo iap_settings.json. Actualiza los valores según sea necesario.

cat << EOF > iap_settings.json
{
  "access_settings": {
      "reauth_settings": {
            "method": "LOGIN",
            "maxAge": "300s",
            "policy_type": "DEFAULT"
        }
    }
}
EOF

Ejecuta el comando gcloud iap settings get para obtener el nombre del recurso. Copia el campo name de la salida. Necesitarás el nombre en el siguiente paso.

gcloud iap settings get [--organization=ORGANIZATION --folder=FOLDER --project=/PROJECT --resource-type=RESOURCE_TYPE --service=SERVICE --version=VERSION]

Reemplaza RESOURCE_NAME en el siguiente comando por el nombre del paso anterior. Se actualizará IapSettings.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d @iap_settings.json \
"https://iap.googleapis.com/v1/RESOURCE_NAME:iapSettings?updateMask=iapSettings.accessSettings.reauthSettings"

Información sobre las credenciales de reautenticación

Después de una reautenticación exitosa, IAP crea una cookie en el navegador del usuario final. Para evitar la reautenticación frecuente de aplicaciones en el mismo dominio, la cookie se establece en el dominio privado de nivel superior y es válida para todo ese dominio.

Por ejemplo, foo.example.com es un recurso protegido por IAP y tiene una política de reautenticación de IAP. Después de una reautenticación exitosa, IAP establece una cookie en example.com, ya que ese es el dominio privado de nivel superior. Las aplicaciones del mismo dominio privado de nivel superior, como bar.example.com, usan las mismas credenciales de reautenticación y no le solicitan al usuario que se vuelva a autenticar siempre que las credenciales sean válidas.

En el caso de las URLs como myapp.appspot.com, appspot.com es un dominio público , por lo tanto, el dominio privado de nivel superior es myapp.appspot.com.

Limitaciones conocidas

  • La reautenticación solo se admite en los flujos de navegadores. No se admite el acceso programático a cuentas de usuario. Por ejemplo, las aplicaciones para dispositivos móviles y computadoras de escritorio no pueden volver a autenticar usuarios porque los recursos que requieren reautenticación son inaccesibles para estas aplicaciones.
  • IAP-TCP y las cuentas de servicio están exentos de los requisitos de reautenticación.
  • La reautenticación no funciona con el tipo de miembro de Identity and Access Management allUsers.
  • Las identidades externas, como OAuth y SAML, no son compatibles con la reautenticación.
  • Las identidades de la federación de identidades de personal no son compatibles con la reautenticación de IAP.