Microsoft.ApiManagement service/authorizationServers 2021-08-01
- 最新の を
する - 2023-09-01-preview
- 2022-08-01
- 2021-08-01
Bicep リソース定義
service/authorizationServers リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.ApiManagement/service/authorizationServers リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.ApiManagement/service/authorizationServers@2021-08-01' = {
name: 'string'
parent: resourceSymbolicName
properties: {
authorizationEndpoint: 'string'
authorizationMethods: [
'string'
]
bearerTokenSendingMethods: [
'string'
]
clientAuthenticationMethod: [
'string'
]
clientId: 'string'
clientRegistrationEndpoint: 'string'
clientSecret: 'string'
defaultScope: 'string'
description: 'string'
displayName: 'string'
grantTypes: [
'string'
]
resourceOwnerPassword: 'string'
resourceOwnerUsername: 'string'
supportState: bool
tokenBodyParameters: [
{
name: 'string'
value: 'string'
}
]
tokenEndpoint: 'string'
}
}
プロパティ値
service/authorizationServers
名前 | 形容 | 価値 |
---|---|---|
名前 | リソース名 Bicepで子リソースの名前と種類 |
string (必須) 文字制限: 1 ~ 80 有効な文字: 英数字とハイフン。 文字で始まり、英数字で終わる。 |
親 | Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。 詳細については、「親リソースの外部 |
種類のリソースのシンボリック名: サービス |
プロパティ | 外部 OAuth 承認サーバー コントラクトのプロパティ。 | AuthorizationServerContractProperties の |
AuthorizationServerContractProperties
名前 | 形容 | 価値 |
---|---|---|
authorizationEndpoint | OAuth 承認エンドポイント。
http://tools.ietf.org/html/rfc6749#section-3.2. を参照してください |
string (必須) |
authorizationMethods | 承認エンドポイントでサポートされている HTTP 動詞。 GET は常に存在する必要があります。 POST は省略可能です。 | 次のいずれかを含む文字列配列: 'DELETE' 'GET' 'HEAD' 'OPTIONS' 'PATCH' 'POST' 'PUT' 'TRACE' |
bearerTokenSendingMethods | アクセス トークンを API に渡すメカニズムを指定します。 | 次のいずれかを含む文字列配列: 'authorizationHeader' 'query' |
clientAuthenticationMethod | この承認サーバーのトークン エンドポイントでサポートされる認証方法。 使用できる値は Basic または Body です。 Body を指定すると、クライアント資格情報とその他のパラメーターが要求本文内でアプリケーション/x-www-form-urlencoded 形式で渡されます。 | 次のいずれかを含む文字列配列: 'Basic' 'Body' |
clientId | この承認サーバーに登録されているクライアントまたはアプリ ID。 | string (必須) |
clientRegistrationEndpoint | この承認サーバーのクライアントまたはアプリの登録が実行されるページへの省略可能な参照。 参照されるエンティティへの絶対 URL が含まれています。 | string (必須) |
clientSecret | この承認サーバーに登録されているクライアントまたはアプリ シークレット。 このプロパティは'GET' 操作では入力されません。 値を取得するには、'/listSecrets' POST 要求を使用します。 | 糸 制約: 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 |
defaultScope | 既定で要求されるアクセス トークン スコープ。 API レベルでオーバーライドできます。 スペース区切りの値を含む文字列の形式で指定する必要があります。 | 糸 |
形容 | 承認サーバーの説明。 HTML 書式設定タグを含めることができます。 | 糸 |
displayName | ユーザー フレンドリな承認サーバー名。 | string (必須) 制約: 最小長 = 1 最大長 = 50 |
grantTypes | クライアントがアクセス トークンを要求するために使用する承認付与の形式。 | 次のいずれかを含む文字列配列: 'authorizationCode' 'clientCredentials' 'implicit' 'resourceOwnerPassword' (必須) |
resourceOwnerPassword | この承認サーバーでリソース所有者のパスワード許可の種類がサポートされている場合は、必要に応じて指定できます。 既定のリソース所有者のパスワード。 | 糸 |
resourceOwnerUsername | この承認サーバーでリソース所有者のパスワード許可の種類がサポートされている場合は、必要に応じて指定できます。 既定のリソース所有者のユーザー名。 | 糸 |
supportState | true の場合、承認サーバーには、承認要求から応答までの状態パラメーターが含まれます。 クライアントは、状態パラメーターを使用してプロトコル のセキュリティを高める場合があります。 | bool |
tokenBodyParameters | 名前と値の文字列プロパティを持つ JSON オブジェクトの配列として表される、この承認サーバーのトークン エンドポイントに必要な追加パラメーター ({"name" : "name value"、"value": "a value"})。 | TokenBodyParameterContract[] |
tokenEndpoint | OAuth トークン エンドポイント。 参照されるエンティティへの絶対 URI が含まれています。 | 糸 |
TokenBodyParameterContract
名前 | 形容 | 価値 |
---|---|---|
名前 | body パラメーター名。 | string (必須) |
価値 | body パラメーター値。 | string (必須) |
ARM テンプレート リソース定義
service/authorizationServers リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.ApiManagement/service/authorizationServers リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.ApiManagement/service/authorizationServers",
"apiVersion": "2021-08-01",
"name": "string",
"properties": {
"authorizationEndpoint": "string",
"authorizationMethods": [ "string" ],
"bearerTokenSendingMethods": [ "string" ],
"clientAuthenticationMethod": [ "string" ],
"clientId": "string",
"clientRegistrationEndpoint": "string",
"clientSecret": "string",
"defaultScope": "string",
"description": "string",
"displayName": "string",
"grantTypes": [ "string" ],
"resourceOwnerPassword": "string",
"resourceOwnerUsername": "string",
"supportState": "bool",
"tokenBodyParameters": [
{
"name": "string",
"value": "string"
}
],
"tokenEndpoint": "string"
}
}
プロパティ値
service/authorizationServers
名前 | 形容 | 価値 |
---|---|---|
種類 | リソースの種類 | 'Microsoft.ApiManagement/service/authorizationServers' |
apiVersion | リソース API のバージョン | '2021-08-01' |
名前 | リソース名 JSON ARM テンプレートで子リソースの名前と型 |
string (必須) 文字制限: 1 ~ 80 有効な文字: 英数字とハイフン。 文字で始まり、英数字で終わる。 |
プロパティ | 外部 OAuth 承認サーバー コントラクトのプロパティ。 | AuthorizationServerContractProperties の |
AuthorizationServerContractProperties
名前 | 形容 | 価値 |
---|---|---|
authorizationEndpoint | OAuth 承認エンドポイント。
http://tools.ietf.org/html/rfc6749#section-3.2. を参照してください |
string (必須) |
authorizationMethods | 承認エンドポイントでサポートされている HTTP 動詞。 GET は常に存在する必要があります。 POST は省略可能です。 | 次のいずれかを含む文字列配列: 'DELETE' 'GET' 'HEAD' 'OPTIONS' 'PATCH' 'POST' 'PUT' 'TRACE' |
bearerTokenSendingMethods | アクセス トークンを API に渡すメカニズムを指定します。 | 次のいずれかを含む文字列配列: 'authorizationHeader' 'query' |
clientAuthenticationMethod | この承認サーバーのトークン エンドポイントでサポートされる認証方法。 使用できる値は Basic または Body です。 Body を指定すると、クライアント資格情報とその他のパラメーターが要求本文内でアプリケーション/x-www-form-urlencoded 形式で渡されます。 | 次のいずれかを含む文字列配列: 'Basic' 'Body' |
clientId | この承認サーバーに登録されているクライアントまたはアプリ ID。 | string (必須) |
clientRegistrationEndpoint | この承認サーバーのクライアントまたはアプリの登録が実行されるページへの省略可能な参照。 参照されるエンティティへの絶対 URL が含まれています。 | string (必須) |
clientSecret | この承認サーバーに登録されているクライアントまたはアプリ シークレット。 このプロパティは'GET' 操作では入力されません。 値を取得するには、'/listSecrets' POST 要求を使用します。 | 糸 制約: 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 |
defaultScope | 既定で要求されるアクセス トークン スコープ。 API レベルでオーバーライドできます。 スペース区切りの値を含む文字列の形式で指定する必要があります。 | 糸 |
形容 | 承認サーバーの説明。 HTML 書式設定タグを含めることができます。 | 糸 |
displayName | ユーザー フレンドリな承認サーバー名。 | string (必須) 制約: 最小長 = 1 最大長 = 50 |
grantTypes | クライアントがアクセス トークンを要求するために使用する承認付与の形式。 | 次のいずれかを含む文字列配列: 'authorizationCode' 'clientCredentials' 'implicit' 'resourceOwnerPassword' (必須) |
resourceOwnerPassword | この承認サーバーでリソース所有者のパスワード許可の種類がサポートされている場合は、必要に応じて指定できます。 既定のリソース所有者のパスワード。 | 糸 |
resourceOwnerUsername | この承認サーバーでリソース所有者のパスワード許可の種類がサポートされている場合は、必要に応じて指定できます。 既定のリソース所有者のユーザー名。 | 糸 |
supportState | true の場合、承認サーバーには、承認要求から応答までの状態パラメーターが含まれます。 クライアントは、状態パラメーターを使用してプロトコル のセキュリティを高める場合があります。 | bool |
tokenBodyParameters | 名前と値の文字列プロパティを持つ JSON オブジェクトの配列として表される、この承認サーバーのトークン エンドポイントに必要な追加パラメーター ({"name" : "name value"、"value": "a value"})。 | TokenBodyParameterContract[] |
tokenEndpoint | OAuth トークン エンドポイント。 参照されるエンティティへの絶対 URI が含まれています。 | 糸 |
TokenBodyParameterContract
名前 | 形容 | 価値 |
---|---|---|
名前 | body パラメーター名。 | string (必須) |
価値 | body パラメーター値。 | string (必須) |
Terraform (AzAPI プロバイダー) リソース定義
service/authorizationServers リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- リソース グループの
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.ApiManagement/service/authorizationServers リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ApiManagement/service/authorizationServers@2021-08-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
authorizationEndpoint = "string"
authorizationMethods = [
"string"
]
bearerTokenSendingMethods = [
"string"
]
clientAuthenticationMethod = [
"string"
]
clientId = "string"
clientRegistrationEndpoint = "string"
clientSecret = "string"
defaultScope = "string"
description = "string"
displayName = "string"
grantTypes = [
"string"
]
resourceOwnerPassword = "string"
resourceOwnerUsername = "string"
supportState = bool
tokenBodyParameters = [
{
name = "string"
value = "string"
}
]
tokenEndpoint = "string"
}
})
}
プロパティ値
service/authorizationServers
名前 | 形容 | 価値 |
---|---|---|
種類 | リソースの種類 | "Microsoft.ApiManagement/service/authorizationServers@2021-08-01" |
名前 | リソース名 | string (必須) 文字制限: 1 ~ 80 有効な文字: 英数字とハイフン。 文字で始まり、英数字で終わる。 |
parent_id | このリソースの親であるリソースの ID。 | 種類のリソースの ID: サービス |
プロパティ | 外部 OAuth 承認サーバー コントラクトのプロパティ。 | AuthorizationServerContractProperties の |
AuthorizationServerContractProperties
名前 | 形容 | 価値 |
---|---|---|
authorizationEndpoint | OAuth 承認エンドポイント。
http://tools.ietf.org/html/rfc6749#section-3.2. を参照してください |
string (必須) |
authorizationMethods | 承認エンドポイントでサポートされている HTTP 動詞。 GET は常に存在する必要があります。 POST は省略可能です。 | 次のいずれかを含む文字列配列: "DELETE" "GET" "HEAD" "OPTIONS" "PATCH" "POST" "PUT" "TRACE" |
bearerTokenSendingMethods | アクセス トークンを API に渡すメカニズムを指定します。 | 次のいずれかを含む文字列配列: "authorizationHeader" "query" |
clientAuthenticationMethod | この承認サーバーのトークン エンドポイントでサポートされる認証方法。 使用できる値は Basic または Body です。 Body を指定すると、クライアント資格情報とその他のパラメーターが要求本文内でアプリケーション/x-www-form-urlencoded 形式で渡されます。 | 次のいずれかを含む文字列配列: "Basic" "Body" |
clientId | この承認サーバーに登録されているクライアントまたはアプリ ID。 | string (必須) |
clientRegistrationEndpoint | この承認サーバーのクライアントまたはアプリの登録が実行されるページへの省略可能な参照。 参照されるエンティティへの絶対 URL が含まれています。 | string (必須) |
clientSecret | この承認サーバーに登録されているクライアントまたはアプリ シークレット。 このプロパティは'GET' 操作では入力されません。 値を取得するには、'/listSecrets' POST 要求を使用します。 | 糸 制約: 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 |
defaultScope | 既定で要求されるアクセス トークン スコープ。 API レベルでオーバーライドできます。 スペース区切りの値を含む文字列の形式で指定する必要があります。 | 糸 |
形容 | 承認サーバーの説明。 HTML 書式設定タグを含めることができます。 | 糸 |
displayName | ユーザー フレンドリな承認サーバー名。 | string (必須) 制約: 最小長 = 1 最大長 = 50 |
grantTypes | クライアントがアクセス トークンを要求するために使用する承認付与の形式。 | 次のいずれかを含む文字列配列: "authorizationCode" "clientCredentials" "implicit" "resourceOwnerPassword" (必須) |
resourceOwnerPassword | この承認サーバーでリソース所有者のパスワード許可の種類がサポートされている場合は、必要に応じて指定できます。 既定のリソース所有者のパスワード。 | 糸 |
resourceOwnerUsername | この承認サーバーでリソース所有者のパスワード許可の種類がサポートされている場合は、必要に応じて指定できます。 既定のリソース所有者のユーザー名。 | 糸 |
supportState | true の場合、承認サーバーには、承認要求から応答までの状態パラメーターが含まれます。 クライアントは、状態パラメーターを使用してプロトコル のセキュリティを高める場合があります。 | bool |
tokenBodyParameters | 名前と値の文字列プロパティを持つ JSON オブジェクトの配列として表される、この承認サーバーのトークン エンドポイントに必要な追加パラメーター ({"name" : "name value"、"value": "a value"})。 | TokenBodyParameterContract[] |
tokenEndpoint | OAuth トークン エンドポイント。 参照されるエンティティへの絶対 URI が含まれています。 | 糸 |
TokenBodyParameterContract
名前 | 形容 | 価値 |
---|---|---|
名前 | body パラメーター名。 | string (必須) |
価値 | body パラメーター値。 | string (必須) |