メインコンテンツまでスキップ

condition（条件式）

condition は「この処理を実行するか」を設定で表すための共通の仕組みです。JSONPath で値を取り出し、演算子で判定します。

同じ形式が複数の場所で使われます。

使う場所効果
execution.http_requests[].conditionそのHTTPリクエストを送るかどうか（認証 / フェデレーション）
*_mapping_rules[].conditionそのマッピングルールを適用するかどうか
身元確認の pre_hook 各種そのパラメータ解決・検証を行うかどうか
http_requests（複数形）でだけ効きます

condition は http_request / http_requests 共通の設定クラスのフィールドなので、単発の http_request にも書けて GET でも返りますが、無視されます（分岐する相手がいないため）。実際に評価するのは複数リクエストを順に回す2つの executor だけです。

  • 認証 interaction の execution.http_requests[]
  • フェデレーション userinfo の userinfo_execution.http_requests[]

基本形​

{
  "operation": "eq",
  "path": "$.response_body.status",
  "value": "approved"
}
フィールド説明
operation演算子（必須）
path判定対象を取り出す JSONPath（allOf / anyOf 以外では必須）
value比較値（exists / missing では不要）

演算子​

operation判定備考
eq等しい
ne等しくない
gt / gte / lt / lte数値比較BigDecimal で比較するため 18 と "18.0" は等しい。null や数値化できない値は例外扱い（下記）
invalue の配列に含まれるvalue が配列でない場合は常に false
ninvalue の配列に含まれない同上
exists値が存在する（null でない）value 不要
missing値が存在しない（null）value 不要
contains包含する
regex正規表現にマッチする

未知の operation は false と判定されます。

複合条件​

allOf（AND）/ anyOf（OR）で入れ子にできます。path は不要で、value にネストした条件の配列を置きます。

{
  "operation": "allOf",
  "value": [
    { "operation": "exists", "path": "$.response_body.score" },
    { "operation": "gte", "path": "$.response_body.score", "value": 80 }
  ]
}
  • ネストの中にさらに allOf / anyOf を書けます
  • 深さの上限は 10（idp.condition.maxDepth で変更可）。超えると warn を出して false
  • 空の allOf は true、空の anyOf は false

not に相当する演算子はありません。否定は ne / nin / missing で表現してください。

判定できないときは false になります​

判定できなかった条件は false になります。 例外は投げません。そのため「実行しない」側に倒れます。

パターン結果ログ
path が解決しない（キーが存在しない・添字が範囲外）値は null。eq なら false、missing なら trueなし（未解決パスは debug 止まり）
gt / gte / lt / lte で対象が nullfalseなし（比較前に null で打ち切るため）
gt / gte / lt / lte で対象が非数値例外 → falsewarn
in / nin の value が配列でないfalseなし
未知の operationfalseなし

warn が出るのは例外を捕まえたときだけです。最も起きやすいパス綴り違いでは何も出ません。

無条件に実行されるより安全ですが、設定ミスが静かなスキップとして現れます。

全リクエストがスキップされた場合はエラーになります

http_requests に設定したすべてのリクエストがスキップされた場合、処理は失敗します（成功にはなりません）。

外部サービスの呼び出しそのものが検証（外部パスワード認証、リスク判定、上流IdPの userinfo 取得）である以上、1本も実行されていなければ何も検証できていないためです。ここで成功にすると、条件のパスを1文字間違えただけで「外部サービスに一度も問い合わせないまま認証ステップが通る」状態になります。

一部だけスキップされた通常の分岐は、これに該当しません。

数値比較を使うときは、値の存在を先に確かめると意図しないスキップを避けられます。

{
  "operation": "allOf",
  "value": [
    { "operation": "exists", "path": "$.response_body.score" },
    { "operation": "gte", "path": "$.response_body.score", "value": 80 }
  ]
}
解決しないパスはエラーになりません

$.responseBody.status のような綴り違いを書いても、設定の登録も GET も成功します。実行時に値が null になるだけで、どこにも報告されません。パスを書いたら実際に動かして確かめてください。

path に何を書けるか​

参照できるキーは使う場所ごとに異なります。条件を書く前に、その場所のドキュメントでコンテキストを確認してください。

使う場所参照先
認証の http_requests外部トークン認証の設定
フェデレーションの http_requestsフェデレーションの設定
マッピングルールマッピングと JSONPath