CheckIP Plugin (Tiếng Việt)

Plugin CheckIP hỗ trợ quản lý và ngăn chặn IP truy cập vào hệ thống GP247.

Tính năng

Quản lý danh sách IP theo 2 loại: allow và deny.
Hỗ trợ ký tự *:
- * trong allow: cho phép tất cả IP.
- * trong deny: chặn tất cả IP (trừ khi đã được allow trước đó).
Ưu tiên xử lý: allow > deny.
Giao diện quản trực quan, hỗ trợ tạo/sửa/xóa.
Trường trạng thái status (ON/OFF) cho từng bản ghi để bật/tắt nhanh mục cấu hình (mặc định ON khi tạo mới).

Middleware

Lớp: App\GP247\Plugins\CheckIP\Middleware\CheckIP
Luồng xử lý (rút gọn):
1. Nếu IP khớp danh sách allow (hoặc allow *) hoặc là localhost (127.0.0.1, ::1) => cho phép.
2. Ngược lại, nếu IP khớp danh sách deny (hoặc deny *) => trả về 403.
3. Nếu không khớp gì => cho phép.

Sơ đồ hoạt động

Phạm vi bảo vệ: Admin, Front, API (đều đi qua middleware CheckIP).

flowchart LR
    subgraph Contexts[Phạm vi bảo vệ]
        A[Admin] --> M
        B[Front] --> M
        C[API] --> M
    end

    M[Middleware CheckIP] --> D1{IP là localhost?<br/>127.0.0.1 hoặc ::1}
    D1 -- Có --> ALLOW[Cho phép truy cập]
    D1 -- Không --> D2{Khớp danh sách Allow<br/>hoặc Allow *}
    D2 -- Có --> ALLOW
    D2 -- Không --> D3{Khớp danh sách Deny<br/>hoặc Deny *}
    D3 -- Có --> DENY[403 Forbidden]
    D3 -- Không --> ALLOW

    ALLOW --> NEXT[Tiếp tục vào route/controller]
    DENY --> STOP[Dừng yêu cầu]

Cài đặt

Có thể cài đặt theo các cách sau (tương tự tài liệu plugin trên GP247 Store):

Cách 1 (Thủ công)

Sao chép mã nguồn vào thư mục app/GP247/Plugins/CheckIP.
Vào Admin > Plugins, tìm plugin CheckIP để cài đặt và kích hoạt.

Cách 2 (Import file ZIP)

Vào Admin > Plugins > tab "Cài đặt từ file".
Tải lên gói ZIP của plugin và xác nhận cài đặt.

Cách 3 (Thư viện)

Vào Admin > Plugins > tab "Thư viện plugin".
Tìm "CheckIP" và nhấn Cài đặt.

Kích hoạt & Sử dụng

Sau khi cài đặt, vào Admin > Bảo mật > CheckIP (tên menu trong nhóm SECURITY) để quản lý.
Tạo bản ghi:
- description: mô tả ngắn.
- ip: địa chỉ IP (ví dụ: 203.0.113.10) hoặc *.
- type: chọn allow hoặc deny.
- status: ON để áp dụng, OFF để tạm tắt.
Lưu ý: allow có ưu tiên cao hơn deny.