Akamai から Supplemental Signals を送信するよう設定する

Akamai をリバースプロキシとして設定し、Supplemental Signals を Auth0 テナントに送信します。

Supplemental Signals はエンタープライズのお客様向け機能です。利用するには、アタックプロテクション アドオンをリクエストする必要があります。詳細については、Auth0 Salesにお問い合わせください。

開始前に

Akamai から Supplemental Signals を Auth0 テナントに送信するよう設定するには、まず Akamai をリバースプロキシとして設定する必要があります。

Akamai Bot Manager や Akamai Account Protector を使用している場合は、Akamai でリバースプロキシを設定してその結果を Auth0 に送信し、その結果を Actions で利用できます。

​

サポートされているLogin フロー

Auth0 は現在、Supplemental Signals で次のLogin フローをサポートしています。

• Universal Login: 識別子 + パスワード
  • Universal Login: 先に識別子を入力
  • Universal Login: データベース接続でのサインアップ
  • Universal Login: Auth0 組織を含むパスワードリセット
  • リソースオーナーパスワードグラント (ROPG)

​

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

ログイン試行の成功または失敗を Akamai が把握できるようにするには、まず Akamai で API を登録し、サポートする Auth0 の各Login フローに対応するエンドポイントを定義する必要があります。

詳細については、Akamai TechDocs の Register an API および Akamai TechDocs の Add API resources を参照してください。

新しい Universal Login の識別子 + パスワード

以下の値を使用して、AkamaiにAPIを登録します。

プロパティ	値
APIベースパス	/u
APIキーの指定場所	ヘッダー

APIを作成したら、次のAuth0エンドポイントそれぞれにAPIリソースを追加する必要があります。

• /u/login/password
• /u/signup
• /u/signup/password

すべてのエンドポイントで手順は同じですが、設定値は若干異なります。

​

APIリソースの追加

以下の値を使用して、Akamai APIのリソースを設定します。

/u/login/password

プロパティ	値
API の未定義パラメーター	Specific (Request body)
パス	/login/password
メソッド	POST

/u/signup

プロパティ	値
API の未定義パラメーター	Specific (Request body)
パス	/signup
メソッド	POST

/u/signup/password

プロパティ	値
API の未定義パラメーター	Specific (Request body)
パス	/signup/password
メソッド	POST

​

メソッドへのパラメーターの追加

APIリソースを作成したら、Akamaiがログインリクエストを正しく解析できるように、Request bodyパラメーターを定義する必要があります。

Request body パラメーターには以下の値を使用します。

/u/login/password

プロパティ	値
形式	JSON
必須	はい
ボディ形式を定義	はい
スキーマの詳細	以下を参照。

{
  "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
  }
}

/u/signup

プロパティ	値
形式	JSON
必須	はい
ボディ形式を定義	はい
スキーマの詳細	以下を参照。

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email",
            "password"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
}

/u/signup/password

プロパティ	値
形式	JSON
必須	はい
ボディ形式を定義	はい
スキーマの詳細	以下を参照。

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256,
              "description": "email"
            }
          }
        }
      }
    },
    "required": true
  }
}

新しい Universal Login の識別子ファースト

以下の値を使用して、AkamaiにAPIを登録します。

項目	値
API ベースパス	/u
APIキーの指定場所	ヘッダー

APIを作成したら、次のAuth0エンドポイントそれぞれにAPIリソースを追加する必要があります。

• /u/login
• /u/signup
• /u/signup/password

すべてのエンドポイントで手順は同じですが、設定値は若干異なります。

​

APIリソースの追加

以下の値を使用して、Akamai APIのリソースを設定します。

/u/login

プロパティ	値
API で未定義のパラメーター	Specific (Request body)
パス	/login
メソッド	POST

/u/signup

プロパティ	値
API で未定義のパラメーター	Specific (Request body)
パス	/login/signup
メソッド	POST

/u/signup/password

プロパティ	値
API で未定義のパラメーター	Specific (Request body)
パス	/signup/password
メソッド	POST

​

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

APIリソースを作成したら、Akamaiがログインリクエストを正しく解析できるように、Request bodyパラメーターを定義する必要があります。

Request body パラメーターには以下の値を使用します。

/u/login

プロパティ	値
形式	JSON
必須	はい
ボディ形式の定義	はい
スキーマの詳細	以下を参照。

{
  "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
  }
} 

/u/signup

プロパティ	値
形式	JSON
必須	はい
ボディ形式の定義	はい
スキーマの詳細	以下を参照。

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email",
            "password"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            },
            "password": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256
            }
          }
        }
      }
    },
    "required": true
  }
} 

/u/signup/password

プロパティ	値
形式	JSON
必須	はい
ボディ形式の定義	はい
スキーマの詳細	以下を参照。

{
  "requestBody": {
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "required": [
            "email"
          ],
          "properties": {
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 256,
              "description": "email"
            }
          }
        }
      }
    },
    "required": true
  }
}

ROPG

以下の値を使用して、Akamai に API を登録します。

プロパティ	値
API ベースパス	None.
APIキーの場所	Header

API を作成したら、次の各 Auth0 エンドポイントに対して API リソースを追加する必要があります。

• /oauth/token

手順はすべてのエンドポイントで同じですが、設定値が少し異なります。

​

API リソースを追加

以下の値を使用して、Akamai API のリソースを設定します。

/oauth/token

プロパティ	値
API 未定義パラメーター	Specific (Request body)
パス	/oauth/token
メソッド	POST

​

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

API リソースを作成したら、Akamai がログインリクエストを適切に解析できるよう、Request body パラメーターを定義する必要があります。

以下の値を使用して、Request body パラメーターを定義します。

/oauth/token

プロパティ	値
形式	JSON
必須	Yes
ボディ形式を定義	Yes
スキーマの詳細	以下を参照

{
  "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 に転送するよう設定するには、Akamai TechDocs の Forward Bot Results to Origin を参照してください。

Akamai はユーザーリスクスコアを生成した場合にのみこのヘッダーを送信するため、akamai-user-risk ヘッダーはすべてのログインリクエストに含まれるとは限りません。

​

ステップ 3: Auth0 で Akamai ヘッダーの処理を有効にする

Auth0 Dashboard または Auth0 Management API を使用して、Akamai から送信される Supplemental Signals を Auth0 で受け入れるよう設定できます。

Dashboard

Dashboard で Supplemental Signals を有効にするには、次の手順を実行します。

1. Auth0 Dashboard > Security > Attack Protection に移動します。
2. Supplemental Signals を選択します。
3. Enable Akamai headers のトグルを有効にします。

Auth0 Dashboard に Supplemental Signals のオプションが表示されない場合は、アタックプロテクションのアドオンをリクエストする必要があります。詳細については、Auth0 Sales にお問い合わせください。

Management API

Management API で Supplemental Signals を有効にするには、次の手順を実行します。

1. update:attack_protection スコープを指定して、Management API アクセストークンを取得 します。
2. 次のボディを指定して、Management API の テナントの Supplemental Signals 設定を更新する エンドポイントを呼び出します。

{
  "akamai_enabled": true
}

​

ステップ 4: 設定をテストして検証する

設定した各 Login フローのエンドポイントを呼び出して、設定をテストします。

すべてが正しく設定されている場合:

• 関連するイベントのテナントログに akamai-user-risk ヘッダーと akamai-bot ヘッダーが記録されます。
• post-login Action の event オブジェクトで、次のプロパティを使用できます:
  • authentication.riskAssessment.supplemental.akamai.akamaiBot
  • authentication.riskAssessment.supplemental.akamai.akamaiUserRisk