Supplemental Signals は Enterprise のお客様のみ利用可能です。また、攻撃対策アドオンをリクエストする必要があります。詳細については、Auth0 Sales にお問い合わせください。

開始する前に

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

Akamai Bot Manager や Akamai Account Protector を使用している場合は、Akamai でリバースプロキシを設定して、その結果を Auth0 に送信し、その結果を Actions で使用することができます。 Auth0 では現在、Supplemental Signals で以下のログインフローをサポートしています。

Universal Login: 識別子 + パスワード
- Universal Login: 識別子を最初に入力
- Universal Login: データベース接続でのサインアップ
- Universal Login: パスワードリセット (Auth0 Organizations を含む)
- リソース所有者パスワードグラント (ROPG)

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

Akamai でログイン試行の成否を判別できるようにするには、まず Akamai で API を登録し、次にサポートする Auth0 の各ログインフローに対応するエンドポイントを定義する必要があります。詳しくは、Akamai TechDocs の Register an API と Akamai TechDocs の Add API resources をご覧ください。

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

項目	値
API ベースパス	`/u`
API keyの場所	`ヘッダー`

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

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

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

APIリソースを追加する

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

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

プロパティ	値
API で未定義のパラメーター	`Specific` (`リクエストボディ`)
パス	`/login/password`
メソッド	`POST`

プロパティ	値
API で未定義のパラメーター	`Specific` (`リクエストボディ`)
パス	`/signup`
メソッド	`POST`

プロパティ	値
API で未定義のパラメーター	`Specific` (`リクエストボディ`)
パス	`/signup/password`
メソッド	`POST`

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

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

/u/login/password
/u/signup
/u/signup/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
  }
}

プロパティ	値
形式	`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
  }
}

プロパティ	値
形式	`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
  }
}

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

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

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

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

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

APIリソースを追加する

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

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

項目	値
API 未定義のパラメーター	`Specific` (`Request body`)
パス	`/login`
メソッド	`POST`

項目	値
API 未定義のパラメーター	`Specific` (`Request body`)
パス	`/login/signup`
メソッド	`POST`

項目	値
API 未定義のパラメーター	`Specific` (`Request body`)
パス	`/signup/password`
メソッド	`POST`

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

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

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

プロパティ	値
形式	`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
  }
} 

プロパティ	値
形式	`JSON`
必須	`Yes`
ボディ形式の定義	`Yes`
スキーマの詳細	以下を参照してください。

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

プロパティ	値
形式	`JSON`
必須	`Yes`
ボディ形式の定義	`Yes`
スキーマの詳細	以下を参照してください。

{
  "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 を登録します。

Property	Value
API base path	なし。
API key location	`Header`

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

/oauth/token

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

API リソースを追加

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

/oauth/token

Property	Value
API undefined parameters	`Specific` (`Request body`)
Path	`/oauth/token`
Methods	`POST`

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

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

/oauth/token

Property	Value
Format	`JSON`
Required	`Yes`
Define body format	`Yes`
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 にボットの結果を転送するよう設定するには、Akamai TechDocs の「Forward Bot Results to Origin」を参照してください。

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

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

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

Auth0 Dashboard
Management API

Auth0 Dashboard で Supplemental Signals を有効にするには:

Auth0 Dashboard > Security > 攻撃対策 に移動します。
Supplemental Signals を選択します。
Enable Akamai headers のトグルを有効にします。

Auth0 Dashboard に Supplemental Signals のオプションが表示されない場合は、攻撃対策アドオンをリクエストする必要があります。詳しくは、Auth0 Sales にお問い合わせください。

Management API で Supplemental Signals を有効にするには:

update:attack_protection scope を指定して、Management API access token を取得します。
次の body を指定して、Management API の tenant の Supplemental Signals 設定を更新するエンドポイントを呼び出します。

{
  "akamai_enabled": true
}

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

設定したログインフローごとに各エンドポイントを呼び出して、設定をテストします。すべてが正しく設定されていれば、次のようになります。

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

アプリケーションを保護する

ユーザーに代わってAPIを呼び出す

テナントを保護する

コンプライアンス

Akamai を設定して Supplemental Signals を送信する

開始する前に

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

API リソースを追加

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

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

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

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

開始する前に

​サポート対象のログインフロー

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

​APIリソースを追加する

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

​APIリソースを追加する

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

​API リソースを追加

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

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

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

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

サポート対象のログインフロー

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

APIリソースを追加する

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

APIリソースを追加する

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

API リソースを追加

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

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

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

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