Autenticare gli utenti con Account Google
Questa guida rapida illustra come abilitare Identity-Aware Proxy (IAP) per proteggere un'applicazione dell'ambiente standard o flessibile di App Engine e concedere l'accesso agli utenti con Account Google.
Se prevedi di pubblicare risorse da una rete CDN (Content Delivery Network), consulta la guida alle best practice per la memorizzazione nella cache per informazioni importanti.
Quando un'applicazione App Engine è composta da più servizi, puoi configurare autorizzazioni IAP diverse tra i servizi, ad esempio rendere pubblicamente accessibili solo alcuni servizi accessibili pubblicamente mantenendo protetti gli altri.
Prima di iniziare
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
-
Per abilitare IAP per App Engine, devi configurare l' istanza di App Engine. Se non hai ancora configurato l'istanza di App Engine, consulta Eseguire il deployment su App Engine per una procedura completa.
Per impostazione predefinita, IAP utilizza un client OAuth gestito da Google, che richiede che il progetto appartenga a un'organizzazione e consente l'accesso agli utenti interni.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per autenticare gli utenti con Account Google, chiedi all'amministratore di concederti il ruolo IAM Amministratore delle policy IAP (roles/iap.policyAdmin) nel tuo progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Abilitare IAP
Console
Se il tuo progetto non appartiene a un'organizzazione, devi utilizzare credenziali OAuth personalizzate.
如果您尚未配置项目的 OAuth 权限请求页面,系统会提示您进行配置。如需配置 OAuth 权限请求页面,请参阅设置 OAuth 权限请求页面。
设置 IAP 访问权限
-
转到 Identity-Aware Proxy 页面。
转到 Identity-Aware Proxy 页面 - 选择要使用 IAP 保护的项目。
- 选中您要授予访问权限的资源旁边的复选框。
- 在右侧面板上,点击添加主账号。
-
在显示的添加主账号对话框中,输入群组或个人(应拥有项目的 IAP-secured Web App User 角色)的电子邮件地址。
以下种类的主账号可以具有此角色:
- Google 账号:user@gmail.com
- Google 网站论坛:admins@googlegroups.com
- 服务账号:server@example.
- Google Workspace 网域:example.com
请务必添加您有权访问的 Google 账号。
- 从角色下拉列表中选择 Cloud IAP > 受 IAP 保护的网页应用用户。
- 点击保存。
启用 IAP
-
在 Identity-Aware Proxy 页面上的应用下,找到您要限制访问的应用。如需为某资源开启 IAP,请
-
在出现的开启 IAP 窗口中,点击开启以确认您想用 IAP 保护资源。 开启 IAP 后,对于与负载均衡器的所有连接,它都要求提供登录凭证。
只有在项目中具有 IAP-Secured Web 应用 User (
roles/iap.httpsResourceAccessor) 角色的主体才能获得访问权限。
gcloud
Prima di configurare il progetto e IAP, devi disporre di una versione aggiornata di gcloud CLI. Per istruzioni su come installare gcloud CLI, vedi Installa gcloud CLI.
-
Per l'autenticazione, utilizza Google Cloud CLI ed esegui il seguente comando.
gcloud auth login - Fai clic sull'URL visualizzato e accedi.
- Dopo aver eseguito l'accesso, copia il codice di verifica visualizzato e incollalo nella riga di comando.
-
Esegui questo comando per specificare il progetto che contiene le applicazioni che vuoi proteggere con IAP.
gcloud config set project PROJECT_ID -
Per abilitare IAP, esegui questo comando.
gcloud iap web enable --resource-type=app-engine --versions=version -
Aggiungi al progetto le entità che devono avere il ruolo Utente app web con protezione IAP.
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL_IDENTIFIER \ --role=roles/iap.httpsResourceAccessor- Sostituisci PROJECT_ID con l'ID progetto.
- Sostituisci PRINCIPAL_IDENTIFIER con i principal necessari. Può trattarsi di un tipo di dominio, gruppo, service account o utente. Ad esempio,
user:myemail@example.com.
Dopo aver abilitato IAP, puoi utilizzare gcloud CLI per modificare il criterio di accesso IAP utilizzando il ruolo IAM roles/iap.httpsResourceAccessor. Scopri di più sulla
gestione di ruoli e autorizzazioni.
API
运行以下命令以准备
settings.json文件。cat << EOF > settings.json { "iap": { "enabled":true } } EOF运行以下命令以启用 IAP。
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d @settings.json \ "https://appengine.googleapis.com/v1/apps/PROJECT_ID?updateMask=iap"
启用 IAP 后,您可以使用 Google Cloud CLI 通过 IAM 角色 roles/iap.httpsResourceAccessor 修改 IAP 访问权限政策。详细了解如何管理角色和权限。
Puoi abilitare IAP su un servizio App Engine all'interno del tuo progetto. Per rendere pubblicamente accessibili alcuni servizi e richiedere l'autenticazione per altri, puoi utilizzare livelli di accesso diversi tra i servizi.
Per saperne di più, consulta Gestire l'accesso con IAP.
Per rendere pubblicamente accessibili i servizi, concedi il ruolo Utente applicazione web con protezione IAP a allAuthenticatedUsers.
Testare l'autenticazione utente
Dopo aver concesso il ruolo, le entità possono accedere all'app autenticandosi con IAP. Accedi all'URL dell'app da un Account Google a cui è stato concesso il ruolo Utente applicazione web con protezione IAP (
roles/iap.httpsResourceAccessor).Per testare l'accesso, apri una finestra Incognito in Chrome, accedi all'URL dell'app e accedi quando richiesto. Gli utenti a cui è stato concesso il ruolo Utente applicazione web con protezione IAP (
roles/iap.httpsResourceAccessor) e che hanno eseguito l'autenticazione possono accedere all'app. Gli utenti a cui non è stato concesso il ruolo richiesto o che non riescono ad autenticarsi non possono accedere all' app.
Passaggi successivi
- Scopri come ottenere l'identità dell'utente e sviluppare la tua app App Engine.