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 補足シグナル向けに次のログインフローをサポートしています。

Universal Login: 識別子 + パスワード
- Universal Login: Identifier First
- Resource Owner Password (ROP)

ステップ 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 でリソースを構成するには、以下の値を使用します:

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

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

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

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

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

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

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

Akamai に API を登録するには、以下の値を使用します:

プロパティ	値
API のベースパス	`/u`
API キーの送信先	`Header`

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`

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

/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
  }
}

ROP

Akamai で API を登録するには、次の値を使用します。

プロパティ	値
API ベースパス	なし
API キーの場所	`Header`

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

/oauth/token

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

API リソースを追加する

Akamai の API 上でリソースを構成するには、次の値を使用します。

/oauth/token

プロパティ	値
API undefined parameters	`Specific` (`Request body`)
Path	`/oauth/token`
Methods	`POST`

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

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

/oauth/token

プロパティ	値
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 に転送するには、Forward Bot Results to Origin on Akamai TechDocs を参照してください。

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

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

Auth0 Dashboard または Auth0 Management API を使用して、Akamai から送信される補足シグナルを Auth0 が受信して処理できるように構成できます。

Dashboard
Management API

Dashboard で補足シグナルを有効にするには:

Dashboard > Security > Attack Protection に移動します。
Supplemental Signals を選択します。
Enable Akamai headers のトグルをオンにします。

Management API で補足シグナルを有効にするには:

update:attack_protection スコープを持つ Management API アクセストークンを取得します。
次のボディを指定して、Management API のテナントの補足シグナル構成を更新エンドポイントを呼び出します:

{
  "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 を構成して補足シグナルを送信する

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

API リソースを追加する

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

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

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

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

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

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

​API リソースを追加する

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

​API リソースを追加する

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

​API リソースを追加する

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

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

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

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

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

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

API リソースを追加する

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

API リソースを追加する

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

API リソースを追加する

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

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

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

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