Đăng nhập lần đầu và thiết lập hệ thống

Hướng dẫn thao tác

Dành cho:: Người vận hành máy chủ, Quản trị viên không gian làm việc
Trong ứng dụng:: Quản trị hệ thống, rồi Hệ thống và cập nhật

Bước thiết lập ReputeCast lần đầu biến tài khoản mà reputecast install tạo ra thành một Chủ sở hữu được bảo vệ, và biến bản cài đặt thành một hệ thống có tên cùng không gian làm việc đầu tiên. Quá trình gồm sáu bước và mất khoảng mười phút; mỗi bước hoàn tất đều được lưu, nên bạn có thể dừng lại và tiếp tục sau.

Trước khi bắt đầu

ReputeCast đang chạy, được cài bằng Docker Compose hoặc tệp nhị phân.
Bạn có thông báo cài đặt: email và mật khẩu tạm thời (xxxx-xxxx-xxxx-xxxx). Với Docker: docker compose logs app | grep -A4 "ReputeCast is installed".
URL công khai mở được ReputeCast qua HTTPS thông qua reverse proxy của bạn. Khóa truy cập và cookie bảo mật cần HTTPS.
Một điện thoại hoặc máy tính có khóa truy cập (Touch ID, Face ID, Windows Hello, khóa bảo mật) hoặc ứng dụng xác thực.

Thiết lập hệ thống

Mở URL công khai. Ở trang đăng nhập, nhập email của Chủ sở hữu, chọn Tiếp tục, rồi nhập mật khẩu tạm thời.

ReputeCast mở trang thiết lập tại /setup. Danh sách bước ở bên trái cho biết bạn đang ở đâu.
Thay mật khẩu tạm thời. Nhập mật khẩu tạm thời, rồi nhập mật khẩu mới hai lần. Mật khẩu cần ít nhất 12 ký tự (mức tối thiểu trong chính sách của hệ thống; dùng cụm mật khẩu cũng được). Mật khẩu tạm thời hết hiệu lực ngay khi bạn lưu.
Thêm khóa truy cập hoặc ứng dụng xác thực. Xác thực hai lớp là bắt buộc với Chủ sở hữu đầu tiên và không thể bỏ qua. Hãy thêm khóa truy cập (khuyên dùng), hoặc thiết lập ứng dụng xác thực: quét mã QR và nhập mã mà ứng dụng hiển thị. Bạn có thể thêm khóa truy cập khác sau trong phần cài đặt tài khoản.
Lưu mã khôi phục. Tạo mã rồi lưu vào trình quản lý mật khẩu hoặc in ra. Bạn nhận 10 mã; mỗi mã đăng nhập được một lần nếu bạn mất khóa truy cập hoặc ứng dụng xác thực, và chúng chỉ hiện duy nhất lúc này.
Thông tin cơ bản của hệ thống. Các thiết lập này áp dụng cho mọi không gian làm việc trên hệ thống:
- Tên hệ thống, hiện trên trang đăng nhập và trong email gửi cho nhóm của bạn.
- Múi giờ mặc định, múi giờ mà không gian làm việc mới dùng lúc đầu. Ban đầu đây là múi giờ của trình duyệt bạn.
- Ngôn ngữ mặc định của ứng dụng, dùng cho trang đăng nhập, lời mời và những thành viên chưa chọn ngôn ngữ.
- URL công khai, địa chỉ dùng cho webhook của nhà cung cấp, URI chuyển hướng SSO, trang công khai và liên kết trong mọi email. ReputeCast kiểm tra địa chỉ này ngay khi bước mở ra, và kiểm tra lại mỗi lần bạn yêu cầu sau khi sửa.
- Kiểm tra bản phát hành mới trên GitHub mỗi ngày một lần: chỉ số phiên bản được tải về. Hãy tắt tùy chọn này với máy chủ không có internet.
Sau đó lưu lại; bước tiếp theo sẽ mở ra.
Tạo không gian làm việc đầu tiên. Đặt tên cho không gian làm việc (hiện trong bộ chuyển không gian làm việc và trên trang công khai cho đến khi bạn đặt thương hiệu) và chọn múi giờ cho lịch gửi và báo cáo của nó. Mỗi không gian làm việc có danh sách, chiến dịch, tự động hóa, nhà cung cấp gửi thư và nhóm riêng; bạn có thể tạo thêm sau.
Kết nối nhà cung cấp gửi thư. Tiếp tục sang kết nối nhà cung cấp gửi thư, hoặc bỏ qua và mở không gian làm việc. Lời mời, đặt lại mật khẩu và thông báo qua email bắt đầu hoạt động khi có một nhà cung cấp gửi thư xử lý luồng Hệ thống của không gian làm việc.

Kiểm tra URL công khai

Bước Thông tin cơ bản của hệ thống chạy ba kiểm tra từ máy chủ đến URL bạn nhập:

Kiểm tra	Đạt khi	Ý nghĩa của cảnh báo hoặc lỗi
DNS	Tên máy chủ phân giải được; kết quả liệt kê các địa chỉ của nó.	`… không phân giải được`: hãy thêm bản ghi `A` hoặc `AAAA` cho tên máy chủ.
TLS	Máy chủ đưa ra chứng chỉ hợp lệ (TLS 1.2 trở lên); kết quả hiện đơn vị cấp và ngày hết hạn.	Cảnh báo khi chứng chỉ hết hạn trong vòng 14 ngày, hoặc khi URL là `http://` thường (khóa truy cập, cookie bảo mật và webhook của hầu hết nhà cung cấp cần HTTPS).
Kết nối	`GET <public URL>/healthz` trả về `200` trong vòng 6 giây.	Trạng thái khác: proxy có trả lời nhưng không chuyển tiếp đến ReputeCast. Không có phản hồi: lỗi ở DNS, tường lửa hoặc proxy.

Các kiểm tra chạy từ chính máy chủ ReputeCast, nên máy chủ phải truy cập được địa chỉ công khai của chính nó. Kết quả đạt nghĩa là đường đi đó hoạt động; các nhà cung cấp gửi thư truy cập cùng địa chỉ đó từ internet.

Lưu một URL công khai khác với http.public_url sẽ biến nó thành địa chỉ dùng cho liên kết, trang công khai và webhook của nhà cung cấp trên mọi tiến trình trong vòng 30 giây. Cookie phiên và HSTS vẫn theo http.public_url, nên hãy đặt cấu hình về cùng địa chỉ (cấu hình ReputeCast).

Kiểm tra kết quả

Mở Quản trị hệ thống, rồi Hệ thống và cập nhật. Thẻ Hệ thống hiện tên, múi giờ, ngôn ngữ và URL công khai bạn đã lưu, cùng lần kiểm tra URL gần nhất.

Bạn có thể đổi các thiết lập này ở đó bất cứ lúc nào, và dùng Tải logo lên (SVG hoặc PNG, hình vuông) để thay biểu tượng ReputeCast trên trang đăng nhập và trong email gửi cho nhóm.

Khắc phục sự cố

Mất mật khẩu tạm thời: hãy in một liên kết đặt lại dùng một lần trên máy chủ bằng reputecast user reset-password --email [email protected] (khôi phục quyền truy cập).
Trang thiết lập yêu cầu bạn đăng nhập lại: phiên của bạn đã kết thúc. Hãy đăng nhập lại; các bước đã hoàn tất vẫn được giữ.
Không thêm được khóa truy cập: trang không được phục vụ qua HTTPS, hoặc trình duyệt không có trình cung cấp khóa truy cập. Hãy dùng ứng dụng xác thực, rồi thêm khóa truy cập sau.
Kết nối thất bại trong khi trang vẫn mở được trên trình duyệt: máy chủ không truy cập được địa chỉ công khai của chính nó, thường do một quy tắc tường lửa hoặc một tên DNS phân giải khác đi trên máy chủ. Hãy sửa lỗi này trước khi kết nối nhà cung cấp gửi thư, vì họ gửi sự kiện đến cùng địa chỉ đó.
Thông báo cài đặt ghi Sign in at http://localhost:8080: chưa đặt http.public_url. Hãy nhập đúng địa chỉ ở bước Thông tin cơ bản của hệ thống và đặt cùng giá trị trong cấu hình.

Liên quan

Quản trị hệ thống: người dùng, không gian làm việc, chính sách xác thực và cập nhật.
Kết nối nhà cung cấp gửi thư
Bảo mật tài khoản: khóa truy cập, ứng dụng xác thực và mã khôi phục.