メインコンテンツへスキップ
Auth0 Supplemental Signals は現在 Early Access 段階にあります。この機能を使用することにより、Okta の Master Subscription Agreement に定める該当の Free Trial 条項に同意したものとみなされます。Auth0 製品のリリース段階の詳細については、Product Release Stages を参照してください。
開始する前にAkamai を構成して補足シグナルをお使いの Auth0 テナントに送信するには、Akamai をリバース プロキシとして構成しておく必要があります。
Akamai Bot Manager および/または Akamai Account Protector を使用している場合、Akamai のリバース プロキシを構成して結果を Auth0 に送信し、その結果を Actions で利用できます。

​
サポートされているログインフロー

Auth0 は現在、Akamai 補足シグナル向けに次のログインフローをサポートしています。

​
ステップ 1: Akamai に API を登録する

Akamai がログイン試行の成否を把握できるようにするには、Akamai で API を登録し、その後、サポートしたい各 Auth0 ログインフローごとにエンドポイントを定義する必要があります。 詳細については、Register an API on Akamai TechDocs および Add API resources on Akamai TechDocs を参照してください。
Akamai に API を登録するには、以下の値を使用します:
項目値
API ベースパス/u
API キーの送信先Header
APIを作成した後、以下の各Auth0エンドポイントに対してAPIリソースを追加する必要があります:
  • /u/login/password
  • /u/signup
  • /u/signup/password
すべてのエンドポイントで手順は同じですが、設定値は若干異なります。

​
API リソースを追加する

Akamai API でリソースを構成するには、以下の値を使用します:
プロパティ値
API で未定義のパラメータSpecific (Request body)
パス/login/password
メソッドPOST

​
メソッドにパラメータを追加する

APIリソースを作成した後、Akamaiがログインリクエストを正しく解析できるように、Request bodyパラメータを定義する必要があります。以下の値を使用して Request body パラメータを定義してください:
プロパティ値
形式JSON
必須Yes
本文形式を定義Yes
スキーマの詳細以下を参照
{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "state"
          ],
          "properties": {
            "state": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "username": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "action": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
}
Akamai に API を登録するには、以下の値を使用します:
プロパティ値
API のベースパス/u
API キーの送信先Header
APIを作成した後、以下の各Auth0エンドポイントに対してAPIリソースを追加する必要があります:
  • /u/login
  • /u/signup
  • /u/signup/password
すべてのエンドポイントで手順は同じですが、設定値は若干異なります。

​
API リソースを追加する

Akamai API でリソースを構成するには、以下の値を使用します:
プロパティ値
API の未定義パラメータSpecific (Request body)
パス/login
メソッドPOST

​
メソッドにパラメータを追加する

APIリソースを作成した後、Akamaiがログインリクエストを正しく解析できるように、Request bodyパラメータを定義する必要があります。以下の値を使用して Request body パラメータを定義してください:
プロパティ値
フォーマットJSON
必須Yes
本文フォーマットの定義Yes
スキーマの詳細以下を参照
{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "state"
          ],
          "properties": {
            "state": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "username": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "action": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
}
Akamai で API を登録するには、次の値を使用します。
プロパティ値
API ベースパスなし
API キーの場所Header
API を作成したら、次の各 Auth0 エンドポイントに対して API リソースを追加する必要があります。
  • /oauth/token
手順はすべてのエンドポイントで同じですが、設定値が少し異なります。

​
API リソースを追加する

Akamai の API 上でリソースを構成するには、次の値を使用します。
プロパティ値
API undefined parametersSpecific (Request body)
Path/oauth/token
MethodsPOST

​
メソッドにパラメーターを追加する

API リソースを作成した後、Akamai がログインリクエストを正しく解析できるように、Request body パラメーターを定義する必要があります。Request body パラメーターを定義するには、次の値を使用します。
プロパティ値
FormatJSON
RequiredYes
Define body formatYes
Schema details以下を参照。
{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "username": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
}

​
ステップ 2: Akamai から Auth0 にボット判定結果を転送する

Akamai を設定してボット判定結果を Auth0 に転送するには、Forward Bot Results to Origin on Akamai TechDocs を参照してください。
akamai-user-risk ヘッダーは、すべてのログインリクエストに必ず含まれるわけではありません。Akamai がユーザーリスクスコアを生成した場合にのみ、このヘッダーを送信します。

​
Step 3: Auth0 で Akamai ヘッダーの処理を有効化する

Auth0 Dashboard または Auth0 Management API を使用して、Akamai から送信される補足シグナルを Auth0 が受信して処理できるように構成できます。
Dashboard で補足シグナルを有効にするには:
  1. Dashboard > Security > Attack Protection に移動します。
  2. Supplemental Signals を選択します。
  3. Enable Akamai headers のトグルをオンにします。

​
ステップ 4: 構成をテストして検証する

構成したログインフローごとに各エンドポイントを呼び出して、構成をテストします。 すべてを正しく構成できていれば、次のようになります。
  • 関連するイベントについて、テナントログに akamai-user-risk および akamai-bot ヘッダーが含まれます。
  • Post Login Action の event オブジェクトで、次のプロパティを使用できます。
    • authentication.riskAssessment.supplemental.akamai.akamaiBot
    • authentication.riskAssessment.supplemental.akamai.akamaiUserRisk