Web Apps - Update Auth Settings
Popis aktualizace nastavení ověřování nebo autorizace přidružené k webové aplikaci
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/authsettings?api-version=2024-04-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
name
|
path | True |
string |
Název webové aplikace |
resource
|
path | True |
string |
Název skupiny prostředků, do které prostředek patří. Vzor regulárního výrazu: |
subscription
|
path | True |
string |
ID vašeho předplatného Azure. Jedná se o řetězec formátovaný identifikátorem GUID (např. 00000000-0000-0000-0000-000000000000000). |
api-version
|
query | True |
string |
Verze rozhraní API |
Text požadavku
Name | Typ | Description |
---|---|---|
kind |
string |
Druh prostředku. |
properties.aadClaimsAuthorization |
string |
Získá řetězec JSON obsahující nastavení seznamu Acl služby Azure AD. |
properties.additionalLoginParams |
string[] |
Přihlašovací parametry pro odeslání do koncového bodu autorizace OpenID Connect, když se uživatel přihlásí. Každý parametr musí být ve tvaru "key=value". |
properties.allowedAudiences |
string[] |
Povolené hodnoty cílové skupiny je možné zvážit při ověřování webových tokenů JSON vydaných službou Azure Active Directory. Všimněte si, že hodnota |
properties.allowedExternalRedirectUrls |
string[] |
Externí adresy URL, které je možné přesměrovat jako součást přihlášení nebo odhlášení z aplikace. Všimněte si, že část řetězce dotazu adresy URL je ignorována. Jedná se o upřesňující nastavení, které obvykle potřebují jenom back-endy aplikací pro Windows Store. Mějte na paměti, že adresy URL v aktuální doméně jsou vždy implicitně povolené. |
properties.authFilePath |
string |
Cesta konfiguračního souboru obsahujícího nastavení ověřování. Pokud je cesta relativní, základ bude kořenový adresář webu. |
properties.clientId |
string |
ID klienta této aplikace předávající strany označované jako client_id. Toto nastavení se vyžaduje pro povolení ověřování připojení OpenID pomocí Azure Active Directory nebo jiných poskytovatelů OpenID Connect třetích stran. Další informace o OpenID Connect: http://openid.net/specs/openid-connect-core-1_0.html |
properties.clientSecret |
string |
Tajný klíč klienta této aplikace předávající strany (v Azure Active Directory se označuje také jako klíč). Toto nastavení je volitelné. Pokud není nakonfigurovaný žádný tajný klíč klienta, použije se k ověřování koncových uživatelů tok implicitního ověřování OpenID Connect. Jinak se k ověřování koncových uživatelů použije tok autorizačního kódu OpenID Connect. Další informace o OpenID Connect: http://openid.net/specs/openid-connect-core-1_0.html |
properties.clientSecretCertificateThumbprint |
string |
Alternativou k tajnému klíči klienta je kryptografický otisk certifikátu používaného pro podpisové účely. Tato vlastnost slouží jako náhrada tajného klíče klienta. Je také nepovinný. |
properties.clientSecretSettingName |
string |
Název nastavení aplikace, který obsahuje tajný klíč klienta aplikace předávající strany. |
properties.configVersion |
string |
Konfigurace Verze funkce ověřování / autorizace, která se používá pro aktuální aplikaci. Nastavení v této hodnotě může řídit chování roviny řízení pro ověřování nebo autorizaci. |
properties.defaultProvider |
Výchozí zprostředkovatel ověřování, který se má použít při konfiguraci více zprostředkovatelů. Toto nastavení je potřeba jenom v případě, že je nakonfigurovaných více poskytovatelů a neověřená akce klienta je nastavená na RedirectToLoginPage. |
|
properties.enabled |
boolean |
|
properties.facebookAppId |
string |
ID aplikace facebookové aplikace použité k přihlášení. Toto nastavení se vyžaduje pro povolení přihlášení k Facebooku. Dokumentace k přihlášení k Facebooku: https://developers.facebook.com/docs/facebook-login |
properties.facebookAppSecret |
string |
Tajný kód aplikace facebookové aplikace, která se používá pro přihlášení k Facebooku. Toto nastavení se vyžaduje pro povolení přihlášení k Facebooku. Dokumentace k přihlášení k Facebooku: https://developers.facebook.com/docs/facebook-login |
properties.facebookAppSecretSettingName |
string |
Název nastavení aplikace, který obsahuje tajný kód aplikace používaný pro přihlášení k Facebooku. |
properties.facebookOAuthScopes |
string[] |
Obory OAuth 2.0, které budou požadovány jako součást ověřování přihlášení k Facebooku. Toto nastavení je volitelné. Dokumentace k přihlášení k Facebooku: https://developers.facebook.com/docs/facebook-login |
properties.gitHubClientId |
string |
ID klienta aplikace GitHub používané k přihlášení. Toto nastavení se vyžaduje pro povolení přihlášení k GitHubu. |
properties.gitHubClientSecret |
string |
Tajný klíč klienta aplikace GitHub používané pro přihlášení k GitHubu. Toto nastavení se vyžaduje pro povolení přihlášení k GitHubu. |
properties.gitHubClientSecretSettingName |
string |
Název nastavení aplikace, který obsahuje tajný klíč klienta aplikace GitHub používané pro přihlášení k GitHubu. |
properties.gitHubOAuthScopes |
string[] |
Obory OAuth 2.0, které budou požadovány jako součást ověřování githubu pro přihlášení. Toto nastavení je volitelné. |
properties.googleClientId |
string |
ID klienta OpenID Connect pro webovou aplikaci Google. Toto nastavení se vyžaduje pro povolení přihlášení Google. Dokumentace ke službě Google Sign-In: https://developers.google.com/identity/sign-in/web/ |
properties.googleClientSecret |
string |
Tajný klíč klienta přidružený k webové aplikaci Google. Toto nastavení se vyžaduje pro povolení přihlášení Google. Dokumentace ke službě Google Sign-In: https://developers.google.com/identity/sign-in/web/ |
properties.googleClientSecretSettingName |
string |
Název nastavení aplikace, který obsahuje tajný klíč klienta přidružený k webové aplikaci Google. |
properties.googleOAuthScopes |
string[] |
Obory OAuth 2.0, které budou požadovány jako součást ověřování Google Sign-In. Toto nastavení je volitelné. Pokud nezadáte, jako výchozí obory se použijí "openid", "profile" a "email". Dokumentace ke službě Google Sign-In: https://developers.google.com/identity/sign-in/web/ |
properties.isAuthFromFile |
string |
True, pokud by se nastavení konfigurace ověřování mělo číst ze souboru, jinak false |
properties.issuer |
string |
Identifikátor URI vystavitele OpenID Connect, který představuje entitu, která vydává přístupové tokeny pro tuto aplikaci.
Při použití Azure Active Directory je tato hodnota identifikátor URI tenanta adresáře, například |
properties.microsoftAccountClientId |
string |
ID klienta OAuth 2.0, které se vytvořilo pro aplikaci použitou k ověřování. Toto nastavení se vyžaduje pro povolení ověřování účtu Microsoft. Dokumentace k OAuth účtu Microsoft: https://dev.onedrive.com/auth/msa_oauth.htm |
properties.microsoftAccountClientSecret |
string |
Tajný klíč klienta OAuth 2.0, který byl vytvořen pro aplikaci použitou k ověřování. Toto nastavení se vyžaduje pro povolení ověřování účtu Microsoft. Dokumentace k OAuth účtu Microsoft: https://dev.onedrive.com/auth/msa_oauth.htm |
properties.microsoftAccountClientSecretSettingName |
string |
Název nastavení aplikace obsahující tajný klíč klienta OAuth 2.0, který byl vytvořen pro aplikaci použitou k ověřování. |
properties.microsoftAccountOAuthScopes |
string[] |
Obory OAuth 2.0, které budou požadovány jako součást ověřování účtu Microsoft. Toto nastavení je volitelné. Pokud není zadaný, použije se jako výchozí obor "wl.basic". Dokumentace k rozsahům a oprávněním účtu Microsoft: https://msdn.microsoft.com/en-us/library/dn631845.aspx |
properties.runtimeVersion |
string |
RuntimeVersion funkce ověřování / autorizace, která se používá pro aktuální aplikaci. Nastavení v této hodnotě může řídit chování určitých funkcí v modulu ověřování a autorizace. |
properties.tokenRefreshExtensionHours |
number |
Počet hodin od vypršení platnosti tokenu relace, který lze použít k volání rozhraní API pro aktualizaci tokenu. Výchozí hodnota je 72 hodin. |
properties.tokenStoreEnabled |
boolean |
|
properties.twitterConsumerKey |
string |
Uživatelský klíč OAuth 1.0a aplikace Twitter, který se používá pro přihlášení. Toto nastavení se vyžaduje pro povolení přihlášení k Twitteru. Dokumentace ke službě Twitter Sign-In: https://dev.twitter.com/web/sign-in |
properties.twitterConsumerSecret |
string |
Tajný kód uživatele OAuth 1.0a aplikace Twitter, který se používá k přihlášení. Toto nastavení se vyžaduje pro povolení přihlášení k Twitteru. Dokumentace ke službě Twitter Sign-In: https://dev.twitter.com/web/sign-in |
properties.twitterConsumerSecretSettingName |
string |
Název nastavení aplikace, který obsahuje tajný kód uživatele OAuth 1.0a aplikace Twitter používané k přihlášení. |
properties.unauthenticatedClientAction |
Akce, která se má provést, když se neověřený klient pokusí o přístup k aplikaci. |
|
properties.validateIssuer |
boolean |
Získá hodnotu určující, zda vystavitel by měl být platnou adresu URL HTTPS a být ověřen jako takový. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Odpověď na chybu služby App Service |
Zabezpečení
azure_auth
Azure Active Directory OAuth2 Flow
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Update Auth Settings
Ukázkový požadavek
PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/config/authsettings?api-version=2024-04-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"
}
}
Ukázková odpověď
{
"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"
}
}
Definice
Name | Description |
---|---|
Built |
Výchozí zprostředkovatel ověřování, který se má použít při konfiguraci více zprostředkovatelů. Toto nastavení je potřeba jenom v případě, že je nakonfigurovaných více poskytovatelů a neověřená akce klienta je nastavená na RedirectToLoginPage. |
Default |
Odpověď na chybu služby App Service |
Details | |
Error |
Chybový model |
Site |
Nastavení konfigurace pro funkci ověřování nebo autorizace služby Azure App Service |
Unauthenticated |
Akce, která se má provést, když se neověřený klient pokusí o přístup k aplikaci. |
BuiltInAuthenticationProvider
Výchozí zprostředkovatel ověřování, který se má použít při konfiguraci více zprostředkovatelů. Toto nastavení je potřeba jenom v případě, že je nakonfigurovaných více poskytovatelů a neověřená akce klienta je nastavená na RedirectToLoginPage.
Hodnota | Description |
---|---|
AzureActiveDirectory | |
Github | |
MicrosoftAccount | |
DefaultErrorResponse
Odpověď na chybu služby App Service
Name | Typ | Description |
---|---|---|
error |
Chybový model |
Details
Name | Typ | Description |
---|---|---|
code |
string |
Standardizovaný řetězec pro programovou identifikaci chyby. |
message |
string |
Podrobný popis chyby a informace o ladění |
target |
string |
Podrobný popis chyby a informace o ladění |
Error
Chybový model
Name | Typ | Description |
---|---|---|
code |
string |
Standardizovaný řetězec pro programovou identifikaci chyby. |
details |
Details[] |
Podrobné chyby. |
innererror |
string |
Další informace o ladění chyby |
message |
string |
Podrobný popis chyby a informace o ladění |
target |
string |
Podrobný popis chyby a informace o ladění |
SiteAuthSettings
Nastavení konfigurace pro funkci ověřování nebo autorizace služby Azure App Service
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku. |
kind |
string |
Druh prostředku. |
name |
string |
Název prostředku |
properties.aadClaimsAuthorization |
string |
Získá řetězec JSON obsahující nastavení seznamu Acl služby Azure AD. |
properties.additionalLoginParams |
string[] |
Přihlašovací parametry pro odeslání do koncového bodu autorizace OpenID Connect, když se uživatel přihlásí. Každý parametr musí být ve tvaru "key=value". |
properties.allowedAudiences |
string[] |
Povolené hodnoty cílové skupiny je možné zvážit při ověřování webových tokenů JSON vydaných službou Azure Active Directory. Všimněte si, že hodnota |
properties.allowedExternalRedirectUrls |
string[] |
Externí adresy URL, které je možné přesměrovat jako součást přihlášení nebo odhlášení z aplikace. Všimněte si, že část řetězce dotazu adresy URL je ignorována. Jedná se o upřesňující nastavení, které obvykle potřebují jenom back-endy aplikací pro Windows Store. Mějte na paměti, že adresy URL v aktuální doméně jsou vždy implicitně povolené. |
properties.authFilePath |
string |
Cesta konfiguračního souboru obsahujícího nastavení ověřování. Pokud je cesta relativní, základ bude kořenový adresář webu. |
properties.clientId |
string |
ID klienta této aplikace předávající strany označované jako client_id. Toto nastavení se vyžaduje pro povolení ověřování připojení OpenID pomocí Azure Active Directory nebo jiných poskytovatelů OpenID Connect třetích stran. Další informace o OpenID Connect: http://openid.net/specs/openid-connect-core-1_0.html |
properties.clientSecret |
string |
Tajný klíč klienta této aplikace předávající strany (v Azure Active Directory se označuje také jako klíč). Toto nastavení je volitelné. Pokud není nakonfigurovaný žádný tajný klíč klienta, použije se k ověřování koncových uživatelů tok implicitního ověřování OpenID Connect. Jinak se k ověřování koncových uživatelů použije tok autorizačního kódu OpenID Connect. Další informace o OpenID Connect: http://openid.net/specs/openid-connect-core-1_0.html |
properties.clientSecretCertificateThumbprint |
string |
Alternativou k tajnému klíči klienta je kryptografický otisk certifikátu používaného pro podpisové účely. Tato vlastnost slouží jako náhrada tajného klíče klienta. Je také nepovinný. |
properties.clientSecretSettingName |
string |
Název nastavení aplikace, který obsahuje tajný klíč klienta aplikace předávající strany. |
properties.configVersion |
string |
Konfigurace Verze funkce ověřování / autorizace, která se používá pro aktuální aplikaci. Nastavení v této hodnotě může řídit chování roviny řízení pro ověřování nebo autorizaci. |
properties.defaultProvider |
Výchozí zprostředkovatel ověřování, který se má použít při konfiguraci více zprostředkovatelů. Toto nastavení je potřeba jenom v případě, že je nakonfigurovaných více poskytovatelů a neověřená akce klienta je nastavená na RedirectToLoginPage. |
|
properties.enabled |
boolean |
|
properties.facebookAppId |
string |
ID aplikace facebookové aplikace použité k přihlášení. Toto nastavení se vyžaduje pro povolení přihlášení k Facebooku. Dokumentace k přihlášení k Facebooku: https://developers.facebook.com/docs/facebook-login |
properties.facebookAppSecret |
string |
Tajný kód aplikace facebookové aplikace, která se používá pro přihlášení k Facebooku. Toto nastavení se vyžaduje pro povolení přihlášení k Facebooku. Dokumentace k přihlášení k Facebooku: https://developers.facebook.com/docs/facebook-login |
properties.facebookAppSecretSettingName |
string |
Název nastavení aplikace, který obsahuje tajný kód aplikace používaný pro přihlášení k Facebooku. |
properties.facebookOAuthScopes |
string[] |
Obory OAuth 2.0, které budou požadovány jako součást ověřování přihlášení k Facebooku. Toto nastavení je volitelné. Dokumentace k přihlášení k Facebooku: https://developers.facebook.com/docs/facebook-login |
properties.gitHubClientId |
string |
ID klienta aplikace GitHub používané k přihlášení. Toto nastavení se vyžaduje pro povolení přihlášení k GitHubu. |
properties.gitHubClientSecret |
string |
Tajný klíč klienta aplikace GitHub používané pro přihlášení k GitHubu. Toto nastavení se vyžaduje pro povolení přihlášení k GitHubu. |
properties.gitHubClientSecretSettingName |
string |
Název nastavení aplikace, který obsahuje tajný klíč klienta aplikace GitHub používané pro přihlášení k GitHubu. |
properties.gitHubOAuthScopes |
string[] |
Obory OAuth 2.0, které budou požadovány jako součást ověřování githubu pro přihlášení. Toto nastavení je volitelné. |
properties.googleClientId |
string |
ID klienta OpenID Connect pro webovou aplikaci Google. Toto nastavení se vyžaduje pro povolení přihlášení Google. Dokumentace ke službě Google Sign-In: https://developers.google.com/identity/sign-in/web/ |
properties.googleClientSecret |
string |
Tajný klíč klienta přidružený k webové aplikaci Google. Toto nastavení se vyžaduje pro povolení přihlášení Google. Dokumentace ke službě Google Sign-In: https://developers.google.com/identity/sign-in/web/ |
properties.googleClientSecretSettingName |
string |
Název nastavení aplikace, který obsahuje tajný klíč klienta přidružený k webové aplikaci Google. |
properties.googleOAuthScopes |
string[] |
Obory OAuth 2.0, které budou požadovány jako součást ověřování Google Sign-In. Toto nastavení je volitelné. Pokud nezadáte, jako výchozí obory se použijí "openid", "profile" a "email". Dokumentace ke službě Google Sign-In: https://developers.google.com/identity/sign-in/web/ |
properties.isAuthFromFile |
string |
True, pokud by se nastavení konfigurace ověřování mělo číst ze souboru, jinak false |
properties.issuer |
string |
Identifikátor URI vystavitele OpenID Connect, který představuje entitu, která vydává přístupové tokeny pro tuto aplikaci.
Při použití Azure Active Directory je tato hodnota identifikátor URI tenanta adresáře, například |
properties.microsoftAccountClientId |
string |
ID klienta OAuth 2.0, které se vytvořilo pro aplikaci použitou k ověřování. Toto nastavení se vyžaduje pro povolení ověřování účtu Microsoft. Dokumentace k OAuth účtu Microsoft: https://dev.onedrive.com/auth/msa_oauth.htm |
properties.microsoftAccountClientSecret |
string |
Tajný klíč klienta OAuth 2.0, který byl vytvořen pro aplikaci použitou k ověřování. Toto nastavení se vyžaduje pro povolení ověřování účtu Microsoft. Dokumentace k OAuth účtu Microsoft: https://dev.onedrive.com/auth/msa_oauth.htm |
properties.microsoftAccountClientSecretSettingName |
string |
Název nastavení aplikace obsahující tajný klíč klienta OAuth 2.0, který byl vytvořen pro aplikaci použitou k ověřování. |
properties.microsoftAccountOAuthScopes |
string[] |
Obory OAuth 2.0, které budou požadovány jako součást ověřování účtu Microsoft. Toto nastavení je volitelné. Pokud není zadaný, použije se jako výchozí obor "wl.basic". Dokumentace k rozsahům a oprávněním účtu Microsoft: https://msdn.microsoft.com/en-us/library/dn631845.aspx |
properties.runtimeVersion |
string |
RuntimeVersion funkce ověřování / autorizace, která se používá pro aktuální aplikaci. Nastavení v této hodnotě může řídit chování určitých funkcí v modulu ověřování a autorizace. |
properties.tokenRefreshExtensionHours |
number |
Počet hodin od vypršení platnosti tokenu relace, který lze použít k volání rozhraní API pro aktualizaci tokenu. Výchozí hodnota je 72 hodin. |
properties.tokenStoreEnabled |
boolean |
|
properties.twitterConsumerKey |
string |
Uživatelský klíč OAuth 1.0a aplikace Twitter, který se používá pro přihlášení. Toto nastavení se vyžaduje pro povolení přihlášení k Twitteru. Dokumentace ke službě Twitter Sign-In: https://dev.twitter.com/web/sign-in |
properties.twitterConsumerSecret |
string |
Tajný kód uživatele OAuth 1.0a aplikace Twitter, který se používá k přihlášení. Toto nastavení se vyžaduje pro povolení přihlášení k Twitteru. Dokumentace ke službě Twitter Sign-In: https://dev.twitter.com/web/sign-in |
properties.twitterConsumerSecretSettingName |
string |
Název nastavení aplikace, který obsahuje tajný kód uživatele OAuth 1.0a aplikace Twitter používané k přihlášení. |
properties.unauthenticatedClientAction |
Akce, která se má provést, když se neověřený klient pokusí o přístup k aplikaci. |
|
properties.validateIssuer |
boolean |
Získá hodnotu určující, zda vystavitel by měl být platnou adresu URL HTTPS a být ověřen jako takový. |
type |
string |
Typ prostředku. |
UnauthenticatedClientAction
Akce, která se má provést, když se neověřený klient pokusí o přístup k aplikaci.
Hodnota | Description |
---|---|
AllowAnonymous | |
RedirectToLoginPage |