Se usó la API de Cloud Translation para traducir esta página.

Autentica usuarios con identidades externas

En esta guía de inicio rápido, se muestra cómo proteger una aplicación con Identity-Aware Proxy (IAP) y las identidades externas. Cuando combinas IAP con Identity Platform, puedes autenticar usuarios con una amplia variedad de proveedores de identidad, como OAuth, SAML y OIDC, además de las Cuentas de Google.

En esta guía de inicio rápido, protegerás una aplicación de App Engine de muestra con la autenticación de Facebook.

Antes de comenzar

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Make sure that billing is enabled for your Google Cloud project.
Install the Google Cloud CLI, then initialize it by running the following command:
```
gcloud init
```
Inicializa App Engine para tu proyecto:
```
gcloud app create --project=project-id
```
Instala Git.
Instala una versión actual de Node.js.
Instala la herramienta de línea de comandos de Firebase:
```
npm install -g firebase-tools
```

Habilita las API

Primero, habilita Identity Platform:

Ve a la página Marketplace de Identity Platform en la consola de Google Cloud.

Ir a la página Marketplace de Identity Platform
Haz clic en Habilitar Identity Platform. La página de Identity Platform aparece en la consola de Google Cloud.

Luego, habilita IAP:

Ve a la página IAP en la consola de Google Cloud.

Ir a la página de IAP
Selecciona el mismo proyecto que usaste para Identity Platform. No se admite el uso de proyectos diferentes.
Haz clic en Habilitar API.

Descarga y, luego, implementa el código de muestra

El código de esta guía de inicio rápido tiene dos componentes: una aplicación de cliente y una aplicación de autenticación.

La aplicación de cliente está protegida con IAP. Cuando recibe una solicitud de un usuario no autenticado, redirecciona la solicitud a la aplicación de autenticación para verificar la identidad del usuario. Si el usuario accede correctamente, la aplicación de autenticación responde con un token web JSON (JWT). A modo de demostración, la aplicación de cliente muestra el JWT.

Primero, descarga el código y, luego, implementa la aplicación de cliente:

Descarga el código de muestra:

git clone https://github.com/GoogleCloudPlatform/iap-gcip-web-toolkit.git

Cambia al directorio de la aplicación de cliente:
```
cd iap-gcip-web-toolkit/sample/app
```
Instala las dependencias:
```
npm install
```
Implementa la aplicación de cliente en App Engine:
```
npm run deploy
```
La aplicación de cliente se inicia en la URL:
```
https://[PROJECT-ID].appspot.com
```

A continuación, implementa la aplicación de autenticación:

Cambia al directorio de la aplicación de autenticación:
```
cd ../authui-firebaseui
```
Instala las dependencias:
```
npm install
```
Configura la aplicación de autenticación para usar Firebase Hosting. Especifica el ID del proyecto de Google Cloud que contiene la app cliente protegida por IAP:
```
firebase use project-id
```
Implementa la app:
```
npm run deploy
```
La aplicación de autenticación se inicia en la URL:
```
https://[PROJECT-ID].firebaseapp.com
```

Implementaste las aplicaciones de cliente y de autenticación. El siguiente paso es configurar Identity Platform y, también, IAP.

Configura Identity Platform

IAP usa Identity Platform para autenticar identidades externas. En esta guía de inicio rápido, se usa Facebook como ejemplo, pero Identity Platform es compatible con una amplia variedad de proveedores de identidad.

Crea una aplicación de Facebook

Para autenticar usuarios con Facebook, necesitas un ID de aplicación y un secreto de aplicación.

Accede a Facebook para desarrolladores. Si aún no tienes una cuenta de Facebook, deberás crear una.
Ve a la página de aplicaciones de Facebook.
Haz clic en Agregar una nueva aplicación.
En el menú de la izquierda, selecciona Configuración > Básico.
En el cuadro URL de la Política de Privacidad, ingresa una URL válida. Si implementas la aplicación en producción más adelante, puedes actualizar la URL para que apunte a tu Política de Privacidad.
Toma nota de tu ID de aplicación y el secreto de la aplicación. Los necesitarás en la siguiente sección.

Agrega Facebook como proveedor de identidad

Configura Identity Platform a fin de usar Facebook para la autenticación:

Ve a la página Proveedores de identidad en la consola de Google Cloud.

Ir a la página Proveedores de identidad
Haz clic en Agregar un proveedor.
Selecciona Facebook de la lista de proveedores.
Ingresa el ID de la aplicación y el secreto de la aplicación que obtuviste en la sección anterior.
Haz clic en Guardar.

Configura el URI de redireccionamiento de OAuth

Cuando Facebook termina de procesar una solicitud desde la aplicación de autenticación, necesita un URI al que redireccionar.

Vuelve a la página de aplicaciones de Facebook y selecciona tu aplicación.
En el menú de la izquierda, haz clic en Productos.
Busca el producto Acceso con Facebook y haz clic en Configurar.
En el menú de navegación de la izquierda, selecciona Configuración (no es necesario completar el flujo de la guía de inicio rápido guiado).
En el cuadro URI de redireccionamiento de OAuth válido, ingresa el URI de redireccionamiento:
```
https://project-id.firebaseapp.com/__/auth/handler
```
También puedes encontrar este URI en la página de configuración del proveedor de Identity Platform.
Haz clic en Guardar cambios.

¡Terminaste de configurar Identity Platform! Ahora puedes configurar IAP para usarlo en la autenticación.

Habilita IAP para usar identidades externas

Ve a la página de IAP en la consola de Google Cloud.

Ir a la página de IAP
Haz clic en la pestaña APPLICATIONS.
Selecciona la aplicación de App Engine de muestra que implementaste anteriormente. La URL en la categoría Publicada (Published) debe ser similar a la siguiente:
```
https://project-id.appspot.com
```
En la columna IAP, activa la opción Activado (On).
En el panel lateral, haz clic en Iniciar para Usar identidades externas para la autorización.
En la página de acceso, selecciona La ingresaré por mi cuenta.

Nota: IAP también puede crear una página de acceso para ti. En esta guía de inicio rápido, se proporcionan aplicaciones de cliente y autenticación de muestra, pero, si estás compilando tus apps desde cero, permitir que IAP cree la página de acceso te puede ayudar a comenzar más rápido.
En el campo URL de autenticación (Authentication URL), ingresa la URL de la aplicación de autenticación. Debe verse de la siguiente manera:
```
https://project-id.firebaseapp.com/
```
Después de ingresar la URL, la consola de Google Cloud agrega automáticamente tu clave de API.
Marca la casilla con el nombre del proyecto. Debe tener Facebook como un proveedor de identidad.
Haz clic en Guardar.

Terminaste de configurar IAP.

Prueba la autenticación de usuarios

Para probar que IAP protege tu app y autentica a los usuarios con Facebook, haz lo siguiente:

Ve a la aplicación de cliente de App Engine en tu navegador:
```
https://project-id.appspot.com
```
Después de una breve pantalla de carga, se te redireccionará a la página de acceso de Identity Platform.
Sigue las indicaciones en pantalla para autenticar con Facebook.
Se te debería redireccionar a la aplicación de cliente, que permitirá ver el JWT que muestra Identity Platform.

Para salir por completo, debes salir de la app de ejemplo que creaste y de Facebook. Debes salir de ambas apps porque Firebase establece una sesión con Facebook que es válida por una hora. Para obtener más información, consulta Administra sesiones de usuario.

¡Felicitaciones! Implementaste correctamente una aplicación en App Engine y la protegiste con IAP y las identidades externas.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

Se borra todo en el proyecto. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URL que utilizan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varias infraestructuras, instructivos y guías de inicio rápido la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

Además, es posible que desees borrar la aplicación de Facebook que creaste.

¿Qué sigue?

Personaliza tu IU de autenticación con FirebaseUI o crea una IU personalizada desde cero.
Obtén más información sobre cómo configurar proveedores de identidad con Identity Platform.
Obtén información sobre cómo crear sistemas aislados de usuarios únicos y configuraciones con multiusuario de Identity Platform.