az webapp auth

Note

Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.

Gestire l'autenticazione e l'autorizzazione dell'app Web. Per usare i comandi di autenticazione v2, eseguire "az extension add --name authV2" per aggiungere l'estensione dell'interfaccia della riga di comando di authV2.

Comandi

Nome	Descrizione	Tipo	Status
az webapp auth apple	Gestire l'autenticazione e l'autorizzazione dell'app Web del provider di identità Apple.	Extension	GA
az webapp auth apple show	Mostra le impostazioni di autenticazione per il provider di identità Apple.	Extension	GA
az webapp auth apple update	Aggiornare l'ID client e il segreto client per il provider di identità Apple.	Extension	GA
az webapp auth config-version	Gestire lo stato della versione di configurazione per le impostazioni di autenticazione per l'app Web. La versione 1 della configurazione fa riferimento agli endpoint /authSettings, mentre v2 fa riferimento agli endpoint /authSettingsV2.	Extension	GA
az webapp auth config-version revert	Ripristina la versione di configurazione delle impostazioni di autenticazione per l'app Web dalla versione 2 alla versione 1 (classica).	Extension	GA
az webapp auth config-version show	Visualizzare la versione di configurazione delle impostazioni di autenticazione per l'app Web. La versione 1 della configurazione fa riferimento agli endpoint /authSettings, mentre v2 fa riferimento agli endpoint /authSettingsV2.	Extension	GA
az webapp auth config-version upgrade	Aggiorna la versione di configurazione delle impostazioni di autenticazione per l'app Web dalla versione 1 (classica) alla versione 2.	Extension	GA
az webapp auth facebook	Gestire l'autenticazione e l'autorizzazione dell'app Web del provider di identità Facebook.	Extension	GA
az webapp auth facebook show	Mostra le impostazioni di autenticazione per il provider di identità di Facebook.	Extension	GA
az webapp auth facebook update	Aggiornare l'ID app e il segreto dell'app per il provider di identità Facebook.	Extension	GA
az webapp auth github	Gestire l'autenticazione e l'autorizzazione dell'app Web del provider di identità GitHub.	Extension	GA
az webapp auth github show	Visualizzare le impostazioni di autenticazione per il provider di identità GitHub.	Extension	GA
az webapp auth github update	Aggiornare l'ID client e il segreto client per il provider di identità GitHub.	Extension	GA
az webapp auth google	Gestire l'autenticazione e l'autorizzazione dell'app Web del provider di identità Google.	Extension	GA
az webapp auth google show	Mostra le impostazioni di autenticazione per il provider di identità Google.	Extension	GA
az webapp auth google update	Aggiornare l'ID client e il segreto client per il provider di identità Google.	Extension	GA
az webapp auth microsoft	Gestire l'autenticazione e l'autorizzazione dell'app Web del provider di identità Microsoft.	Extension	GA
az webapp auth microsoft show	Visualizzare le impostazioni di autenticazione per il provider di identità di Azure Active Directory.	Extension	GA
az webapp auth microsoft update	Aggiornare l'ID client e il segreto client per il provider di identità di Azure Active Directory.	Extension	GA
az webapp auth openid-connect	Gestire l'autenticazione e l'autorizzazione dell'app Web dei provider di identità OpenID Connect personalizzati.	Extension	GA
az webapp auth openid-connect add	Configurare un nuovo provider di identità OpenID Connect personalizzato.	Extension	GA
az webapp auth openid-connect remove	Rimuove un provider di identità OpenID Connect personalizzato esistente.	Extension	GA
az webapp auth openid-connect show	Visualizzare le impostazioni di autenticazione per il provider di identità OpenID Connect personalizzato.	Extension	GA
az webapp auth openid-connect update	Aggiornare l'ID client e il nome dell'impostazione del segreto client per un provider di identità OpenID Connect personalizzato esistente.	Extension	GA
az webapp auth set	Imposta le impostazioni di autenticazione per l'app Web nel formato v2, sovrascrivendo le impostazioni esistenti.	Extension	GA
az webapp auth show	Mostra le impostazioni di autenticazione per l'app Web.	Core	GA
az webapp auth show (authV2 estensione)	Mostra le impostazioni di autenticazione per l'app Web nel formato v2.	Extension	GA
az webapp auth twitter	Gestire l'autenticazione e l'autorizzazione dell'app Web del provider di identità Twitter.	Extension	GA
az webapp auth twitter show	Mostra le impostazioni di autenticazione per il provider di identità Twitter.	Extension	GA
az webapp auth twitter update	Aggiornare la chiave consumer e il segreto consumer per il provider di identità Twitter.	Extension	GA
az webapp auth update	Aggiornare le impostazioni di autenticazione per l'app Web.	Core	GA
az webapp auth update (authV2 estensione)	Aggiornare le impostazioni di autenticazione per l'app Web nel formato v2.	Extension	GA

az webapp auth set

Imposta le impostazioni di autenticazione per l'app Web nel formato v2, sovrascrivendo le impostazioni esistenti.

az webapp auth set [--body]
                   [--ids]
                   [--name]
                   [--resource-group]
                   [--slot]
                   [--subscription]

Esempio

Impostare il file JSON salvato nel file auth.json come impostazioni di autenticazione per l'app Web, sovrascrivendo le impostazioni esistenti.

az webapp auth set -g myResourceGroup --name MyWebApp --body @auth.json

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--body -b

Rappresentazione JSON delle impostazioni di configurazione per la funzionalità Autenticazione/autorizzazione del servizio app di Azure V2.

--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--name -n

Nome dell'app Web.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--slot -s

Nome dello slot. Il valore predefinito è lo slot productions, se non specificato.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az webapp auth show

Mostra le impostazioni di autenticazione per l'app Web.

az webapp auth show [--ids]
                    [--name]
                    [--resource-group]
                    [--slot]
                    [--subscription]

Esempio

Mostra le impostazioni di autenticazione per l'app Web. (autogenerated)

az webapp auth show --name MyWebApp --resource-group MyResourceGroup

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--ids

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--name -n

Nome dell'app Web. Se non specificato, verrà generato un nome in modo casuale. È possibile configurare l'impostazione predefinita usando az configure --defaults web=<name>.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--slot -s

Nome dello slot. Il valore predefinito è lo slot productions, se non specificato.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az webapp auth show (authV2 estensione)

Mostra le impostazioni di autenticazione per l'app Web nel formato v2.

az webapp auth show [--ids]
                    [--name]
                    [--resource-group]
                    [--slot]
                    [--subscription]

Esempio

Visualizzare le impostazioni di autenticazione per l'app Web. (autogenerated)

az webapp auth show --name MyWebApp --resource-group MyResourceGroup

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--ids

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--name -n

Nome dell'app Web.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--slot -s

Nome dello slot. Il valore predefinito è lo slot productions, se non specificato.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az webapp auth update

Aggiornare le impostazioni di autenticazione per l'app Web.

az webapp auth update [--aad-allowed-token-audiences]
                      [--aad-client-id]
                      [--aad-client-secret]
                      [--aad-client-secret-certificate-thumbprint --thumbprint]
                      [--aad-token-issuer-url]
                      [--action {AllowAnonymous, LoginWithAzureActiveDirectory, LoginWithFacebook, LoginWithGoogle, LoginWithMicrosoftAccount, LoginWithTwitter}]
                      [--allowed-external-redirect-urls]
                      [--enabled {false, true}]
                      [--facebook-app-id]
                      [--facebook-app-secret]
                      [--facebook-oauth-scopes]
                      [--google-client-id]
                      [--google-client-secret]
                      [--google-oauth-scopes]
                      [--ids]
                      [--microsoft-account-client-id]
                      [--microsoft-account-client-secret]
                      [--microsoft-account-oauth-scopes]
                      [--name]
                      [--resource-group]
                      [--runtime-version]
                      [--slot]
                      [--subscription]
                      [--token-refresh-extension-hours]
                      [--token-store {false, true}]
                      [--twitter-consumer-key]
                      [--twitter-consumer-secret]

Esempio

Abilitare AAD abilitando l'autenticazione e impostando i parametri associati ad AAD. Il provider predefinito è impostato su AAD. Deve essere stata creata in anticipo un'entità servizio AAD.

az webapp auth update  -g myResourceGroup -n myUniqueApp --enabled true \
  --action LoginWithAzureActiveDirectory \
  --aad-allowed-token-audiences https://webapp_name.azurewebsites.net/.auth/login/aad/callback \
  --aad-client-id ecbacb08-df8b-450d-82b3-3fced03f2b27 --aad-client-secret very_secret_password \
  --aad-token-issuer-url https://sts.windows.net/54826b22-38d6-4fb2-bad9-b7983a3e9c5a/

Consenti l'autenticazione di Facebook impostando i parametri associati a FB e attivando ambiti di posta elettronica e profili pubblici; consenti utenti anonimi

az webapp auth update -g myResourceGroup -n myUniqueApp --action AllowAnonymous \
  --facebook-app-id my_fb_id --facebook-app-secret my_fb_secret \
  --facebook-oauth-scopes public_profile email

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--aad-allowed-token-audiences

Uno o più gruppi di destinatari dei token (delimitati da virgole).

Proprietà	Valore
Gruppo di parametri:	Azure Active Directory Arguments

--aad-client-id

ID applicazione per integrare l'account dell'organizzazione AAD Accedere all'app Web.

Proprietà	Valore
Gruppo di parametri:	Azure Active Directory Arguments

--aad-client-secret

Segreto dell'applicazione AAD.

Proprietà	Valore
Gruppo di parametri:	Azure Active Directory Arguments

--aad-client-secret-certificate-thumbprint --thumbprint

In alternativa a Segreto client AAD, identificazione personale di un certificato usato a scopo di firma.

Proprietà	Valore
Gruppo di parametri:	Azure Active Directory Arguments

--aad-token-issuer-url

Questo URL è disponibile nell'output JSON restituito dall'endpoint di Active Directory usando l'ID tenant. L'endpoint può essere sottoposto a query da az cloud show in "endpoints.activeDirectory". Il tenantID è reperibile usando az account show. Ottenere l'"autorità di certificazione" dal codice JSON in <active directory endpoint>/<tenantId>/.well-known/openid-configuration.

Proprietà	Valore
Gruppo di parametri:	Azure Active Directory Arguments

--action

Proprietà	Valore
Valori accettati:	AllowAnonymous, LoginWithAzureActiveDirectory, LoginWithFacebook, LoginWithGoogle, LoginWithMicrosoftAccount, LoginWithTwitter

--allowed-external-redirect-urls

Uno o più URL (delimitati da spazi).

--enabled

Proprietà	Valore
Valori accettati:	false, true

--facebook-app-id

ID applicazione per integrare l'accesso a Facebook nell'app Web.

Proprietà	Valore
Gruppo di parametri:	Facebook Arguments

--facebook-app-secret

Segreto client dell'applicazione Facebook.

Proprietà	Valore
Gruppo di parametri:	Facebook Arguments

--facebook-oauth-scopes

Uno o più ambiti di autenticazione di Facebook (delimitati da virgole).

Proprietà	Valore
Gruppo di parametri:	Facebook Arguments

--google-client-id

ID applicazione per integrare Google Sign-in nell'app Web.

Proprietà	Valore
Gruppo di parametri:	Google Arguments

--google-client-secret

Segreto client dell'applicazione Google.

Proprietà	Valore
Gruppo di parametri:	Google Arguments

--google-oauth-scopes

Uno o più ambiti di autenticazione di Google (delimitati da spazi).

Proprietà	Valore
Gruppo di parametri:	Google Arguments

--ids

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--microsoft-account-client-id

ID applicazione AAD V2 per integrare l'accesso all'account Microsoft nell'app Web.

Proprietà	Valore
Gruppo di parametri:	Microsoft Arguments

--microsoft-account-client-secret

Segreto client dell'applicazione AAD V2.

Proprietà	Valore
Gruppo di parametri:	Microsoft Arguments

--microsoft-account-oauth-scopes

Uno o più ambiti di autenticazione Microsoft (delimitati da virgole).

Proprietà	Valore
Gruppo di parametri:	Microsoft Arguments

--name -n

Nome dell'app Web. Se non specificato, verrà generato un nome in modo casuale. È possibile configurare l'impostazione predefinita usando az configure --defaults web=<name>.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--runtime-version

Versione di runtime della funzionalità Autenticazione/Autorizzazione in uso per l'app corrente.

--slot -s

Nome dello slot. Il valore predefinito è lo slot productions, se non specificato.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--token-refresh-extension-hours

Ore, deve essere formattato in un oggetto float.

--token-store

Usare l'archivio token del servizio app.

Proprietà	Valore
Valori accettati:	false, true

--twitter-consumer-key

ID applicazione per integrare l'accesso a Twitter nell'app Web.

Proprietà	Valore
Gruppo di parametri:	Twitter Arguments

--twitter-consumer-secret

Segreto client dell'applicazione Twitter.

Proprietà	Valore
Gruppo di parametri:	Twitter Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az webapp auth update (authV2 estensione)

Aggiornare le impostazioni di autenticazione per l'app Web nel formato v2.

az webapp auth update [--action --unauthenticated-client-action {AllowAnonymous, RedirectToLoginPage, Return401, Return403, Return404}]
                      [--config-file-path]
                      [--custom-host-header --proxy-custom-host-header]
                      [--custom-proto-header --proxy-custom-proto-header]
                      [--enable-token-store {false, true}]
                      [--enabled {false, true}]
                      [--excluded-paths]
                      [--ids]
                      [--name]
                      [--proxy-convention {Custom, NoProxy, Standard}]
                      [--redirect-provider]
                      [--require-https {false, true}]
                      [--resource-group]
                      [--runtime-version]
                      [--set]
                      [--slot]
                      [--subscription]

Esempio

Aggiornare l'ID client del provider AAD già configurato

az webapp auth update -g myResourceGroup --name MyWebApp --set identityProviders.azureActiveDirectory.registration.clientId=my-client-id

Aggiungere la versione di runtime dell'app alla versione 1.4.7

az webapp auth update -g myResourceGroup --name MyWebApp --runtime-version 1.4.7

Configurare l'app con l'autenticazione basata su file impostando il percorso del file di configurazione

az webapp auth update -g myResourceGroup --name MyWebApp --config-file-path D:\home\site\wwwroot\auth.json

Configurare l'app per consentire alle richieste non autenticate di raggiungere l'app.

az webapp auth update -g myResourceGroup --name MyWebApp --unauthenticated-client-action AllowAnonymous

Configurare l'app per reindirizzare le richieste non autenticate al provider Facebook

az webapp auth update -g myResourceGroup --name MyWebApp --redirect-provider Facebook

Configurare l'app per l'ascolto delle intestazioni di inoltro X-FORWARDED-HOST e X-FORWARDED-PROTO

az webapp auth update -g myResourceGroup --name MyWebApp --proxy-convention Standard

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--action --unauthenticated-client-action

Azione da eseguire quando un client non autenticato tenta di accedere all'app.

Proprietà	Valore
Valori accettati:	AllowAnonymous, RedirectToLoginPage, Return401, Return403, Return404

--config-file-path

Percorso del file di configurazione contenente le impostazioni di autenticazione se provengono da un file.

--custom-host-header --proxy-custom-host-header

Nome dell'intestazione contenente l'host della richiesta.

--custom-proto-header --proxy-custom-proto-header

Nome dell'intestazione contenente lo schema della richiesta.

--enable-token-store

True per archiviare in modo permanente token di sicurezza specifici della piattaforma ottenuti durante i flussi di accesso; in caso contrario, false.

Proprietà	Valore
Valori accettati:	false, true

--enabled

True se la funzionalità Autenticazione/Autorizzazione è abilitata per l'app corrente; in caso contrario, false.

Proprietà	Valore
Valori accettati:	false, true

--excluded-paths

Elenco di percorsi che devono essere esclusi dalle regole di autenticazione.

--ids

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--name -n

Nome dell'app Web.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--proxy-convention

Convenzione utilizzata per determinare l'URL della richiesta effettuata.

Proprietà	Valore
Valori accettati:	Custom, NoProxy, Standard

--redirect-provider

Provider di autenticazione predefinito da usare quando sono configurati più provider.

--require-https

False se le risposte di autenticazione/autorizzazione non hanno lo schema HTTPS consentito; in caso contrario, true.

Proprietà	Valore
Valori accettati:	false, true

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--runtime-version

RuntimeVersion della funzionalità Autenticazione/Autorizzazione in uso per l'app corrente.

--set

Valore di un campo specifico all'interno delle impostazioni di configurazione per la funzionalità Autenticazione/autorizzazione del servizio app di Azure V2.

--slot -s

Nome dello slot. Il valore predefinito è lo slot productions, se non specificato.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

az webapp auth

Comandi

az webapp auth set

Esempio

Parametri facoltativi

az webapp auth show

Esempio

Parametri facoltativi

az webapp auth show (authV2 estensione)

Esempio

Parametri facoltativi

az webapp auth update

Esempio

Parametri facoltativi

az webapp auth update (authV2 estensione)

Esempio

Parametri facoltativi

Commenti e suggerimenti