Sử dụng Trình xử lý sự kiện¶

Bạn có thể sử dụng trình xử lý sự kiện trong SolusVM 2 để tự động thực hiện một số hành động nhất định khi các sự kiện cụ thể diễn ra. Hiện tại, webhook là loại trình xử lý sự kiện duy nhất được hỗ trợ. Các loại xử lý sự kiện khác có thể được thêm vào trong tương lai.

Khi tạo trình xử lý sự kiện, bạn có thể chọn một hoặc nhiều sự kiện từ danh sách các sự kiện được hỗ trợ, chẳng hạn như thêm địa chỉ IP hoặc xóa máy chủ. Bạn chỉ có thể tạo trình xử lý sự kiện cho các sự kiện được hỗ trợ. Mỗi khi một sự kiện được hỗ trợ diễn ra, bất kể sự kiện đó được khởi tạo bởi quản trị viên hay khách hàng, tất cả các trình xử lý sự kiện liên quan đến sự kiện đó đều được kích hoạt.

Tạo Webhook¶

Webhook là lệnh gọi lại HTTP/HTTPS do người dùng xác định. Mỗi khi trình xử lý sự kiện thuộc loại này được kích hoạt, nó sẽ thực thi webhook, sau đó SolusVM 2 sẽ gửi yêu cầu POST tới URL webhook. SolusVM 2 theo dõi tối đa năm lần chuyển hướng và không kiểm tra tính hợp lệ của chứng chỉ SSL/TLS của trang web (nếu có). Một số tham số được xác định trước luôn được truyền qua URL (ví dụ: ID của máy chủ bị xóa hoặc địa chỉ IP được thêm vào). Webhook cũng có thể được định cấu hình để truyền các tham số bổ sung do người dùng xác định.

Mỗi khi kích hoạt webhook, một tác vụ sẽ được tạo trong SolusVM 2. Tác vụ sẽ có trạng thái "Không thành công" nếu tập lệnh trả về mã trạng thái HTTP 4хх hoặc 5хх.

Để tạo một webhook:

Đăng nhập vào SolusVM 2.
Đi tới Cài đặt > Trình xử lý sự kiện, rồi nhấp vào Thêm Webhook.
Đặt cho webhook của bạn một cái tên duy nhất.
Chỉ định URL webhook. Một yêu cầu sẽ được gửi tới URL này mỗi khi webhook được kích hoạt.
Chọn một hoặc nhiều sự kiện từ menu thả xuống. Mỗi khi một sự kiện được hỗ trợ diễn ra, webhook sẽ được kích hoạt.
(Tùy chọn) Chỉ định các tham số yêu cầu bổ sung sẽ được chuyển qua URL webhook. Các tham số phải ở định dạng JSON.
(Tùy chọn) Chọn hộp kiểm "Đã bật" nếu bạn muốn webhook hoạt động sau khi tạo. Ngoài ra, bạn có thể kích hoạt webhook sau.
Nhấp vào để Lưu.

Webhook đã được tạo. Bạn có thể tìm thấy nó trong Cài đặt > Trình xử lý sự kiện. Nếu bạn đã bật webhook trong quá trình tạo, thì lần tiếp theo khi sự kiện được hỗ trợ diễn ra, webhook sẽ được kích hoạt và yêu cầu sẽ được gửi tới URL webhook.

Sửa đổi, vô hiệu hóa và xóa Webhook¶

Để sửa đổi một webhook:

Đăng nhập vào SolusVM 2.
Đi tới Cài đặt > Trình xử lý sự kiện.
Nhấp vào biểu tượng tương ứng với webhook bạn muốn sửa đổi.
Thực hiện những thay đổi mong muốn rồi nhấp vào Lưu.

Những thay đổi hiện đang có hiệu lực.

Để bật hoặc tắt webhook:

Đăng nhập vào SolusVM 2.
Đi tới Cài đặt > Trình xử lý sự kiện.
Nhấp vào nút chuyển đổi tương ứng với webhook bạn muốn bật hoặc tắt để nó hiển thị "Đã bật" (màu xanh) hoặc "Đã tắt" (màu xám).

Webhook hiện đã được bật (hoặc tắt).

Để xóa webhook:

Đăng nhập vào SolusVM 2.
Đi tới Cài đặt > Trình xử lý sự kiện.
Nhấp vào biểu tượng tương ứng với webhook bạn muốn xóa, sau đó nhấp vào Xóa.

Webhook đã bị xóa.

Danh sách các tham số được truyền bởi Webhooks¶

Mỗi khi một webhook được kích hoạt, nó sẽ chuyển các tham số sau qua URL:

crId
crHostname
crStatus (commissioning, configure_network, active, failed, unavailable)
crLicenseType (micro, mini, standard)
serverId
serverIps (ví dụ: ["10.0.0.1","10.0.0.2"])
serverHostname
serverUuid
serverStatus (không tồn tại, đã bắt đầu, đã dừng, không khả dụng)
userId
billingUserId
userEmail
userStatus (đang hoạt động, bị khóa, bị treo)
userAllowedIps (ví dụ: ["10.0.0.1","10.0.0.2"])

Ví dụ về webhook¶

Bạn có thể tạo một webhook sẽ tự động cập nhật địa chỉ IP của máy chủ được di chuyển từ tài nguyên điện toán này sang tài nguyên điện toán khác trong WHMCS.

Để tạo webhook:

Đăng nhập vào máy chủ WHMCS của bạn thông qua SSH.
Xác định vị trí tệp hook_example.php đi kèm với addon SolusVM 2 WHMCS. Tệp phải nằm trong thư mục modules/servers/solusvm2vps/.
Tạo một bản sao của tệp, sau đó bắt đầu chỉnh sửa bản sao.
Xóa exit(); ở dòng 6.
Thêm (các) bí mật của bạn vào biến $securitySecrets.
Thêm (các) địa chỉ IP của nút quản lý SolusVM 2 của bạn vào biến $connectionIPs.
Lưu thay đổi.
Đăng nhập vào SolusVM 2.
Đi tới Cài đặt > Trình xử lý sự kiện, rồi nhấp vào Thêm Webhook.
Đặt cho webhook của bạn một cái tên duy nhất.
Chỉ định URL của tập lệnh đã chỉnh sửa.
Chọn "Thêm hoặc xóa IP bổ sung" từ menu thả xuống.
Chỉ định (các) bí mật bạn đã thêm vào tập lệnh trong bước 5 của quy trình này:
```
{
 "secret": "<your secret goes here>"
}
```
Chọn hộp kiểm "Đã bật" rồi nhấp vào Lưu.

Giờ đây, mỗi khi máy chủ được di chuyển, tác vụ cập nhật địa chỉ IP của máy chủ trong WHMCS sẽ được tạo trong SolusVM 2.