AMLスクリーニングの警告とアラートコード

概要

AMLスクリーニングは、aml_screenings[]の各エントリーにあるwarnings[]配列に、少数の警告タグを出力します。以下の2つのタグが、Diditが生成するAML警告のすべてです。ヒットに表示されるそれ以外の情報は、警告としてではなく、ヒット自体のフィールド（risk_view、match_score、risk_score、sanction_matches[]、…）に格納されます。ワークフローのセッションとスタンドアロンのAML APIは、どちらも同じ方法でPOSSIBLE_MATCH_FOUNDを出力します。 AMLレコードで返されるステータス（Approved、In Review、Declined）は、scoreの集計値と設定したしきい値から決まります。警告タグは同じ条件を示すため、プログラムからそれらに対応できます。しきい値とステータスの対応については、AMLリスクスコアを参照してください。

生成される警告

リスク	原因	`log_type`	ステータスへの影響	推奨される対処
`POSSIBLE_MATCH_FOUND`	集計`score`が0ではなく、`aml_score_approve_threshold`（デフォルト`80`）を超えています。つまり、一致の可能性があるヒットのうち少なくとも1件が、設定したリスク帯域を超えています。（スタンドアロンのAML APIでは、スコアがしきい値とちょうど等しい場合にも出力されます。）	`warning`。スコアが`aml_score_review_threshold`（デフォルト`100`）も超える場合は`error`に引き上げられます。	スコアが承認しきい値を超える場合は`In Review`、レビューしきい値を超える場合は`Declined`になります。	`hits[]`の各ヒットを確認します。AMLヒットステータスのエンドポイントを使用して、ヒットを`Confirmed Match`、`False Positive`、`Inconclusive`のいずれかとしてマークします。ヒットを更新すると`data.updated` Webhookが送信されますが、AMLステータスは再計算されません。最終的なステータスは、AMLステータスのエンドポイントまたはコンソールでのレビューで設定してください。
`COULD_NOT_PERFORM_AML_SCREENING`	KYCレコードに`full_name`、`date_of_birth`、`issuing_state`のいずれか1つ以上がありません。課金対象のスクリーニング呼び出しは行われません。	`warning`	強制的に`In Review`になります。	KYCレコードの不足しているフィールドを入力します。3つすべてが揃うとAMLは自動的に再実行され、古い警告ログは削除されるため、手動での再トリガーは不要です。

警告はfeature: "AML"を指定して保存され、標準の警告オブジェクトの形式に従います。

設定可能な項目

ワークフローノードごとのAML制御（スタンドアロンのAML APIのオプションとしても指定できます）:

aml_score_approve_threshold: デフォルト80。これを超える0以外のスコアはPOSSIBLE_MATCH_FOUNDを生成し、AMLチェックをIn Reviewに振り分けます。これ以下のスコアでは、ヒット数に関係なく、セッションのワークフローで警告は生成されません。
aml_score_review_threshold: デフォルト100。これを超えるスコアはAMLチェックを自動的に却下します（デフォルトの100のままでは、値を下げるまでこれが発動することはありません）。
aml_match_score_threshold: デフォルト93。ヒットごとの分類に使われます。match_scoreがこれ未満のヒットはFalse Positiveとして開始し、集計スコアから除外されます。これ以上のヒットはUnreviewedとして開始します。
一致スコアの重み: aml_name_weight / aml_dob_weight / aml_country_weight、デフォルトはそれぞれ60 / 25 / 15です（合計が100である必要があります）。AML一致スコアを参照してください。
継続的なモニタリング: 有効にすると、データセットの変更に応じてAMLが対象者を再スクリーニングし、レポートに加えてstatus.updated（ステータスが変わった場合）またはdata.updated（ヒットが変わった場合）のWebhookを再度送信します。

COULD_NOT_PERFORM_AML_SCREENINGが発生すると、不足している本人情報のフィールドが提供されるまで、AMLチェックはIn Reviewのままになります。Diditが氏名、生年月日、発行州を取得すると、AMLは自動的に再実行され、警告は解消されます。手動での再トリガーはありません。

例

`POSSIBLE_MATCH_FOUND` (スコアが承認しきい値を超える場合)

{
  "warnings": [
    {
      "feature": "AML",
      "risk": "POSSIBLE_MATCH_FOUND",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Possible match found in AML screening",
      "long_description": "The Anti-Money Laundering (AML) screening process identified potential matches with watchlists or high-risk databases, requiring further review.",
      "node_id": "aml-1"
    }
  ]
}

`COULD_NOT_PERFORM_AML_SCREENING` (KYCフィールドが不足している場合)

{
  "warnings": [
    {
      "feature": "AML",
      "risk": "COULD_NOT_PERFORM_AML_SCREENING",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Could not retrieve data from KYC for performing AML Screening",
      "long_description": "The system encountered issues accessing or processing Know Your Customer (KYC) data necessary for conducting the Anti-Money Laundering (AML) screening. please fill the KYC full name, birth date, issuing state and document number to automatically proceed with AML screening.",
      "node_id": "aml-1"
    }
  ]
}

認証

検証

モニタリング

プラットフォーム

AMLスクリーニングの警告とアラートコード

概要

生成される警告

設定可能な項目

例

`POSSIBLE_MATCH_FOUND` (スコアが承認しきい値を超える場合)

`COULD_NOT_PERFORM_AML_SCREENING` (KYCフィールドが不足している場合)

関連情報

警告の種類

​概要

​生成される警告

​設定可能な項目

​例

​POSSIBLE_MATCH_FOUND (スコアが承認しきい値を超える場合)

​COULD_NOT_PERFORM_AML_SCREENING (KYCフィールドが不足している場合)

​関連情報

​警告の種類

概要

生成される警告

設定可能な項目

例

`POSSIBLE_MATCH_FOUND` (スコアが承認しきい値を超える場合)

`COULD_NOT_PERFORM_AML_SCREENING` (KYCフィールドが不足している場合)

関連情報

警告の種類