全部產品
Search
文件中心

Captcha:Log Service

更新時間:Oct 28, 2025

驗證碼(CAPTCHA)Log Service協助您採集並儲存驗證碼互動對應的請求和攻防日誌,並基於阿里雲Log ServiceSLS,輸出查詢分析、統計圖表、警示服務,協助您聚焦於驗證請求的安全分析。

計費

驗證碼Log Service的費用由阿里雲Log Service來統一結算和出賬,不包含在驗證碼的賬單中。

重要

啟用Log Service後,驗證碼不會收取任何費用,所有日誌費用將由Log ServiceSLS收取,以SLS的計費邏輯為準。

開啟Log Service

image

  1. 登入驗證碼2.0控制台,進入Log Service頁面。

  2. 選擇驗證碼請求所在的地區,地區分為中国内地非中国内地

    說明

    Log Service預設儲存的地區如下,驗證碼日誌會儲存在對應地區中,不會跨域儲存。

    • 中国内地:華東2(上海)

    • 非中国内地:新加坡

  3. 開通Log ServiceSLS。

    如果當前帳號未開通Log Service,您需要在啟用前,單擊去开通先開通Log Service。

  4. 授權雲資源訪問。

    啟用前請單擊去授权,根據提示確認授權。

  5. 單擊启用日志服务即可,預計需要1-2分鐘建立logstore和建立索引。

關閉Log Service

image

  1. 登入驗證碼2.0控制台,進入Log Service頁面,選擇驗證碼請求所在的地區。

  2. 單擊右上方的关闭日志服务,在彈出的關閉Log Service的提示框中,單擊確定

  3. 成功關閉後Log Service頁面將變為未啟用狀態,可以參考開啟Log Service重新開啟Log Service。

欄位說明

初始化請求Log欄位

欄位

說明

樣本值

certifyId

驗證碼單次驗證周期的標識。

1a0c65617575819193924043e****

mainCaptchaType

初次驗證驗證形態。

枚舉值:

  • 02:無痕

  • 03:滑塊

  • 05:拼圖

  • 06:映像複原

  • 07:一點即過

03

captchaType

二次挑戰驗證形態,若非無痕驗證模式下和mainCaptchaType保持一致。

枚舉值:

  • 02:無痕

  • 03:滑塊

  • 05:拼圖

  • 06:映像複原

  • 07:一點即過

03

initTime

初始化請求的時間戳記。

1757581931913

requestid

單次請求的唯一標識。

3151C480-678B-407A-87D5-36A1E6C3****

sceneld

控制台建立情境儲存後產生的唯一標識,用於區分不同業務情境需求。

19x5****

clientIp

用戶端請求IP地址。

183.7.*.*

userAgent

用戶端採集的瀏覽器類型、版本以及運行瀏覽器的作業系統等資訊的字串。

Mozilla/5.0 (Linux; Android 5.0; Generic Android Build/LRXX) AppleWebKit/537.x (KHTML, like Gecko) Chrome/92.x.x.x Mobile Safari/537.x

驗證請求Log欄位

欄位

說明

樣本值

certifyId

驗證碼單次驗證周期的標識。

1a0c65617575819193924043e****

mainCaptchaType

初次驗證驗證形態。

枚舉值:

  • 02:無痕

  • 03:滑塊

  • 05:拼圖

  • 06:映像複原

  • 07:一點即過

03

captchaType

二次挑戰驗證形態,若非無痕驗證模式下和mainCaptchaType保持一致。

枚舉值:

  • 02:無痕

  • 03:滑塊

  • 05:拼圖

  • 06:映像複原

  • 07:一點即過

03

requestid

單次請求的唯一標識。

3151C480-658B-407A-87D5-36A1E6C3****

sceneld

控制台建立情境儲存後產生的唯一標識,用於區分不同業務情境需求。

1935****

verifyTime

驗證請求時間戳記。

1757581931913

verifyResult

驗證結果。

  • true:表示驗證通過

  • false:表示驗證不通過

true

verifyCode

驗證結果Code。

參考用戶端V3架構返回資料說明

T001

clientIp

用戶端請求IP地址。

183.7.*.*

userAgent

用戶端採集的瀏覽器類型、版本以及運行瀏覽器的作業系統等資訊的字串。

Mozilla/5.0 (Linux; Android 5.0; Generic Android Build/LRXX) AppleWebKit/537.x (KHTML, like Gecko) Chrome/92.x.x.x Mobile Safari/537.x

url

驗證碼所在業務URL。

https: //google.cn/

umid

裝置維度指標計算的唯一標識。

625796e86dsdd1dd56203062c2690a****

日誌查詢與分析

有效地利用日誌資料,是快速排查問題和洞察業務趨勢的關鍵。以下是驗證碼Log Service中常用的查詢案例,協助您快速上手。

  • 使用certifyId查詢某次驗證的資訊。

    certifyId: xxxxxx | select from_unixtime(verifyTime / 1000) as time, clientIp, verifyResult, verifyCode
  • 使用requestId查詢某次驗證的資訊。

    requestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx | select from_unixtime(verifyTime / 1000) as time, clientIp, verifyResult, verifyCode
  • 查詢用戶端發起驗證請求的頁面URL分布。

    sceneId: xxxxxx | select url, count(1) as t group by url order by t desc
  • 查詢某個情境的驗證結果分布。

    sceneId: xxxxxx | select verifyResult, count(1) as t group by verifyResult order by t desc
  • 查詢某個情境驗證失敗的狀態代碼分布。

    sceneId: xxxxxx and verifyResult: false | select verifyCode, count(1) as t group by verifyCode order by t desc
  • 查詢驗證次數靠前的用戶端IP及歸屬地。

    sceneId: xxxxxx | select clientIp, ip_to_country(clientIp) as country, ip_to_province(clientIp) as province, count(1) as t group by clientIp, country, province order by t desc
  • 查詢驗證次數靠前的umid

    sceneId: xxxxxx | select umid, count(1) as t group by umid order by t desc