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 về danh sách các yêu cầu API đã phát hiện mà 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.

Bằng cách 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 gọ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 thu thập những thông tin sau về các cuộc tấn công không mong muốn đối với API của bạn:

  • Tổ chức và môi trường Apigee được thu thập các yêu cầu bị 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ố lượng địa chỉ IP gửi yêu cầu có thể không mong muốn.
  • Một mảng dữ liệu ứng dụng dành cho các địa chỉ IP gửi các yêu cầu có thể không mong muốn (chẳng hạn như bot). Đối với từng khách hàng, báo cáo bao gồm:

    Đặc điểm của khách hàng Nội dung mô tả
    ipAddress Địa chỉ IP của ứng dụng.
    botDetectedLast Dấu thời gian của yêu cầu gần đây nhất từ khách hàng.
    ipIsp Nhà cung cấp dịch vụ Internet (ISP) của khách hàng đưa ra yêu cầu.
    ipCountry Quốc gia nơi phát sinh yêu cầu từ ứng dụng.
    botReason Các quy tắc phát hiện Apigee Sense tuân thủ các yêu cầu từ địa chỉ IP này.
    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 khách yêu cầu.
    ipCity Thành phố nhận yêu cầu.

Để thiết lập thông báo

  1. Mở trải nghiệm New Edge.
  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 (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ị để thiết lập thông báo:

    Xem xét Nội dung 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 sử 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 webhook đến. Các 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. Bạn nên sử dụng tên khoá Apigee Sense khi xác thực bằng hệ thống của mình. Sử dụng khoá API để tăng cường bảo mật.
    Giá trị khoá API Không bắt buộc. Bạn nên sử dụng khoá-giá trị mà Apigee Sense nên sử dụng khi xác thực bằng hệ thống của mình. Sử dụng khoá API để tăng cường bảo mật.
    Số lượng IP tối đa Số lượng tối đa (từ 1 đến 300) địa chỉ IP ứng dụng khách cần đưa vào báo cáo. Apigee Sense sẽ đưa các địa chỉ IP vào 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 ít nhất, tối đa số lượng IP bạn chỉ định tại đây.