Nhận thông báo từ Sense

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Bạn có thể định cấu hình Apigee Sense để thông báo cho bạn danh sách các yêu cầu API đã phát hiện có thể không mong muốn. Sau khi bạn thiết lập thông báo, cứ 5 phút một lần, Apigee Sense sẽ gửi một báo cáo đến URI webhook mà bạn chỉ định.

Khi sử dụng URI webhook, Apigee Sense sẽ gửi một chuỗi ở dạng JSON (bạn sẽ cần mã để phân tích cú pháp chuỗi thành JSON). Ví dụ ngắn sau đây về một báo cáo đã được định dạng từ chuỗi thành JSON để dễ đọc:

{
    "text": {
        "metadata": {
            "org": "my-org",
            "env": "prod",
            "reportTimestamp": "2018-10-09T17:25:12Z",
            "messageId": "1539105912220"
        },
        "totalNumberOfBots": 1,
        "bots": [
            {
                "ipAddress": "11.111.111.11",
                "botDetectedLast": "2018-10-0917:04:48Z",
                "ipIsp": "Their ISP",
                "ipCountry": "United States",
                "botReason": [
                    "Flooder",
                    "Content Robber"
                ],
                "callCount": "274529",
                "topUrl": "/v1/my/url",
                "ipCity": "Los Angeles"
            }
        ]
    }
}

Báo cáo này ghi lại các thông tin sau về những cuộc tấn công không mong muốn có thể xảy ra đối với API của bạn:

  • Tổ chức và môi trường Apigee nơi thu thập các yêu cầu được báo cáo.
  • Dấu thời gian của báo cáo.
  • Mã của thông báo báo cáo.
  • Số địa chỉ IP đưa ra yêu cầu có thể không mong muốn.
  • Một mảng dữ liệu ứng dụng của các địa chỉ IP đưa ra những yêu cầu có thể không mong muốn (chẳng hạn như bot). Đối với mỗi ứng dụng khách, báo cáo này bao gồm:

    Đặc điểm của khách hàng Mô tả
    ipAddress Địa chỉ IP của ứng dụng khách.
    botDetectedLast Dấu thời gian của yêu cầu gần đây nhất từ ứng dụng.
    ipIsp ISP của ứng dụng đang đưa ra yêu cầu.
    ipCountry Quốc gia nơi bắt nguồn yêu cầu của ứng dụng.
    botReason Các quy tắc phát hiện của Apigee Sense mà các yêu cầu từ địa chỉ IP này phải tuân thủ.
    callCount Số lượng yêu cầu từ địa chỉ IP này.
    topUrl URL phổ biến nhất do IP ứng dụng yêu cầu. Đây là API do ứng dụng yêu cầu.
    ipCity Thành phố nơi yêu cầu được nhận.

Cách thiết lập thông báo

  1. Mở Trải nghiệm Edge mới.
  2. Trong trải nghiệm New Edge, hãy nhấp vào trình đơn Analyze (Phân tích), sau đó nhấp vào Sense.
  3. Nhấp vào trình đơn Cài đặt.
  4. Trên trang Cài đặt, hãy nhập các giá trị để định cấu hình thông báo:

    Xem xét Mô tả
    Thông báo Nhấp để bật hoặc tắt thông báo này.
    URI URI mà bạn muốn Apigee Sense dùng khi gửi thông báo. Đây thường là một hệ thống giám sát chấp nhận các webhook đến. Báo cáo từ Apigee Sense sẽ được gửi đến URI này.
    Tên khoá API Không bắt buộc. Tên khoá Apigee Sense nên dùng khi xác thực với hệ thống của bạn. Sử dụng khoá API để tăng cường bảo mật.
    Giá trị khoá API Không bắt buộc. Giá trị khoá mà Apigee Sense nên sử dụng khi xác thực bằng hệ thống của bạn. Sử dụng khoá API để tăng cường bảo mật.
    Số IP tối đa Số lượng địa chỉ IP ứng dụng khách tối đa (từ 1 đến 300) để đưa vào báo cáo. Apigee Sense sẽ đưa vào các địa chỉ IP theo thứ tự số lượng yêu cầu đáng ngờ, từ số lượng yêu cầu nhiều nhất đến số lượng yêu cầu ít nhất, lên đến số lượng IP mà bạn chỉ định tại đây.