このトピックでは、IP リスクアセスメントのサービスイベントパラメーターについて説明します。
サービスイベントパラメーター
サービスイベントパラメーターは、共通パラメーターの `ServiceParameters` フィールドで渡され、JSON フォーマットである必要があります。次の表に、IP リスクアセスメント - イベントパラメーター を示します。
フィールド名 | フィールドの説明 | データフォーマット | サンプルデータ | 必須 |
ip | 分析対象の IPv4 アドレス。 | 文字列 | 42.120.XX.XX | 必須 |
カスタム戻りパラメーター
共通の戻りパラメーターに加えて、応答には `Data` フィールドにカスタムパラメーターが含まれます。`Data` パラメーターの `score` の値の範囲は 0～1 です。値が大きいほど、動作のリスクの程度が高くなります。次の表は、スコアに基づく推奨脅威レベルを示しています。これらの推奨事項は Alibaba Cloud リスク管理チームによるものですが、ビジネスニーズに合わせてこれらの範囲を調整することもできます。
このサービスから返される Data パラメーターのスコア値の範囲は 0～1 です。値が大きいほど、動作のリスクの程度が高くなります。
値の範囲 | 脅威レベル |
0～0.6 | 低リスク |
0.6～0.8 | 中程度の脅威 |
0.8～0.95 | 中〜高リスク |
0.95～1 | 高リスク |
`Extend` データは JSON フォーマットで、次の値が含まれます。
値 | 説明 |
country | 国またはリージョンの名前。例：China。 |
province | 省の名前。例：Zhejiang。 |
city | 都市の名前。例：Hangzhou。 |
isIdc | IP アドレスがデータセンターに属しているかどうかを示します。値 1 は「はい」を、0 は「いいえ」を意味します。 |
isProxy | IP アドレスがプロキシ IP アドレスであるかどうかを示します。値 1 は「はい」を、0 は「いいえ」を意味します。 |
isNat | IP アドレスが NAT IP アドレスであるかどうかを示します。値 1 は「はい」を、0 は「いいえ」を意味します。 |
isBase | IP アドレスが基地局 IP アドレスであるかどうかを示します。値 1 は「はい」を、0 は「いいえ」を意味します。 |
このサービスの JSON の例を次に示します。
{
"Data": {
"score": 0.35, // リスクスコア、0～1。形式は double です。
"extend": "{\"country\":\"Thailand\",\"province\":\"\",\"city\":\"\",\"isIdc\":\"0\",\"isProxy\":\"0\",\"isNat\":\"0\",\"isBase\":\"0\"}"// 拡張フィールド。
},
"Message": "OK",
"Code": 200, // 200 はリクエストが成功したことを示します。
"RequestId":"4EF9AEE5-288F-4176-8110-00EDC91A614E"
}