Hỗ trợ / Hướng dẫn công cụ tự động

Để máy chủ tự cấp lại và cài chứng chỉ SSL

Cài một công cụ nhỏ lên máy chủ, nhập API key hoặc mã PIN của đơn. Từ đó công cụ tự xác thực tên miền, cấp lại chứng chỉ trước hạn và cài vào phần mềm web, bạn không phải làm tay mỗi lần.

MuaSSL Agent dùng cho ai

Dành cho máy chủ Windows chạy website, thư điện tử hoặc dịch vụ cần chứng chỉ SSL. Agent gồm hai phần: dịch vụ nền tự làm việc mỗi ngày, và ứng dụng để bạn xem đơn, cấu hình và thao tác khi cần.

Agent làm được

  • Lấy danh sách đơn SSL từ tài khoản MuaSSL của bạn.
  • Tự xác thực tên miền bằng tệp trên web hoặc bản ghi CNAME.
  • Tự gửi cấp lại khi chứng chỉ sắp hết hạn.
  • Tự cài chứng chỉ mới vào IIS, Plesk, Exchange, MDaemon, FileZilla Server, SQL Server, Remote Desktop.
  • Nginx cài trên Windows (Agent tự tìm, ví dụ C: ginx), kiểm tra nginx -t trước khi nạp lại.
  • Apache, Tomcat và phần mềm khác: xuất tệp chứng chỉ rồi chạy lệnh bạn đặt.
  • Mua chứng chỉ mới ngay trong ứng dụng.
  • Báo qua Telegram khi có thay đổi hoặc khi đơn sắp hết kỳ hạn.

Agent không làm

  • Không dùng cho chứng chỉ ký số phần mềm (code signing), USB token hay chữ ký email.
  • Không tự cài khi cổng 443 do phần mềm khác giữ (proxy, ứng dụng riêng). Khi đó dùng mục xuất tệp hoặc cài tay.
  • Không tự khởi động lại SQL Server.
  • Mặc định không tự gia hạn đơn có tính tiền: chỉ báo để bạn quyết định.

Yêu cầu hệ thống

  • Windows Server 2016 trở lên, hoặc Windows 10/11, bản 64-bit.
  • Đăng nhập bằng tài khoản có quyền Administrator.
  • Máy chủ truy cập được https://muassl.com. Không cần cài thêm .NET: bộ cài đã kèm sẵn.
  • Muốn xác thực bằng tệp: website phải mở được từ Internet qua cổng 80 hoặc 443.

Lấy API key hoặc mã PIN

Agent cần một trong hai thứ sau để biết nó phụ trách đơn nào:

LoạiDùng khiLấy ở đâu
Mã PIN của đơnMáy chỉ lo một vài đơn. Máy không thấy đơn khác, không xem số dư, không mua được gì.Trang chi tiết đơn, dòng Pin quản lý: bấm vào ô để sao chép, hoặc dùng cả đường dẫn https://muassl.com/DatMua/?pin=…
API keyMáy lo nhiều đơn, hoặc cần mua chứng chỉ ngay trong ứng dụng.Thông tin tài khoản → mục API (muassl.com/DatMua/vi/account#api)
Khuyên dùng: mỗi máy một khoá riêng

Trong Thông tin tài khoản → mục API, phần Các API key bổ sung, tạo một khoá chỉ dành cho máy chủ này:

  • Tên gợi nhớ: tên máy, ví dụ web01-iis.
  • Phạm vi: chọn Toàn quyền. Agent cần quyền cấp lại và tải chứng chỉ, hai phạm vi còn lại không đủ.
  • IP whitelist riêng của khoá: chỉ IP của máy chủ này.
  • Ngày hết hạn: đặt nếu muốn đổi khoá định kỳ.

Khoá chỉ hiện một lần lúc tạo, hãy sao chép ngay. Khoá chỉ dùng được từ IP đã khai; mất máy hoặc nghi lộ khoá: bấm Thu hồi, các máy khác không bị ảnh hưởng.

Khoá bổ sung Toàn quyền có cùng quyền với tài khoản: thấy mọi đơn tài khoản thấy. Muốn máy chỉ thấy đúng đơn của nó, dùng mã PIN.

Không dùng khoá của tài khoản đại lý hoặc quản trị

Khoá của tài khoản đại lý hoặc quản trị, kể cả khoá bổ sung Toàn quyền, thấy và thao tác được mọi đơn của mọi khách. Nếu máy chủ cài Agent bị xâm nhập, người lạ có thể cấp lại hoặc tải chứng chỉ của tất cả các đơn đó. Trên máy chủ của từng khách, dùng mã PIN của các đơn đó, và trong Agent chọn Đơn hàng → Đơn máy này phụ trách… → Chỉ đơn có tên miền đang chạy trên chính máy này.

Cài đặt

Cách nhanh: một lệnh PowerShell

  1. Mở PowerShell bằng quyền quản trịBấm Start, gõ PowerShell, chuột phải → Run as administrator.
  2. Dán lệnh sau rồi bấm EnterLệnh tải bộ cài, kiểm tra chữ ký số và mã SHA-256, rồi cài kèm dịch vụ nền.
    PowerShell (Administrator)
    irm https://muassl.com/api/automation/windowsagent/install.ps1 | iex
    Đang ở cửa sổ CMD thay vì PowerShell:
    CMD (Administrator)
    powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://muassl.com/api/automation/windowsagent/install.ps1 | iex"
  3. Ứng dụng tự mở khi cài xongChuyển sang bước nhập khoá bên dưới.

Hoặc tải bộ cài

Tải MuaSSL-Agent-Setup.exe (bản 1.0.4, khoảng 89 MB, ký số bởi HQV SOFTWARE CO., LTD). Chạy tệp, giữ dấu chọn Cài dịch vụ nền (tự động cấp lại và cài chứng chỉ).

Nhập API key hoặc mã PIN

  1. Mở Hệ thống → Cấu hình…, tab Kết nối MuaSSL
  2. Dán khoá vào Cách 1, hoặc mã PIN vào Cách 2Bấm Kiểm tra kết nối. Thấy dòng bắt đầu bằng OK: kèm tên tài khoản là đúng.
  3. Bấm LưuBấm Đóng mà chưa Lưu thì thay đổi bị bỏ.
Cấu hình—  ☐  ✕
Kết nối MuaSSLChứng chỉ & gia hạnThông tin mua hàngXác thực tên miềnIIS & PleskExchangeỨng dụng khácTelegramDịch vụ nền
••••••••••••••••••••••••••••••Ab12HiệnKiểm tra kết nối
Lấy ở trang Tài khoản → API trên muassl.com.
OK: Công ty Ví Dụ <it@example.com> · vai trò thanhvien
Mã PIN hoặc link:Kiểm tra
LưuĐóng

Minh hoạ cửa sổ Cấu hình. Khoá trong hình là khoá giả đã che.

Sử dụng hằng ngày

Cửa sổ chính liệt kê các đơn. Cột Cài đặt cho biết máy đang dùng bản mới nhất chưa (Đã cài, Chứng chỉ cũ, Chưa cài); cột Cài ở cho biết cài vào đâu; cột Ghi chú báo việc bạn cần làm.

MuaSSL Agent — Quản lý SSL—  ☐  ✕
Cập nhật dữ liệu mớiTải thêm đơnChạy kiểm tra ngay
Mã đơnTên miềnSản phẩmTrạng tháiChứng chỉ đếnCònCài đặtCài ởGhi chú
M01234567example.comPositiveSSLĐang hoạt động18/04/2027165 ngàyĐã càiIIS: Default Web SiteCấp lại dự kiến 13/04/2027
M01234568mail.example.comPositiveSSL UCC/SANĐang cấp lại09/11/20265 ngàyChứng chỉ cũExchangeCần tự xác thực
M01234569*.example.netPositiveSSL WildcardĐang hoạt động02/02/202790 ngàyĐã càiPlesk
Dịch vụ nền: đang chạyQuét lần cuối: 04/11 03:30

Minh hoạ cửa sổ chính, dữ liệu giả. Tên cột, nút và chữ trạng thái lấy từ ứng dụng bản 1.0.4.

Mua chứng chỉ mới

Chọn Đơn hàng → Mua chứng chỉ mới…. Chọn sản phẩm, thời hạn, nhập tên miền chính (và tên miền phụ, mỗi dòng một tên), chọn cách xác thực. Đánh dấu Trừ vào số dư tài khoản và Kích hoạt và xác thực ngay sau khi mua nếu muốn làm một lần, rồi bấm Mua và kích hoạt. Cần API key; mã PIN không mua được.

Cấp lại chứng chỉ

  1. Chọn đơn trong danh sách → Chứng chỉ → Cấp lại…
  2. Chọn “Xác thực bằng”CNAME qua DNS (khuyên dùng), tệp trên web (http hoặc https), thư tới email quản trị, hoặc Để app tự chọn.
  3. Giữ lựa chọn “Tạo CSR + khóa riêng mới ngay trên máy này (khuyên dùng)”Khoá riêng nằm trên máy của bạn, MuaSSL không giữ.
  4. Bấm Gửi cấp lạiKhi nhà cung cấp cấp xong, Agent tự cài nếu bạn bật tự cài.

Tự cài và lịch tự động

  • Cấu hình → Chứng chỉ & gia hạn: Tự gửi cấp lại khi sắp hết hạn và Tự cài chứng chỉ mới khi cấp xong bật sẵn; Gửi cấp lại trước khi hết hạn mặc định 5 ngày.
  • Cấu hình → IIS & Plesk: Quản lý IIS, Tự tạo binding https nếu site chưa có, Dùng SNI, Quản lý Plesk (tự phát hiện).
  • Cấu hình → Ứng dụng khác: Xuất tệp + chạy lệnh cho Apache, Tomcat và phần mềm khác.
  • Cấu hình → Dịch vụ nền: giờ chạy hằng ngày (mặc định 03:30) và quét lại mỗi 60 phút. Có nút Cài dịch vụ nền, Khởi động, Dừng.
  • Riêng một đơn: chọn đơn → Chứng chỉ → Lịch cấp lại… để đặt số ngày cấp lại trước hạn, hoặc cấp lại định kỳ. Để 0 là theo cấu hình chung.

Kiểm tra kết quả và xem nhật ký

  • Chọn đơn → Chứng chỉ → Kiểm tra TLS thật: Agent kết nối thử tới tên miền và cho biết chứng chỉ đang phục vụ là bản nào.
  • Chứng chỉ → Kiểm tra cài đặt… xem chứng chỉ đã gắn vào ứng dụng nào trên máy.
  • Hệ thống → Mở thư mục nhật ký: mỗi ngày một tệp agent-YYYY-MM-DD.log, giữ 30 ngày.
Thư mụcChứa gì
C:\ProgramData\MuaSSL Agent\logs\Nhật ký hoạt động
C:\ProgramData\MuaSSL Agent\keys\Khoá riêng tạo trên máy (chỉ SYSTEM và Administrators đọc được)
C:\ProgramData\MuaSSL Agent\backup\Bản lưu trước mỗi lần cài
C:\Program Files\MuaSSL Agent\Chương trình

Gỡ cài đặt

  1. Start → Gỡ MuaSSL Agent, hoặc Settings → Apps → MuaSSL Agent → Uninstall.
  2. Khi được hỏi “Xóa luôn dữ liệu của MuaSSL Agent?”Chọn Không nếu còn dùng lại: khoá riêng và cấu hình được giữ trong C:\ProgramData\MuaSSL Agent. Chọn Có để xoá hết.

Gỡ Agent không gỡ chứng chỉ đã cài trên IIS hay phần mềm khác.

Lỗi thường gặp

Chưa cấu hình API key của tài khoản MuaSSL…

Chưa nhập khoá. Vào Cấu hình → Kết nối MuaSSL, dán API key hoặc mã PIN, bấm Kiểm tra kết nối rồi Lưu.

Không kết nối được tới MuaSSL

Máy chủ không ra được Internet hoặc tường lửa chặn. Cho phép kết nối HTTPS tới muassl.com. Nếu khoá có IP whitelist, kiểm tra IP máy chủ có trong danh sách.

Hết thời gian chờ khi gọi … Lệnh có thể đã được máy chủ nhận

Mạng chậm nhưng lệnh có thể đã tới nơi. Bấm Cập nhật dữ liệu mới và xem lại trạng thái đơn trước khi gửi lại, tránh cấp lại hai lần.

API đang giới hạn tần suất, thử lại sau.

Mỗi khoá gọi tối đa 60 lần mỗi phút. Chờ một phút rồi thử lại.

Cột Ghi chú báo Cần tự xác thực

Agent không tự xác thực được (ví dụ tên miền do nơi khác quản lý DNS). Chọn đơn → Xác thực tên miền → Hướng dẫn tự xác thực…, làm theo hướng dẫn, rồi Gửi kiểm tra tới nhà cung cấp.

Không có khóa riêng khớp chứng chỉ trên máy này.

Chứng chỉ được cấp với khoá tạo ở máy khác. Bấm Cấp lại… và chọn tạo CSR + khoá riêng mới trên máy này.

CẢNH BÁO: chứng chỉ đã cài … nhưng cổng 443 lại do … phục vụ

Một phần mềm khác đang giữ cổng 443 nên khách vẫn thấy chứng chỉ cũ. Cài chứng chỉ vào phần mềm đó (dùng Xuất tệp + chạy lệnh) hoặc nhờ hỗ trợ.

Không ghi được vào C:\ProgramData\MuaSSL Agent

Ứng dụng chưa chạy bằng quyền quản trị. Đóng lại, chuột phải → Run as administrator.

Dịch vụ nền: chưa chạy

Vào Cấu hình → Dịch vụ nền, bấm Cài dịch vụ nền rồi Khởi động. Không có dịch vụ nền thì không có tự cấp lại.

Đơn đang bị khóa thao tác trên hệ thống MuaSSL.

Đơn đang được xử lý hoặc tạm khoá. Liên hệ hỗ trợ kèm mã đơn.

Cần hỗ trợ

Khi liên hệ, gửi kèm mã đơn (dạng M0…) và vài dòng cuối trong tệp nhật ký. Không gửi API key, mã PIN hay khoá riêng cho bất kỳ ai, kể cả nhân viên MuaSSL.

Chat trực tuyến

Kỹ thuật viên trả lời ngay trên trang.

Gọi điện

Hỗ trợ 24/7.

028 7779 6009

Email

Gửi mô tả lỗi và nhật ký.

support@muassl.com