サード・パーティー・アセスメントの有効化の概要

Webhook 構成の作成

リアルタイムWebhookの設定は、サードパーティのリスクプロバイダーに関連付ける必要があります。 リアルタイムWebhookは、Verifyとサードパーティのリスク管理サービスとの間で、技術的な実行時統合を実現します。 サードパーティのリスクを算出するには、事前にリアルタイムWebhookの設定を完了しておく必要があります。

サードパーティのリスクプロバイダーに対応している可能性のある、架空のリアルタイムWebhook設定：

{
  "name": "some name",
  "type": "realtime",
  "urls": [
    "https://somedomain.com/1351/app_proxy/api/risk"
  ],
  "authentication": {
    "header": {
      "values": [
        {
          "key": "SEC",
          "value": "some-value"
        }
      ]
    },
    "type": "header"
  }
  "purpose": [
    "external_risk"
  ],
  "notification": null
}

サード・パーティー統合構成の作成

サード・パーティー・リスク統合ごとに、構成を作成する必要があります。 この構成オブジェクトは、使用される Webhook (Webhook ID) および Verify 内部属性を識別します。 Verifyの内部コンポーネントは、評価のために（リアルタイムのWebhookを通じて）サードパーティにデータを送信する必要があります。

アクセス・ポリシー・フレームワークには、この構成の作成と管理を可能にする API のセットが用意されています。

POST '/integrations/v1.0/config' \
'Content-Type: application/json' \
'Accept: application/json' \

{
        "WebhookId": "some-Webhook-id",
        "name": "some third party integration",
        "version": 1,
        "evaluationOutboundAttributes": {
            "sessionContext": {
                ...
            },
            "attributeContext": {
                ...
            },
            "policyContext": {
                ...
            },
            "adaptiveContext": {
                ...
            }
        },
        "supportedAttributes": [],
        "integrationProcessingEndpoint": {
            "redirectUri": ""
        }
}

統合構成応答ペイロードの例を以下に示します。

{
        "id" : "config-id"
        "WebhookId": "some-Webhook-id",
        "referenceId": "reference-id",
        "created": "created timestamp",
        "name": "some third  integration",
        "version": 1,
        "evaluationOutboundAttributes": {
            "sessionContext": {
                ...
            },
            "attributeContext": {
                ...
            },
            "policyContext": {
                ...
            },
            "adaptiveContext": {
                ...
            }
        },
        "supportedAttributes": [],
        "integrationProcessingEndpoint": {
            "redirectUri": ""
        }
}

架空のサード・パーティー構成オブジェクト:

{
    "WebhookId": "some-Webhook-id",
    "name": "some third party integration",
    "version": 1,
    "evaluationOutboundAttributes": {
        "sessionContext": {
            "uid": true,
            "groupIds": false
        },
        "attributeContext": {
            "appId": false,
            "ipAddress": true
        },
        "policyContext": {
            "id": true,
            "policyName": true
        },
        "adaptiveContext": {
            "city": true
        }
    },
    "supportedAttributes": [],
    "integrationProcessingEndpoint": {
        "redirectUri": ""
    }
}

アクセス・ポリシー・オブジェクトの作成

Verify のアクセス・ポリシー・フレームワークは、Verify 内部コンポーネントがサード・パーティー・プロバイダーからの外部リスクを計算するためのメカニズムを提供します。 Verifyの内部コンポーネントは、このアクセスポリシーオブジェクトを評価し、ステップ2で作成されたサードパーティ連携の設定を参照して、サードパーティ連携へ（リアルタイムWebhookを介して）データを送信します。 これにより、外部リスクまたは属性についての拡張を行うことができます。

アクセス・ポリシー・オブジェクト内でサード・パーティー・リスク統合を有効にするためのフォーマット:

{
      "name": "3rd Party Risk Evaluation",
      "alwaysRun": true,
      "conditions": [ {
        "type":"integrationAttributes":,
        "id" : "<configId>"
        }]
      },
      "result": {
        "action": "ACTION_MFA_ALWAYS",
        "serverSideActions": {[]},
        "authnMethods": <["urn:ibm:security:authentication:asf:macotp"]> or <["smsotp", "emailotp", ....]>
      }
    }

ポリシーの作成と管理のためのアクセス・ポリシーとリスク・ポリシーの API を参照してください。

サード・パーティー統合条件を持つアクセス・ポリシー・オブジェクトの例を以下に示します。

{
    "name": "3rd Party Integration via webhooks",
    "description": "",
    "rules": [
        {
            "id": "1",
            "name": "3rd party provider",
            "alwaysRun": true,
            "firstFactor": false,
            "conditions": [
                {
                    "type": "integrationAttributes",
                    "id": "16a1f2fb-c43f-4a0e-b294-1b25a87a9546"
                }
            ],
            "result": {
                "action": "ACTION_ALLOW",
                "serverSideActions": [],
                "authnMethods": [
                    "urn:ibm:security:authentication:asf:macotp"
                ]
            }
        },
        {
            "id": "1634292657617",
            "name": "Colour Severity",
            "description": "",
            "alwaysRun": false,
            "firstFactor": false,
            "conditions": [
                {
                    "type": "customAttributes",
                    "customAttributes": [
                        {
                            "name": "external_risk_score",
                            "opCode": "EQ",
                            "values": [
                                "4"
                            ]
                        }
                    ],
                    "firstFactor": false
                }
            ],
            "result": {
                "action": "ACTION_DENY",
                "serverSideActions": [],
                "authnMethods": []
            }
        },
        {
            "id": "1634292240488",
            "name": "Default rule",
            "description": "",
            "alwaysRun": false,
            "firstFactor": false,
            "conditions": [],
            "result": {
                "action": "ACTION_ALLOW",
                "serverSideActions": [],
                "authnMethods": [
                    "urn:ibm:security:authentication:asf:macotp"
                ]
            }
        }
    ],
    "meta": {
        "label": "initial policy",
        "state": "ACTIVE",
        "scope": [
            "developers"
        ],
        "schema": "urn:access:policy:5.0:schema",
        "enforcementType": "fedSSO"
    }
}

• このアクセス・ポリシー・オブジェクトは、id フィールドによって構成が識別されるサード・パーティーのリスク統合を示します。
• integrationAttributes とは別に、ポリシーには customAttributes 条件もあります。 カスタム属性 external_risk_score は、サード・ パーティー・リスク統合によって値が提供される属性です。

アクセスポリシーオブジェクトを作成したら、それを対象のユーザーアプリケーションに紐付けます。