Truy cập công khai

Cho phép khách, khách truy cập chưa đăng nhập và người dùng mới truy cập một triển khai Kubernetes.

Quyền truy cập của khách vào các dự án được chia sẻ, các trang công khai và việc tự đăng ký được bật bằng các biến môi trường mà dịch vụ web đọc; sau đó dịch vụ real-time phục vụ khách thông qua session của họ. Mỗi công tắc mở ra những gì được mô tả trong Truy cập công khai.

Dịch vụ	web (và real-time cho khách trong trình soạn thảo), trong mọi pod Ayakaleaf Pro; được đọc khi web khởi động
Pod → bên ngoài	máy chủ SMTP, khi việc đăng ký gửi email kích hoạt
Trạng thái	token truy cập của khách trong session, giới hạn tốc độ đăng ký trong Redis
Tác vụ định kỳ	không có

​

Cấu hình

Thêm các công tắc bạn cần vào ConfigMap overleaf-env:

30-config.yaml (additions)

  # Guests open link-shared projects without an account
  OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING: "true"
  # Signed-out visitors may open /learn, /templates, /devs and view links
  OVERLEAF_ALLOW_PUBLIC_ACCESS: "true"
  # Self-registration: "true", or only some domains
  OVERLEAF_ALLOW_PUBLIC_REGISTRATION: "@example.com, @*.uni.example"

kubectl apply -f 30-config.yaml
kubectl -n overleaf rollout restart deployment/overleaf     # or statefulset/overleaf

Hãy đặt mọi giá trị trong dấu nháy. Các giá trị bắt đầu bằng @ bắt buộc phải nằm trong dấu nháy trong YAML, nếu không kubectl apply sẽ từ chối tệp.

Việc đăng ký giới hạn theo tên miền sẽ gửi email kích hoạt, vì vậy Gửi email phải hoạt động từ các pod: đặt máy chủ SMTP vào ConfigMap và OVERLEAF_EMAIL_SMTP_PASS vào Secret.

​

Nhiều replica

Không cần gì thêm. Quyền truy cập của khách vào một dự án được lưu trong session trên Redis, nên trình soạn thảo hoạt động trên bất kỳ replica nào mà load balancer chọn.

​

Đã kiểm thử trên Kubernetes

Trên Kubernetes 1.37, các bài kiểm thử end-to-end của chúng tôi cho truy cập công khai đều đạt: trên một replica, tự đăng ký với OVERLEAF_ALLOW_PUBLIC_REGISTRATION được đặt thành true, thành một tên miền, thành nhiều tên miền với wildcard tên miền con và thành @*, kèm email kích hoạt cho các chế độ theo tên miền (43 trường hợp); khách truy cập chưa đăng nhập trên /devs và một đoạn mã đã gửi được giữ lại qua bước đăng nhập với OVERLEAF_ALLOW_PUBLIC_ACCESS (2 trường hợp); một khách chưa đăng nhập trong một dự án được chia sẻ qua liên kết khi bật cả hai công tắc (3 trường hợp); và trên ba replica phía sau HAProxy, OIDC kết hợp với truy cập công khai (1 trường hợp).