ID regione
REGION_ID è un codice abbreviato assegnato da Google
in base alla regione selezionata al momento della creazione dell'app. Il codice non
corrispondono a un paese o a una provincia, anche se potrebbero essere visualizzati alcuni ID regione
in modo simile ai codici paese e provincia di uso comune. Per le app create dopo il giorno
Febbraio 2020, REGION_ID.r è incluso in
URL di App Engine. Per le app esistenti create prima di questa data,
l'ID regione è facoltativo nell'URL.
Scopri di più sugli ID regione.
L'API Users consente a un'applicazione di:
- Rileva se l'utente corrente ha eseguito l'accesso.
- Reindirizza l'utente alla pagina di accesso appropriata per accedere.
- Chiedi all'utente dell'applicazione di creare un nuovo Account Google se non lo fa. ne hai già uno.
Mentre un utente ha eseguito l'accesso all'applicazione, l'app può accedere ai suoi . L'app può anche rilevare se l'utente corrente è un amministratore (chiamato anche "utente amministratore"), semplificare l'implementazione delle aree dell'app riservate agli amministratori.
Autenticazione degli utenti
L'esempio seguente saluta un utente che ha eseguito l'accesso all'app con un messaggio personalizzato e un link per uscire. Se l'utente non ha eseguito l'accesso, offre un link alla pagina di accesso per gli Account Google.
Applicazione dell'accesso e dell'accesso amministrativo con app.yaml
Se disponi di pagine che richiedono all'utente di eseguire l'accesso per poter
puoi imporre l'accesso in app.yaml
file.
La configurazione del gestore può anche richiedere che l'utente sia un amministratore registrato dell'applicazione; ovvero l'utente deve disporre Visualizzatore, Editor, Proprietario o Amministratore App Engine role. In questo modo è facile creare sezioni del sito riservate agli amministratori, senza dover implementare un meccanismo di autorizzazione separato.
Per scoprire come configurare l'autenticazione per gli URL, scopri come richiedere l'accesso o
lo stato di amministratore nel
Riferimento app.yaml.
Opzioni di autenticazione
La tua app può autenticare gli utenti utilizzando una delle seguenti opzioni:
- Un account Google
- Un account nel tuo dominio Google Workspace.
Scelta di un'opzione di autenticazione
Dopo aver creato l'app, puoi scegliere l'opzione di autenticazione che vuoi per gli utilizzi odierni. Per impostazione predefinita, l'app utilizzerà gli Account Google per l'autenticazione. Per scegliere in un'altra opzione, ad esempio per il dominio Google Workspace, vai alla pagina impostazioni per il tuo progetto nella console Google Cloud e fai clic su Modifica. Nella sezione Autenticazione Google seleziona il tipo di autenticazione desiderato e fai clic su Salva.
Accesso e disconnessione
Un'applicazione è in grado di rilevare se un utente ha eseguito l'accesso all'app con il tuo l'opzione di autenticazione scelta dall'app. Se l'utente non ha eseguito l'accesso, l'app può Indirizzare l'utente agli Account Google per accedere o creare un nuovo Account Google. L'app ottiene l'URL della pagina di accesso chiamando un metodo dell'API Users. L'app può visualizzare questo URL sotto forma di link oppure può inviare un reindirizzamento HTTP al URL quando l'utente visita una pagina che richiede l'autenticazione.
Se la tua app utilizza Account Google o Google Workspace per l'autenticazione, il nome della tua applicazione viene visualizzato nella pagina di accesso quando l'utente accede alla tua applicazione. Il nome mostrato è il nome dell'applicazione che hai specificato durante la registrazione dell'applicazione. Puoi modificare questo nome nella finestra Applicazione campo name della console Google Cloud pagina Credenziali.
Una volta che l'utente ha eseguito l'accesso o creato un Account Google, viene reindirizzato alla tua applicazione. L'app fornisce l'URL di reindirizzamento al metodo genera l'URL di accesso.
L'API Users include un metodo per generare un URL per uscire dall'app. L'URL di uscita annulla l'autenticazione dell'utente dall'app, quindi ti reindirizza a l'URL dell'app senza visualizzare nulla.
Un utente non ha effettuato l'accesso a un'applicazione finché non gli viene richiesto di farlo dal app e inserire l'indirizzo email e la password dell'account. Ciò vale anche se l'utente ha eseguito l'accesso ad altre applicazioni utilizzando il proprio account Google.
Accesso ai dati dell'account
Quando un utente esegue l'accesso a un'app, questa può accedere all'email dell'account. per ogni richiesta che l'utente invia all'app. L'app può inoltre accedere a ID utente che identifica l'utente in modo univoco, anche se cambia l'indirizzo email per il proprio account.
L'app può inoltre determinare se l'utente corrente è un amministratore dell'account dell'app. Un utente amministratore è qualsiasi utente con visualizzatore, editor, proprietario o app Ruolo Amministratore motore. Puoi usare questa funzione per a creare funzionalità amministrative per l'app, anche se non esegui l'autenticazione utenti. Le API Go, Java, PHP e Python semplificano la configurazione degli URL "solo amministratore".
Account Google e server di sviluppo
Il server di sviluppo simula il sistema degli Account Google utilizzando un falso schermata di accesso. Quando la tua applicazione chiama l'API Users per ottenere l'URL della schermata di accesso, l'API restituisce uno speciale URL del server di sviluppo che richiede per un indirizzo email, ma non per una password. Puoi digitare qualsiasi indirizzo email e l'app si comporterà come se avessi effettuato l'accesso a un account questo indirizzo.
La falsa schermata di accesso include anche una casella di controllo che indica se l'account falso è un amministratore; ovvero se l'account ha Ruolo Visualizzatore, Editor, Proprietario o Amministratore App Engine. Se selezioni questa casella, l'app si comporterà come se avessi eseguito l'accesso utilizzando una con un account amministratore di livello inferiore.
Allo stesso modo, l'API Users restituisce un URL di uscita che annulla l'accesso fasullo.