Sdílet prostřednictvím


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

resourceGroupName
path True

string

Název skupiny prostředků, do které prostředek patří.

Vzor regulárního výrazu: ^[-\w\._\(\)]+[^\.]$

subscriptionId
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 ClientID se vždy považuje za povolenou cílovou skupinu bez ohledu na toto nastavení.

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

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.

properties.enabled

boolean

true, pokud je pro aktuální aplikaci povolená funkce ověřování nebo autorizace; jinak false.

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 https://sts.windows.net/{tenant-guid}/. Tento identifikátor URI rozlišuje malá a velká písmena pro vystavitele tokenu. Další informace o zjišťování OpenID Connect: http://openid.net/specs/openid-connect-discovery-1_0.html

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

true trvale ukládat tokeny zabezpečení specifické pro platformu, které se získávají během přihlašovacích toků; jinak false. Výchozí hodnota je false.

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

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

SiteAuthSettings

OK

Other Status Codes

DefaultErrorResponse

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
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.

DefaultErrorResponse

Odpověď na chybu služby App Service

Details
Error

Chybový model

SiteAuthSettings

Nastavení konfigurace pro funkci ověřování nebo autorizace služby Azure App Service

UnauthenticatedClientAction

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
Facebook
Github
Google
MicrosoftAccount
Twitter

DefaultErrorResponse

Odpověď na chybu služby App Service

Name Typ Description
error

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 ClientID se vždy považuje za povolenou cílovou skupinu bez ohledu na toto nastavení.

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

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.

properties.enabled

boolean

true, pokud je pro aktuální aplikaci povolená funkce ověřování nebo autorizace; jinak false.

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 https://sts.windows.net/{tenant-guid}/. Tento identifikátor URI rozlišuje malá a velká písmena pro vystavitele tokenu. Další informace o zjišťování OpenID Connect: http://openid.net/specs/openid-connect-discovery-1_0.html

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

true trvale ukládat tokeny zabezpečení specifické pro platformu, které se získávají během přihlašovacích toků; jinak false. Výchozí hodnota je false.

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

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