GetOAuthV1Info ポリシー

概要

トークンとキーの属性を取得し、これらの属性値をフロー変数に設定します。このポリシータイプは、構成トークンやキーの値に基づいて条件付きの動的動作を構成する場合に便利な場合があります。トークンが検証されるたびに、トークン属性の値が自動的に変数へ設定されます。ただしトークン検証が行われていない場合は、この機能を使って変数にこれらの属性値を明示的に設定できます。OAuth v1.0a ポリシーもご覧ください。

要素リファレンス

要素リファレンスでは、GetOAuthV1Info ポリシーの要素と属性について説明します。

<GetOAuthV1Info async="false" continueOnError="false" enabled="true" name="Get-OAuth-v10a-Info-1">
    <DisplayName>Get OAuth v1.0a Info-1</DisplayName>
    <ConsumerKey ref="{flow.variable}">{value}</ConsumerKey>
    <RequestToken ref="{flow.variable}">{request token}</RequestToken>
    <AccessToken ref="{flow.variable}">{access token}</AccessToken>
    <OAuthConfig ref="{flow.variable}">{config}</OAuthConfig>
</GetOAuthV1Info>

<GetOAuthV1Info> の属性

<GetOAuthV1Info async="false" continueOnError="false" enabled="true" name="Get-OAuth-v10a-Info-1">

次の表に、すべてのポリシーの親要素に共通する属性を示します。

属性 説明 デフォルト 要否
name

ポリシーの内部名。name 属性の値には、英字、数字、スペース、ハイフン、アンダースコア、ピリオドを使用できます。この値は 255 文字を超えることはできません。

管理 UI プロキシ エディタで <DisplayName> 要素を追加して、ポリシーのラベルに使用する別の自然言語名を指定することもできます。

なし 必須
continueOnError

ポリシーが失敗したときにエラーを返す場合は、false に設定します。これは、ほとんどのポリシーで想定される動作です。

ポリシーが失敗した後もフローの実行を続行する場合は、true に設定します。

false 任意
enabled

ポリシーを適用するには、true に設定します。

ポリシーを無効にするには、false に設定します。ポリシーがフローに接続されている場合でも適用されません。

true 任意
async

この属性は非推奨となりました。

false 非推奨

<DisplayName> 要素

管理 UI プロキシ エディタで name 属性と一緒に使用して、ポリシーのラベルに使用する自然言語名を指定します。

<DisplayName>Policy Display Name</DisplayName>
デフォルト

なし

この要素を省略した場合、ポリシーの name 属性の値が使用されます。

要否 任意
種類 文字列

<AccessToken> 要素

アクセス トークンを検証して、すべての属性を取得します。このリソースは、変数 flow.resource.name のフローで設定する必要があります。成功すると、属性はフロー変数として使用できます。アクセス トークン文字列またはリテラルのトークン文字列(まれなケース)のどちらかが入った変数を渡します。次の例では、アクセス トークンはリクエストで渡されたクエリ パラメータから取得されます。

<AccessToken ref="request.queryparam.access_token"></AccessToken>

デフォルト:

request.formparam.access_tokenx-www-form-urlencoded、リクエスト本文で指定)

要否:

省略可

型: 文字列
有効な値:

アクセス トークン文字列が入ったフロー変数、またはリテラル文字列のどちらか。

<ConsumerKey> 要素

プロファイルのコンシューマ キーを取得します。アクセス トークン文字列またはリテラルのトークン文字列(まれなケース)のどちらかが入った変数を渡します。次の例では、アクセス トークンはリクエストで渡されたクエリ パラメータから取得されます。

<ConsumerKey ref="request.queryparam.consumer_key"></ConsumerKey>

デフォルト:

request.formparam.consumer_keyx-www-form-urlencoded、リクエスト本文で指定)

要否:

省略可

型: 文字列
有効な値:

アクセス トークン文字列が入ったフロー変数、またはリテラル文字列のどちらか。

<OAuthConfig> 要素

OAuth 構成情報を検証します。

<OAuthConfig ref="request.queryparam.oauth_config"></OAuthConfig>

デフォルト:

request.formparam.access_tokenx-www-form-urlencoded、リクエスト本文で指定)

要否:

省略可

型: 文字列
有効な値:

アクセス トークン文字列が入ったフロー変数、またはリテラル文字列のどちらか。

<RequestToken> 要素

プロファイルのリクエスト トークンを取得します。アクセス トークン文字列またはリテラルのトークン文字列(まれなケース)のどちらかが入った変数を渡します。次の例では、アクセス トークンはリクエストで渡されたクエリ パラメータから取得されます。

<RequestToken ref="request.queryparam.request_token"></RequestToken>

デフォルト:

request.formparam.request_tokenx-www-form-urlencoded、リクエスト本文で指定)

要否:

省略可

型: 文字列
有効な値:

アクセス トークン文字列が入ったフロー変数、またはリテラル文字列のどちらか。

フロー変数

GetOAuthV1Info ポリシーはこれらの変数に値を設定し、通常は、認可または検証がまだ行われていないが、プロファイル データが必要な場合に使用されます。

コンシューマ キー変数

以下の変数は、<ConsumerKey> オペレーションが実行されると、値が設定されます。

oauthconsumer.{policy_name}.oauth_consumer_key
oauthconsumer.{policy_name}.oauth_consumer_key
oauthconsumer.{policy_name}.{app_attribute_name}
oauthconsumer.{policy_name}.{app_key_attribute_name}

アクセス トークンおよびリクエスト トークンの変数

以下の変数は、<AccessToken> または <RequestToken> のオペレーションが実行されると、値が設定されます。

oauth_token
oauth_token_secret
developer.app.name
developer.id
apiproduct.name
apiproduct.<custom_attribute_name>

ポリシー固有のエラーコード

OAuth HTTP エラー レスポンス リファレンスをご覧ください。

スキーマ

各ポリシータイプは XML スキーマ(.xsd)によって定義されます。参照用のポリシー スキーマは GitHub から入手できます。

エラーコード

Get OAuth v1.0a Info ポリシーにエラーコードが指定されていません。

関連トピック