Delen via


Authorization Server - Update

Updates de details van de autorisatieserver die is opgegeven door de id.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}?api-version=2021-08-01

URI-parameters

Name In Vereist Type Description
authsid
path True

string

Id van de autorisatieserver.

Regex-patroon: ^[^*#&+:<>?]+$

resourceGroupName
path True

string

De naam van de resourcegroep.

serviceName
path True

string

De naam van de API Management service.

Regex-patroon: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

Abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.

api-version
query True

string

Versie van de API die moet worden gebruikt met de clientaanvraag.

Aanvraagkoptekst

Name Vereist Type Description
If-Match True

string

ETag van de entiteit. ETag moet overeenkomen met de huidige entiteitsstatus uit de headerreactie van de GET-aanvraag of moet * zijn voor onvoorwaardelijke update.

Aanvraagbody

Name Type Description
properties.authorizationEndpoint

string

OAuth-autorisatie-eindpunt. Zie http://tools.ietf.org/html/rfc6749#section-3.2.

properties.authorizationMethods

AuthorizationMethod[]

HTTP-werkwoorden die worden ondersteund door het autorisatie-eindpunt. GET moet altijd aanwezig zijn. POST is optioneel.

properties.bearerTokenSendingMethods

BearerTokenSendingMethod[]

Hiermee geeft u het mechanisme op waarmee het toegangstoken wordt doorgegeven aan de API.

properties.clientAuthenticationMethod

ClientAuthenticationMethod[]

Verificatiemethode die wordt ondersteund door het tokeneindpunt van deze autorisatieserver. Mogelijke waarden zijn Basic en/of Hoofdtekst. Wanneer hoofdtekst is opgegeven, worden clientreferenties en andere parameters doorgegeven in de aanvraagbody in de indeling application/x-www-form-urlencoded.

properties.clientId

string

Client- of app-id die is geregistreerd bij deze autorisatieserver.

properties.clientRegistrationEndpoint

string

Optionele verwijzing naar een pagina waarop de client- of app-registratie voor deze autorisatieserver wordt uitgevoerd. Bevat de absolute URL naar de entiteit waarnaar wordt verwezen.

properties.clientSecret

string

Client- of app-geheim dat is geregistreerd bij deze autorisatieserver. Deze eigenschap wordt niet ingevuld voor 'GET'-bewerkingen! Gebruik post-aanvraag '/listSecrets' om de waarde op te halen.

properties.defaultScope

string

Toegangstokenbereik dat standaard wordt aangevraagd. Kan worden overschreven op API-niveau. Moet worden opgegeven in de vorm van een tekenreeks met door spaties gescheiden waarden.

properties.description

string

Beschrijving van de autorisatieserver. Kan HTML-opmaaktags bevatten.

properties.displayName

string

Gebruiksvriendelijke autorisatieservernaam.

properties.grantTypes

GrantType[]

Vorm van een autorisatietoekenning, die de client gebruikt om het toegangstoken aan te vragen.

properties.resourceOwnerPassword

string

Kan optioneel worden opgegeven wanneer het type wachtwoordtoestemming van resource-eigenaar wordt ondersteund door deze autorisatieserver. Standaardwachtwoord voor resource-eigenaar.

properties.resourceOwnerUsername

string

Kan optioneel worden opgegeven wanneer het type wachtwoordtoestemming van resource-eigenaar wordt ondersteund door deze autorisatieserver. Standaardnaam van resource-eigenaar.

properties.supportState

boolean

Als dit waar is, bevat de autorisatieserver de statusparameter van de autorisatieaanvraag tot het antwoord. Client kan de statusparameter gebruiken om protocolbeveiliging te verhogen.

properties.tokenBodyParameters

TokenBodyParameterContract[]

Aanvullende parameters die vereist zijn voor het tokeneindpunt van deze autorisatieserver die worden weergegeven als een matrix van JSON-objecten met naam- en waardetekenreekseigenschappen, bijvoorbeeld {"name" : "name value", "value": "a value"}.

properties.tokenEndpoint

string

OAuth-tokeneindpunt. Bevat een absolute URI naar de entiteit waarnaar wordt verwezen.

Antwoorden

Name Type Description
200 OK

AuthorizationServerContract

De instellingen van de autorisatieserver zijn bijgewerkt.

Kopteksten

ETag: string

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

ApiManagementUpdateAuthorizationServer

Voorbeeldaanvraag

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/authorizationServers/newauthServer?api-version=2021-08-01


{
  "properties": {
    "clientId": "update",
    "clientSecret": "updated"
  }
}

Voorbeeldrespons

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/authorizationServers/newauthServer",
  "type": "Microsoft.ApiManagement/service/authorizationServers",
  "name": "newauthServer",
  "properties": {
    "displayName": "test3",
    "description": "test server",
    "clientRegistrationEndpoint": "https://www.contoso.com/apps",
    "authorizationEndpoint": "https://www.contoso.com/oauth2/auth",
    "authorizationMethods": [
      "GET"
    ],
    "clientAuthenticationMethod": [
      "Basic"
    ],
    "tokenEndpoint": "https://www.contoso.com/oauth2/token",
    "supportState": true,
    "defaultScope": "read write",
    "grantTypes": [
      "authorizationCode",
      "implicit"
    ],
    "bearerTokenSendingMethods": [
      "authorizationHeader"
    ],
    "clientId": "updated",
    "resourceOwnerUsername": "un",
    "resourceOwnerPassword": "pwd"
  }
}

Definities

Name Description
AuthorizationMethod

HTTP-woorden die worden ondersteund door het autorisatie-eindpunt. GET moet altijd aanwezig zijn. POST is optioneel.

AuthorizationServerContract

Instellingen voor externe OAuth-autorisatieserver.

AuthorizationServerUpdateContract

Instellingen voor externe OAuth-autorisatieserver.

BearerTokenSendingMethod

Hiermee geeft u het mechanisme op waarmee het toegangstoken wordt doorgegeven aan de API.

ClientAuthenticationMethod

Verificatiemethode die wordt ondersteund door het tokeneindpunt van deze autorisatieserver. Mogelijke waarden zijn Basic en/of Hoofdtekst. Wanneer hoofdtekst is opgegeven, worden clientreferenties en andere parameters doorgegeven in de aanvraagbody in de indeling application/x-www-form-urlencoded.

ErrorFieldContract

Fout Veldcontract.

ErrorResponse

Foutreactie.

GrantType

Vorm van een autorisatietoekenning, die de client gebruikt om het toegangstoken aan te vragen.

TokenBodyParameterContract

OAuth acquire token request body parameter (www-url-form-encoded).

AuthorizationMethod

HTTP-woorden die worden ondersteund door het autorisatie-eindpunt. GET moet altijd aanwezig zijn. POST is optioneel.

Name Type Description
DELETE

string

GET

string

HEAD

string

OPTIONS

string

PATCH

string

POST

string

PUT

string

TRACE

string

AuthorizationServerContract

Instellingen voor externe OAuth-autorisatieserver.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

De naam van de resource

properties.authorizationEndpoint

string

OAuth-autorisatie-eindpunt. Zie http://tools.ietf.org/html/rfc6749#section-3.2.

properties.authorizationMethods

AuthorizationMethod[]

HTTP-woorden die worden ondersteund door het autorisatie-eindpunt. GET moet altijd aanwezig zijn. POST is optioneel.

properties.bearerTokenSendingMethods

BearerTokenSendingMethod[]

Hiermee geeft u het mechanisme op waarmee het toegangstoken wordt doorgegeven aan de API.

properties.clientAuthenticationMethod

ClientAuthenticationMethod[]

Verificatiemethode die wordt ondersteund door het tokeneindpunt van deze autorisatieserver. Mogelijke waarden zijn Basic en/of Hoofdtekst. Wanneer hoofdtekst is opgegeven, worden clientreferenties en andere parameters doorgegeven in de aanvraagbody in de indeling application/x-www-form-urlencoded.

properties.clientId

string

Client- of app-id die is geregistreerd bij deze autorisatieserver.

properties.clientRegistrationEndpoint

string

Optionele verwijzing naar een pagina waarop client- of app-registratie voor deze autorisatieserver wordt uitgevoerd. Bevat de absolute URL naar de entiteit waarnaar wordt verwezen.

properties.clientSecret

string

Client- of app-geheim dat is geregistreerd bij deze autorisatieserver. Deze eigenschap wordt niet ingevuld bij 'GET'-bewerkingen! Gebruik post-aanvraag '/listSecrets' om de waarde op te halen.

properties.defaultScope

string

Toegangstokenbereik dat standaard wordt aangevraagd. Kan worden overschreven op API-niveau. Moet worden opgegeven in de vorm van een tekenreeks die door spaties gescheiden waarden bevat.

properties.description

string

Beschrijving van de autorisatieserver. Kan HTML-opmaaktags bevatten.

properties.displayName

string

Gebruiksvriendelijke autorisatieservernaam.

properties.grantTypes

GrantType[]

Vorm van een autorisatietoekenning, die de client gebruikt om het toegangstoken aan te vragen.

properties.resourceOwnerPassword

string

Kan optioneel worden opgegeven wanneer het type wachtwoordtoestemming van de resource-eigenaar wordt ondersteund door deze autorisatieserver. Standaardwachtwoord voor resource-eigenaar.

properties.resourceOwnerUsername

string

Kan optioneel worden opgegeven wanneer het type wachtwoordtoestemming van de resource-eigenaar wordt ondersteund door deze autorisatieserver. Standaard gebruikersnaam van resource-eigenaar.

properties.supportState

boolean

Als dit waar is, bevat de autorisatieserver de statusparameter van de autorisatieaanvraag tot het antwoord. Client kan de statusparameter gebruiken om protocolbeveiliging te verhogen.

properties.tokenBodyParameters

TokenBodyParameterContract[]

Aanvullende parameters die vereist zijn voor het tokeneindpunt van deze autorisatieserver, weergegeven als een matrix van JSON-objecten met eigenschappen voor naam- en waardetekenreeksen, bijvoorbeeld {"name" : "name value", "value": "a value"}.

properties.tokenEndpoint

string

OAuth-tokeneindpunt. Bevat een absolute URI naar de entiteit waarnaar wordt verwezen.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

AuthorizationServerUpdateContract

Instellingen voor externe OAuth-autorisatieserver.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

De naam van de resource

properties.authorizationEndpoint

string

OAuth-autorisatie-eindpunt. Zie http://tools.ietf.org/html/rfc6749#section-3.2.

properties.authorizationMethods

AuthorizationMethod[]

HTTP-woorden die worden ondersteund door het autorisatie-eindpunt. GET moet altijd aanwezig zijn. POST is optioneel.

properties.bearerTokenSendingMethods

BearerTokenSendingMethod[]

Hiermee geeft u het mechanisme op waarmee het toegangstoken wordt doorgegeven aan de API.

properties.clientAuthenticationMethod

ClientAuthenticationMethod[]

Verificatiemethode die wordt ondersteund door het tokeneindpunt van deze autorisatieserver. Mogelijke waarden zijn Basic en/of Hoofdtekst. Wanneer hoofdtekst is opgegeven, worden clientreferenties en andere parameters doorgegeven in de aanvraagbody in de indeling application/x-www-form-urlencoded.

properties.clientId

string

Client- of app-id die is geregistreerd bij deze autorisatieserver.

properties.clientRegistrationEndpoint

string

Optionele verwijzing naar een pagina waarop client- of app-registratie voor deze autorisatieserver wordt uitgevoerd. Bevat de absolute URL naar de entiteit waarnaar wordt verwezen.

properties.clientSecret

string

Client- of app-geheim dat is geregistreerd bij deze autorisatieserver. Deze eigenschap wordt niet ingevuld bij 'GET'-bewerkingen! Gebruik post-aanvraag '/listSecrets' om de waarde op te halen.

properties.defaultScope

string

Toegangstokenbereik dat standaard wordt aangevraagd. Kan worden overschreven op API-niveau. Moet worden opgegeven in de vorm van een tekenreeks die door spaties gescheiden waarden bevat.

properties.description

string

Beschrijving van de autorisatieserver. Kan HTML-opmaaktags bevatten.

properties.displayName

string

Gebruiksvriendelijke autorisatieservernaam.

properties.grantTypes

GrantType[]

Vorm van een autorisatietoekenning, die de client gebruikt om het toegangstoken aan te vragen.

properties.resourceOwnerPassword

string

Kan optioneel worden opgegeven wanneer het type wachtwoordtoestemming van de resource-eigenaar wordt ondersteund door deze autorisatieserver. Standaardwachtwoord voor resource-eigenaar.

properties.resourceOwnerUsername

string

Kan optioneel worden opgegeven wanneer het type wachtwoordtoestemming van de resource-eigenaar wordt ondersteund door deze autorisatieserver. Standaard gebruikersnaam van resource-eigenaar.

properties.supportState

boolean

Als dit waar is, bevat de autorisatieserver de statusparameter van de autorisatieaanvraag tot het antwoord. Client kan de statusparameter gebruiken om protocolbeveiliging te verhogen.

properties.tokenBodyParameters

TokenBodyParameterContract[]

Aanvullende parameters die vereist zijn voor het tokeneindpunt van deze autorisatieserver, weergegeven als een matrix van JSON-objecten met eigenschappen voor naam- en waardetekenreeksen, bijvoorbeeld {"name" : "name value", "value": "a value"}.

properties.tokenEndpoint

string

OAuth-tokeneindpunt. Bevat een absolute URI naar de entiteit waarnaar wordt verwezen.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

BearerTokenSendingMethod

Hiermee geeft u het mechanisme op waarmee het toegangstoken wordt doorgegeven aan de API.

Name Type Description
authorizationHeader

string

query

string

ClientAuthenticationMethod

Verificatiemethode die wordt ondersteund door het tokeneindpunt van deze autorisatieserver. Mogelijke waarden zijn Basic en/of Hoofdtekst. Wanneer hoofdtekst is opgegeven, worden clientreferenties en andere parameters doorgegeven in de aanvraagbody in de indeling application/x-www-form-urlencoded.

Name Type Description
Basic

string

Basismethode voor clientverificatie.

Body

string

Verificatiemethode op basis van hoofdtekst.

ErrorFieldContract

Fout Veldcontract.

Name Type Description
code

string

Foutcode op eigenschapsniveau.

message

string

Door mensen leesbare weergave van fout op eigenschapsniveau.

target

string

Naam van eigenschap.

ErrorResponse

Foutreactie.

Name Type Description
error.code

string

Door de service gedefinieerde foutcode. Deze code fungeert als een substatus voor de HTTP-foutcode die is opgegeven in het antwoord.

error.details

ErrorFieldContract[]

De lijst met ongeldige velden verzenden in aanvraag, in het geval van een validatiefout.

error.message

string

Door mensen leesbare weergave van de fout.

GrantType

Vorm van een autorisatietoekenning, die de client gebruikt om het toegangstoken aan te vragen.

Name Type Description
authorizationCode

string

Stroom voor het verlenen van autorisatiecode zoals beschreven https://tools.ietf.org/html/rfc6749#section-4.1.

clientCredentials

string

Stroom voor het verlenen van clientreferenties zoals beschreven https://tools.ietf.org/html/rfc6749#section-4.4.

implicit

string

Impliciete stroom voor het verlenen van code zoals beschreven https://tools.ietf.org/html/rfc6749#section-4.2.

resourceOwnerPassword

string

Stroom voor wachtwoordtoestemming van resource-eigenaar zoals beschreven https://tools.ietf.org/html/rfc6749#section-4.3.

TokenBodyParameterContract

OAuth acquire token request body parameter (www-url-form-encoded).

Name Type Description
name

string

naam van de hoofdparameter.

value

string

parameterwaarde body.