Web Apps - Update Auth Settings
Description de Mises à jour des paramètres d’authentification/d’autorisation associés à l’application web.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/authsettings?api-version=2025-03-01
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
name
|
path | True |
string |
Nom de l’application web. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+[^\.]$ |
Nom du groupe de ressources auquel appartient la ressource. |
|
subscription
|
path | True |
string |
Votre ID d’abonnement Azure. Il s’agit d’une chaîne au format GUID (par exemple, 000000000-0000-0000-0000-00000000000000000000000). |
|
api-version
|
query | True |
string |
Version de l’API |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| kind |
string |
Type de ressource. |
| properties.aadClaimsAuthorization |
string |
Obtient une chaîne JSON contenant les paramètres Acl Azure AD. |
| properties.additionalLoginParams |
string[] |
Paramètres de connexion à envoyer au point de terminaison d’autorisation OpenID Connect lorsqu’un utilisateur se connecte. Chaque paramètre doit se trouver sous la forme « key=value ». |
| properties.allowedAudiences |
string[] |
Valeurs d’audience autorisées à prendre en compte lors de la validation des jetons web JSON émis par Azure Active Directory. Notez que la |
| properties.allowedExternalRedirectUrls |
string[] |
URL externes pouvant être redirigées dans le cadre de la connexion ou de la déconnexion de l’application. Notez que la partie chaîne de requête de l’URL est ignorée. Il s’agit d’un paramètre avancé généralement nécessaire uniquement par les back-ends d’application du Windows Store. Notez que les URL du domaine actuel sont toujours implicitement autorisées. |
| properties.authFilePath |
string |
Chemin du fichier de configuration contenant les paramètres d’authentification. Si le chemin d’accès est relatif, la base va le répertoire racine du site. |
| properties.clientId |
string |
ID client de cette application de partie de confiance, appelé client_id. Ce paramètre est requis pour activer l’authentification de connexion OpenID avec Azure Active Directory ou d’autres fournisseurs OpenID Connect tiers. Plus d’informations sur OpenID Connect : http://openid.net/specs/openid-connect-core-1_0.html |
| properties.clientSecret |
string |
Clé secrète client de cette application de partie de confiance (dans Azure Active Directory, elle est également appelée clé). Ce paramètre est facultatif. Si aucune clé secrète client n’est configurée, le flux d’authentification implicite OpenID Connect est utilisé pour authentifier les utilisateurs finaux. Sinon, le flux de code d’autorisation OpenID Connect est utilisé pour authentifier les utilisateurs finaux. Plus d’informations sur OpenID Connect : http://openid.net/specs/openid-connect-core-1_0.html |
| properties.clientSecretCertificateThumbprint |
string |
Alternative à la clé secrète client, c’est-à-dire l’empreinte numérique d’un certificat utilisé à des fins de signature. Cette propriété remplace la clé secrète client. Il est également facultatif. |
| properties.clientSecretSettingName |
string |
Nom du paramètre d’application qui contient la clé secrète client de l’application de partie de confiance. |
| properties.configVersion |
string |
ConfigVersion de la fonctionnalité d’authentification/autorisation utilisée pour l’application actuelle. Le paramètre de cette valeur peut contrôler le comportement du plan de contrôle pour l’authentification/autorisation. |
| properties.defaultProvider |
Fournisseur d’authentification par défaut à utiliser quand plusieurs fournisseurs sont configurés. Ce paramètre n’est nécessaire que si plusieurs fournisseurs sont configurés et que l’action du client non authentifié est définie sur « RedirectToLoginPage ». |
|
| properties.enabled |
boolean |
|
| properties.facebookAppId |
string |
ID d’application de l’application Facebook utilisée pour la connexion. Ce paramètre est requis pour activer la connexion Facebook. Documentation de connexion Facebook : https://developers.facebook.com/docs/facebook-login |
| properties.facebookAppSecret |
string |
Secret d’application de l’application Facebook utilisée pour Facebook Login. Ce paramètre est requis pour activer la connexion Facebook. Documentation de connexion Facebook : https://developers.facebook.com/docs/facebook-login |
| properties.facebookAppSecretSettingName |
string |
Nom du paramètre d’application qui contient le secret d’application utilisé pour La connexion Facebook. |
| properties.facebookOAuthScopes |
string[] |
Étendues OAuth 2.0 qui seront demandées dans le cadre de l’authentification de connexion Facebook. Ce paramètre est facultatif. Documentation de connexion Facebook : https://developers.facebook.com/docs/facebook-login |
| properties.gitHubClientId |
string |
ID client de l’application GitHub utilisée pour la connexion. Ce paramètre est requis pour activer la connexion GitHub |
| properties.gitHubClientSecret |
string |
Clé secrète client de l’application GitHub utilisée pour Github Login. Ce paramètre est requis pour activer la connexion Github. |
| properties.gitHubClientSecretSettingName |
string |
Nom du paramètre d’application qui contient la clé secrète client de l’application Github utilisée pour la connexion GitHub. |
| properties.gitHubOAuthScopes |
string[] |
Étendues OAuth 2.0 qui seront demandées dans le cadre de l’authentification de connexion GitHub. Ce paramètre est facultatif |
| properties.googleClientId |
string |
ID client OpenID Connect pour l’application web Google. Ce paramètre est requis pour activer la connexion Google. Documentation google Sign-In : https://developers.google.com/identity/sign-in/web/ |
| properties.googleClientSecret |
string |
Clé secrète client associée à l’application web Google. Ce paramètre est requis pour activer la connexion Google. Documentation google Sign-In : https://developers.google.com/identity/sign-in/web/ |
| properties.googleClientSecretSettingName |
string |
Nom du paramètre de l’application qui contient la clé secrète client associée à l’application Web Google. |
| properties.googleOAuthScopes |
string[] |
Étendues OAuth 2.0 qui seront demandées dans le cadre de l’authentification Google Sign-In. Ce paramètre est facultatif. S’il n’est pas spécifié, « openid », « profil » et « e-mail » sont utilisés comme étendues par défaut. Documentation google Sign-In : https://developers.google.com/identity/sign-in/web/ |
| properties.isAuthFromFile |
string |
« true » si les paramètres de configuration d’AUTH doivent être lus à partir d’un fichier, « false » dans le cas contraire |
| properties.issuer |
string |
URI de l’émetteur OpenID Connect qui représente l’entité qui émet des jetons d’accès pour cette application.
Lorsque vous utilisez Azure Active Directory, cette valeur est l’URI du locataire d’annuaire, par exemple |
| properties.microsoftAccountClientId |
string |
ID client OAuth 2.0 créé pour l’application utilisée pour l’authentification. Ce paramètre est requis pour activer l’authentification de compte Microsoft. Documentation OAuth du compte Microsoft : https://dev.onedrive.com/auth/msa_oauth.htm |
| properties.microsoftAccountClientSecret |
string |
Secret client OAuth 2.0 créé pour l’application utilisée pour l’authentification. Ce paramètre est requis pour activer l’authentification de compte Microsoft. Documentation OAuth du compte Microsoft : https://dev.onedrive.com/auth/msa_oauth.htm |
| properties.microsoftAccountClientSecretSettingName |
string |
Nom du paramètre d’application contenant la clé secrète client OAuth 2.0 créée pour l’application utilisée pour l’authentification. |
| properties.microsoftAccountOAuthScopes |
string[] |
Étendues OAuth 2.0 qui seront demandées dans le cadre de l’authentification du compte Microsoft. Ce paramètre est facultatif. S’il n’est pas spécifié, « wl.basic » est utilisé comme étendue par défaut. Documentation sur les étendues et autorisations des comptes Microsoft : https://msdn.microsoft.com/en-us/library/dn631845.aspx |
| properties.runtimeVersion |
string |
RuntimeVersion de la fonctionnalité d’authentification/autorisation utilisée pour l’application actuelle. Le paramètre de cette valeur peut contrôler le comportement de certaines fonctionnalités dans le module d’authentification/autorisation. |
| properties.tokenRefreshExtensionHours |
number (double) |
Nombre d’heures après l’expiration du jeton de session pendant lesquelles un jeton de session peut être utilisé pour appeler l’API d’actualisation du jeton. La valeur par défaut est 72 heures. |
| properties.tokenStoreEnabled |
boolean |
|
| properties.twitterConsumerKey |
string |
Clé de consommateur OAuth 1.0a de l’application Twitter utilisée pour la connexion. Ce paramètre est requis pour activer la connexion Twitter. Documentation Sign-In Twitter : https://dev.twitter.com/web/sign-in |
| properties.twitterConsumerSecret |
string |
Secret consommateur OAuth 1.0a de l’application Twitter utilisée pour la connexion. Ce paramètre est requis pour activer la connexion Twitter. Documentation Sign-In Twitter : https://dev.twitter.com/web/sign-in |
| properties.twitterConsumerSecretSettingName |
string |
Nom du paramètre d’application qui contient le secret consommateur OAuth 1.0a de l’application Twitter utilisée pour la connexion. |
| properties.unauthenticatedClientAction |
Action à entreprendre lorsqu’un client non authentifié tente d’accéder à l’application. |
|
| properties.validateIssuer |
boolean |
Obtient une valeur indiquant si l’émetteur doit être une URL HTTPS valide et être validée en tant que telle. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Ok |
|
| Other Status Codes |
Réponse d’erreur App Service. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
Update Auth Settings
Exemple de requête
PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/config/authsettings?api-version=2025-03-01
{
"properties": {
"enabled": true,
"runtimeVersion": "~1",
"unauthenticatedClientAction": "RedirectToLoginPage",
"tokenStoreEnabled": true,
"allowedExternalRedirectUrls": [
"sitef6141.customdomain.net",
"sitef6141.customdomain.info"
],
"defaultProvider": "Google",
"tokenRefreshExtensionHours": 120,
"clientId": "42d795a9-8abb-4d06-8534-39528af40f8e.apps.googleusercontent.com"
}
}
Exemple de réponse
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/config/authsettings",
"name": "authsettings",
"type": "Microsoft.Web/sites/authsettings",
"kind": "app",
"properties": {
"enabled": true,
"runtimeVersion": "~1",
"unauthenticatedClientAction": "RedirectToLoginPage",
"tokenStoreEnabled": true,
"allowedExternalRedirectUrls": [
"sitef6141.customdomain.net",
"sitef6141.customdomain.info"
],
"defaultProvider": "Google",
"tokenRefreshExtensionHours": 120,
"clientId": "42d795a9-8abb-4d06-8534-39528af40f8e.apps.googleusercontent.com"
}
}
Définitions
| Nom | Description |
|---|---|
|
Built |
Fournisseur d’authentification par défaut à utiliser quand plusieurs fournisseurs sont configurés. Ce paramètre n’est nécessaire que si plusieurs fournisseurs sont configurés et que l’action du client non authentifié est définie sur « RedirectToLoginPage ». |
|
Default |
Réponse d’erreur App Service. |
| Details | |
| Error |
Modèle d’erreur. |
|
Site |
Paramètres de configuration de la fonctionnalité d’authentification/d’autorisation Azure App Service. |
|
Unauthenticated |
Action à entreprendre lorsqu’un client non authentifié tente d’accéder à l’application. |
BuiltInAuthenticationProvider
Fournisseur d’authentification par défaut à utiliser quand plusieurs fournisseurs sont configurés. Ce paramètre n’est nécessaire que si plusieurs fournisseurs sont configurés et que l’action du client non authentifié est définie sur « RedirectToLoginPage ».
| Valeur | Description |
|---|---|
| AzureActiveDirectory | |
| MicrosoftAccount | |
| Github |
DefaultErrorResponse
Réponse d’erreur App Service.
| Nom | Type | Description |
|---|---|---|
| error |
Modèle d’erreur. |
Details
| Nom | Type | Description |
|---|---|---|
| code |
string |
Chaîne standardisée pour identifier l’erreur par programmation. |
| message |
string |
Description détaillée de l’erreur et informations de débogage. |
| target |
string |
Description détaillée de l’erreur et informations de débogage. |
Error
Modèle d’erreur.
| Nom | Type | Description |
|---|---|---|
| code |
string |
Chaîne standardisée pour identifier l’erreur par programmation. |
| details |
Details[] |
Erreurs détaillées. |
| innererror |
string |
Plus d’informations pour déboguer l’erreur. |
| message |
string |
Description détaillée de l’erreur et informations de débogage. |
| target |
string |
Description détaillée de l’erreur et informations de débogage. |
SiteAuthSettings
Paramètres de configuration de la fonctionnalité d’authentification/d’autorisation Azure App Service.
| Nom | Type | Description |
|---|---|---|
| id |
string |
ID de ressource. |
| kind |
string |
Type de ressource. |
| name |
string |
Nom de la ressource. |
| properties.aadClaimsAuthorization |
string |
Obtient une chaîne JSON contenant les paramètres Acl Azure AD. |
| properties.additionalLoginParams |
string[] |
Paramètres de connexion à envoyer au point de terminaison d’autorisation OpenID Connect lorsqu’un utilisateur se connecte. Chaque paramètre doit se trouver sous la forme « key=value ». |
| properties.allowedAudiences |
string[] |
Valeurs d’audience autorisées à prendre en compte lors de la validation des jetons web JSON émis par Azure Active Directory. Notez que la |
| properties.allowedExternalRedirectUrls |
string[] |
URL externes pouvant être redirigées dans le cadre de la connexion ou de la déconnexion de l’application. Notez que la partie chaîne de requête de l’URL est ignorée. Il s’agit d’un paramètre avancé généralement nécessaire uniquement par les back-ends d’application du Windows Store. Notez que les URL du domaine actuel sont toujours implicitement autorisées. |
| properties.authFilePath |
string |
Chemin du fichier de configuration contenant les paramètres d’authentification. Si le chemin d’accès est relatif, la base va le répertoire racine du site. |
| properties.clientId |
string |
ID client de cette application de partie de confiance, appelé client_id. Ce paramètre est requis pour activer l’authentification de connexion OpenID avec Azure Active Directory ou d’autres fournisseurs OpenID Connect tiers. Plus d’informations sur OpenID Connect : http://openid.net/specs/openid-connect-core-1_0.html |
| properties.clientSecret |
string |
Clé secrète client de cette application de partie de confiance (dans Azure Active Directory, elle est également appelée clé). Ce paramètre est facultatif. Si aucune clé secrète client n’est configurée, le flux d’authentification implicite OpenID Connect est utilisé pour authentifier les utilisateurs finaux. Sinon, le flux de code d’autorisation OpenID Connect est utilisé pour authentifier les utilisateurs finaux. Plus d’informations sur OpenID Connect : http://openid.net/specs/openid-connect-core-1_0.html |
| properties.clientSecretCertificateThumbprint |
string |
Alternative à la clé secrète client, c’est-à-dire l’empreinte numérique d’un certificat utilisé à des fins de signature. Cette propriété remplace la clé secrète client. Il est également facultatif. |
| properties.clientSecretSettingName |
string |
Nom du paramètre d’application qui contient la clé secrète client de l’application de partie de confiance. |
| properties.configVersion |
string |
ConfigVersion de la fonctionnalité d’authentification/autorisation utilisée pour l’application actuelle. Le paramètre de cette valeur peut contrôler le comportement du plan de contrôle pour l’authentification/autorisation. |
| properties.defaultProvider |
Fournisseur d’authentification par défaut à utiliser quand plusieurs fournisseurs sont configurés. Ce paramètre n’est nécessaire que si plusieurs fournisseurs sont configurés et que l’action du client non authentifié est définie sur « RedirectToLoginPage ». |
|
| properties.enabled |
boolean |
|
| properties.facebookAppId |
string |
ID d’application de l’application Facebook utilisée pour la connexion. Ce paramètre est requis pour activer la connexion Facebook. Documentation de connexion Facebook : https://developers.facebook.com/docs/facebook-login |
| properties.facebookAppSecret |
string |
Secret d’application de l’application Facebook utilisée pour Facebook Login. Ce paramètre est requis pour activer la connexion Facebook. Documentation de connexion Facebook : https://developers.facebook.com/docs/facebook-login |
| properties.facebookAppSecretSettingName |
string |
Nom du paramètre d’application qui contient le secret d’application utilisé pour La connexion Facebook. |
| properties.facebookOAuthScopes |
string[] |
Étendues OAuth 2.0 qui seront demandées dans le cadre de l’authentification de connexion Facebook. Ce paramètre est facultatif. Documentation de connexion Facebook : https://developers.facebook.com/docs/facebook-login |
| properties.gitHubClientId |
string |
ID client de l’application GitHub utilisée pour la connexion. Ce paramètre est requis pour activer la connexion GitHub |
| properties.gitHubClientSecret |
string |
Clé secrète client de l’application GitHub utilisée pour Github Login. Ce paramètre est requis pour activer la connexion Github. |
| properties.gitHubClientSecretSettingName |
string |
Nom du paramètre d’application qui contient la clé secrète client de l’application Github utilisée pour la connexion GitHub. |
| properties.gitHubOAuthScopes |
string[] |
Étendues OAuth 2.0 qui seront demandées dans le cadre de l’authentification de connexion GitHub. Ce paramètre est facultatif |
| properties.googleClientId |
string |
ID client OpenID Connect pour l’application web Google. Ce paramètre est requis pour activer la connexion Google. Documentation google Sign-In : https://developers.google.com/identity/sign-in/web/ |
| properties.googleClientSecret |
string |
Clé secrète client associée à l’application web Google. Ce paramètre est requis pour activer la connexion Google. Documentation google Sign-In : https://developers.google.com/identity/sign-in/web/ |
| properties.googleClientSecretSettingName |
string |
Nom du paramètre de l’application qui contient la clé secrète client associée à l’application Web Google. |
| properties.googleOAuthScopes |
string[] |
Étendues OAuth 2.0 qui seront demandées dans le cadre de l’authentification Google Sign-In. Ce paramètre est facultatif. S’il n’est pas spécifié, « openid », « profil » et « e-mail » sont utilisés comme étendues par défaut. Documentation google Sign-In : https://developers.google.com/identity/sign-in/web/ |
| properties.isAuthFromFile |
string |
« true » si les paramètres de configuration d’AUTH doivent être lus à partir d’un fichier, « false » dans le cas contraire |
| properties.issuer |
string |
URI de l’émetteur OpenID Connect qui représente l’entité qui émet des jetons d’accès pour cette application.
Lorsque vous utilisez Azure Active Directory, cette valeur est l’URI du locataire d’annuaire, par exemple |
| properties.microsoftAccountClientId |
string |
ID client OAuth 2.0 créé pour l’application utilisée pour l’authentification. Ce paramètre est requis pour activer l’authentification de compte Microsoft. Documentation OAuth du compte Microsoft : https://dev.onedrive.com/auth/msa_oauth.htm |
| properties.microsoftAccountClientSecret |
string |
Secret client OAuth 2.0 créé pour l’application utilisée pour l’authentification. Ce paramètre est requis pour activer l’authentification de compte Microsoft. Documentation OAuth du compte Microsoft : https://dev.onedrive.com/auth/msa_oauth.htm |
| properties.microsoftAccountClientSecretSettingName |
string |
Nom du paramètre d’application contenant la clé secrète client OAuth 2.0 créée pour l’application utilisée pour l’authentification. |
| properties.microsoftAccountOAuthScopes |
string[] |
Étendues OAuth 2.0 qui seront demandées dans le cadre de l’authentification du compte Microsoft. Ce paramètre est facultatif. S’il n’est pas spécifié, « wl.basic » est utilisé comme étendue par défaut. Documentation sur les étendues et autorisations des comptes Microsoft : https://msdn.microsoft.com/en-us/library/dn631845.aspx |
| properties.runtimeVersion |
string |
RuntimeVersion de la fonctionnalité d’authentification/autorisation utilisée pour l’application actuelle. Le paramètre de cette valeur peut contrôler le comportement de certaines fonctionnalités dans le module d’authentification/autorisation. |
| properties.tokenRefreshExtensionHours |
number (double) |
Nombre d’heures après l’expiration du jeton de session pendant lesquelles un jeton de session peut être utilisé pour appeler l’API d’actualisation du jeton. La valeur par défaut est 72 heures. |
| properties.tokenStoreEnabled |
boolean |
|
| properties.twitterConsumerKey |
string |
Clé de consommateur OAuth 1.0a de l’application Twitter utilisée pour la connexion. Ce paramètre est requis pour activer la connexion Twitter. Documentation Sign-In Twitter : https://dev.twitter.com/web/sign-in |
| properties.twitterConsumerSecret |
string |
Secret consommateur OAuth 1.0a de l’application Twitter utilisée pour la connexion. Ce paramètre est requis pour activer la connexion Twitter. Documentation Sign-In Twitter : https://dev.twitter.com/web/sign-in |
| properties.twitterConsumerSecretSettingName |
string |
Nom du paramètre d’application qui contient le secret consommateur OAuth 1.0a de l’application Twitter utilisée pour la connexion. |
| properties.unauthenticatedClientAction |
Action à entreprendre lorsqu’un client non authentifié tente d’accéder à l’application. |
|
| properties.validateIssuer |
boolean |
Obtient une valeur indiquant si l’émetteur doit être une URL HTTPS valide et être validée en tant que telle. |
| type |
string |
Type de ressource. |
UnauthenticatedClientAction
Action à entreprendre lorsqu’un client non authentifié tente d’accéder à l’application.
| Valeur | Description |
|---|---|
| RedirectToLoginPage | |
| AllowAnonymous |