서버 운영
로그인과 접근
Oleafly Server의 로그인 제공자와 이메일을 설정하고, 접근 규칙, 공개 가입, 역할, 게스트로 누가 들어올 수 있는지 정하고, 브라우저 접근을 켜고, 관리 콘솔에서 서버를 운영합니다.
사람들은 내가 설정한 제공자를 통해 Oleafly Server에 로그인하므로 서버가 비밀번호를 다루는 일은 없습니다. 누가 들어올 수 있는지는 접근 규칙으로 정합니다. 나머지는 관리자가 Oleafly의 관리 콘솔에서 관리합니다.
로그인 제공자
섹션 제목: “로그인 제공자”제공자를 하나 이상 설정하세요. 제공자가 없으면 서버가 시작되지 않으며, 로그에 추가해야 할 설정이 나옵니다. 이메일 링크 로그인은 관리자가 켜기 전까지 꺼져 있으므로, 첫 관리자는 이 제공자로 로그인합니다. 각 제공자는 사람들을 서버의 콜백 주소로 돌려보냅니다.
https://collab.example.org/auth/callback/<provider>
OLEAFLY_PUBLIC_URL에 경로가 있으면 콜백 주소에도 같은 경로가 붙습니다. 예를 들면 https://www.cs.example.edu/oleafly/auth/callback/github입니다.
GitHub
섹션 제목: “GitHub”- GitHub에서 프로필 사진을 선택한 다음 Settings › Developer settings › OAuth apps를 거쳐 New OAuth App을 선택합니다. 조직이 소유하는 앱이라면 대신 조직 설정의 Developer settings를 사용하세요.
- Application name(예:
Smith Lab Oleafly), Homepage URL(https://collab.example.org), Authorization callback URL(https://collab.example.org/auth/callback/github)을 채웁니다. Enable Device Flow는 꺼 둡니다. - Register application을 선택합니다. Client ID를 복사한 다음 Generate a new client secret을 선택해 시크릿을 복사합니다.
OLEAFLY_GITHUB_CLIENT_ID와OLEAFLY_GITHUB_CLIENT_SECRET을 설정하고 서버를 다시 시작합니다.
서버는 GitHub에 사용자의 프로필과 이메일 주소(read:user와 user:email)만 요청합니다. OLEAFLY_GITHUB_LABEL은 로그인 버튼의 텍스트를 바꿉니다.
GitHub Enterprise Server라면 그곳에 앱을 등록하고 OLEAFLY_GITHUB_URL도 https://github.example.edu 같은 해당 서버 주소로 설정하세요. API 주소가 일반적이지 않을 때만 OLEAFLY_GITHUB_API_URL을 설정하세요.
OpenID Connect
섹션 제목: “OpenID Connect”OpenID Connect는 GitLab, Google, Microsoft Entra ID, Keycloak, Authentik, Okta, 그리고 대부분의 대학 통합 인증(SSO) 시스템을 포괄합니다. 대학이 SAML만 제공한다면 중간에 Keycloak이나 Dex를 두세요.
-
GITLAB처럼 문자와 숫자로 된 짧은 이름을 정합니다. 이 이름은 변수 이름의 일부가 되고, 소문자로는 콜백 주소의 일부가 됩니다. Compose의.env에서는UNIVERSITY줄의 이름을 바꾸거나 두 번째 블록을 추가하세요. -
제공자에 애플리케이션을 등록합니다. 기밀(confidential) 또는 웹 애플리케이션을 고르고, 리디렉션 URI를
https://collab.example.org/auth/callback/gitlab으로 설정하고, 스코프openid,email,profile을 허용합니다. -
제공자 정보를 추가합니다.
OLEAFLY_OIDC_GITLAB_ISSUER=https://gitlab.comOLEAFLY_OIDC_GITLAB_CLIENT_ID=example-client-idOLEAFLY_OIDC_GITLAB_CLIENT_SECRET=example-client-secretOLEAFLY_OIDC_GITLAB_LABEL=GitLab -
서버를 다시 시작합니다.
레이블은 University login처럼 로그인 버튼에 표시되는 텍스트입니다. 발급자(issuer)는 제공자가 /.well-known/openid-configuration을 게시하는 주소입니다. 흔한 예는 다음과 같습니다.
| 제공자 | 발급자 |
|---|---|
| GitLab.com | https://gitlab.com |
| 자체 관리형 GitLab | https://gitlab.example.edu 같은 내 GitLab 주소 |
https://accounts.google.com | |
| Microsoft Entra ID | https://login.microsoftonline.com/에 테넌트 ID와 /v2.0을 이어 붙인 주소 |
| Keycloak | https://sso.example.edu/realms/에 realm 이름을 이어 붙인 주소 |
인증된 이메일 주소
섹션 제목: “인증된 이메일 주소”허용 목록 항목과 도메인 규칙은 인증된 이메일 주소와만 일치합니다. 서버는 제공자가 인증되었다고 알려 줄 때만 주소를 인증된 것으로 칩니다. GitHub가 인증됨으로 표시하거나 OpenID Connect 클레임 email_verified가 true인 경우입니다.
일부 기관 제공자는 이 클레임을 생략합니다. 내 제공자가 그렇고, 기관이 관리하는 주소만 발급한다면 OLEAFLY_OIDC_<NAME>_TRUST_EMAIL=true를 설정하세요. 사람들이 원하는 이메일 주소를 마음대로 입력할 수 있는 제공자에는 절대 설정하지 마세요. 그러면 누구든 허용 목록에 있는 사람으로 로그인할 수 있게 됩니다.
대학이 서명한 인증서
섹션 제목: “대학이 서명한 인증서”대학이 프록시나 로그인 서비스에 쓰는 인증서를 직접 서명한다면, 서버가 그 인증 기관을 신뢰해야 합니다. Oleafly를 실행하는 모든 컴퓨터도 마찬가지입니다.
Docker를 쓰지 않는 경우에는 운영 체제에 인증서를 추가하세요. Debian과 Ubuntu에서는 .crt로 끝나는 이름으로 /usr/local/share/ca-certificates/에 복사하고 sudo update-ca-certificates를 실행합니다.
Docker 이미지에는 패키지 관리자가 없으므로, 내 인증서가 포함된 인증서 목록을 만들어 주어야 합니다. Debian이나 Ubuntu 장비에서 docker-compose.yml 옆에서 다음을 실행하세요.
cat /etc/ssl/certs/ca-certificates.crt university-ca.pem > ca-bundle.pemchmod 644 ca-bundle.pem그런 다음 docker-compose.override.yml에서 이 파일을 서버에 추가하고 docker compose up -d를 다시 실행하세요.
services: oleafly-server: volumes: - ./ca-bundle.pem:/etc/ssl/certs/ca-certificates.crt:ro이메일
섹션 제목: “이메일”이메일은 선택 사항이며, 없어도 나머지는 모두 동작합니다. 이메일이 없으면 서버 주소를 사람들에게 직접 보내야 하며, Oleafly는 각 사람에게 공유된 프로젝트를 나와 공유된 프로젝트에 나열합니다.
설정하려면 서버에 SMTP 계정을 지정하세요.
OLEAFLY_SMTP_URL=smtps://oleafly%40example.org:example-app-password@smtp.example.org:465OLEAFLY_MAIL_FROM=Smith Lab <oleafly@example.org>두 줄을 모두 설정하거나 둘 다 설정하지 마세요. 사용자 이름과 비밀번호의 특수 문자는 URL 형식으로 쓰세요. 예를 들어 @는 %40입니다.
smtps://는 처음부터 TLS를 쓰며, 다른 포트를 지정하지 않으면 465번 포트를 씁니다.smtp://는 다른 포트를 지정하지 않으면 587번 포트를 쓰고, STARTTLS로 TLS로 전환합니다. 메일 서버가 STARTTLS를 제공하지 않으면 서버는 메일을 보내지 않습니다.- 같은 장비의 메일 릴레이는 예외입니다.
smtp://localhost,smtp://127.0.0.1,smtp://[::1]은 TLS 없이 보냅니다. - 같은 사설 네트워크의 릴레이는
smtp://mailpit:1025?tls=none처럼?tls=none을 붙이면 TLS를 건너뛸 수 있습니다. 이 경우 주소에는 사용자 이름이나 비밀번호를 넣을 수 없습니다. 암호화되지 않은 채 네트워크를 지나가기 때문입니다. 그 네트워크에 다른 사람이 접근할 수 없을 때만 쓰세요.
서버는 메일 서버의 인증서를 시스템이 신뢰하는 인증서와 대조해 확인합니다.
서버가 보내는 메일
섹션 제목: “서버가 보내는 메일”메일은 여섯 종류가 있습니다. 이미 계정이 있는 사람에게 가는 메일은 인증된 주소로만 가며, GitHub의 noreply 주소는 항상 건너뜁니다.
| 메일 | 보내지는 때 |
|---|---|
| 서버에 추가됨 | 관리자가 이메일 주소로 허용 목록에 사람을 추가할 때. 서버 이름, Oleafly에 추가 링크, 서버 주소가 들어 있습니다. GitHub 사용자 이름으로 추가하거나 도메인 규칙으로 들어오는 사람에게는 서버에 그 사람의 주소가 아직 없으므로 아무것도 보내지 않습니다. |
| 프로젝트 공유됨 | 프로젝트 소유자가 프로젝트에 사람을 추가할 때. 프로젝트 제목, 공유한 사람, 그 사람의 역할, 프로젝트를 여는 링크가 들어 있으며, 링크로 앱이 열리지 않을 때를 위한 프로젝트 웹 페이지도 있습니다. 나중에 역할을 바꿔도 아무것도 보내지 않습니다. 각 사람은 설정 → 공동 작업의 서버 카드에서 이 메일을 끌 수 있습니다. |
| 새 기기 | 계정이 다른 기기에서 로그인할 때. 기기 이름, 시스템, 서버 시간대의 시각이 들어 있으며, 본인이 한 일이 아니라면 그 기기를 로그아웃하라는 안내가 있습니다. 새 계정의 첫 기기에는 메일이 가지 않습니다. 시간대는 TZ를 설정해서 고르며, 예를 들면 TZ=Europe/Berlin입니다. |
| 게스트 초대 | 프로젝트 소유자가 게스트를 초대할 때. 프로젝트 제목, 초대한 사람, Oleafly에 추가 링크, 로그인에 쓸 주소가 들어 있습니다. 승인이 켜져 있으면 초대가 승인된 뒤에 보내집니다. |
| 멘션 | 누군가 댓글이나 답글에서 멤버를 멘션할 때. 멘션한 사람, 프로젝트와 파일, 댓글이 달린 텍스트, 댓글 내용이 들어 있고, Oleafly에서 댓글을 여는 링크가 있습니다. 댓글이 서버에 도달하고 약 1분 뒤에 보내지며, 그 1분 안에 같은 사람에 대한 멘션은 메일 한 통으로 합쳐집니다. 자기 댓글이나 열 수 없는 프로젝트에 대해서는 보내지지 않으며, 댓글을 수정해도 같은 멘션이 두 번 보내지지 않습니다. 각 사람은 설정 → 공동 작업의 서버 카드에서 누군가 댓글에서 나를 멘션하면 이메일로 알려 주기로 이 메일을 끌 수 있습니다. |
| 로그인 링크 | 서버의 로그인 페이지에서 누군가 요청할 때. |
관리자는 서버 설정의 이메일 알림으로 로그인 링크를 제외한 모든 종류를 멈출 수 있습니다. 로그인 링크는 없으면 로그인할 수 없으므로 항상 보내집니다.
테스트하기
섹션 제목: “테스트하기”관리 콘솔에서 이메일을 여세요. 이메일이 켜져 있는지와 발신자(From) 주소가 표시되며, 비밀번호는 절대 표시되지 않습니다. 관리자는 테스트 이메일 보내기를 선택해 자신의 인증된 주소로 메일을 보낼 수 있습니다. 그러면 페이지에 메일이 발송되었는지, 아니면 메일 서버가 무엇이라고 답했는지가 표시됩니다.
이메일이 꺼져 있으면 페이지에 Oleafly에 추가 링크와 서버 주소가 표시되므로 직접 보낼 수 있습니다.
메일 서버가 멈췄을 때
섹션 제목: “메일 서버가 멈췄을 때”메일 발송은 그 뒤의 동작을 붙잡지 않습니다. 서버는 메일을 메모리의 대기열에 두고 30초, 2분, 10분, 30분, 2시간 뒤에 다시 시도합니다. 실패한 시도마다 서버 로그에 경고가 남으며, 이메일 페이지에는 가장 최근의 실패가 표시됩니다. 마지막 시도도 실패하면 서버는 오류를 기록하고 그 메일을 버립니다. 서버가 다시 시작될 때 대기 중이던 메일은 사라집니다.
이메일 링크로 로그인
섹션 제목: “이메일 링크로 로그인”서버가 이메일로 보낸 링크로 로그인할 수도 있어서 GitHub나 OpenID Connect 계정이 필요 없습니다. 이를 쓰려면 이메일이 필요합니다. 그다음 관리자가 서버 설정에서 이메일로 로그인을 켭니다. 기본값은 꺼짐입니다.
사용자는 Oleafly에서 이메일로 계속을 선택하고, 브라우저에 주소를 입력한 다음 링크를 이메일로 받기를 선택합니다. 링크는 요청한 컴퓨터에서 15분 동안 한 번만 쓸 수 있습니다. 링크를 열면 로그인 버튼이 있는 페이지가 나타납니다. 링크를 여는 것만으로는 링크가 사용되지 않으므로, 링크를 따라가는 메일 스캐너가 링크를 소진할 수 없습니다.
누가 들어올 수 있는지는 여전히 접근 규칙이 정합니다. 그 이메일 주소에 대한 허용 목록 항목, 도메인 규칙, 또는 게스트 초대입니다. GitHub 사용자 이름으로 만든 허용 목록 항목은 이메일 링크와 일치하지 않습니다. 서버가 그 주소를 들여보내든 아니든 페이지는 같은 내용을 보여 주므로, 이를 이용해 누가 계정을 가졌는지 알아낼 수는 없습니다.
이 기능을 켜면 기존 계정도 이메일 링크로 열립니다. 링크는 그 주소를 인증된 주소로 가진 기존 계정으로 로그인시킵니다. 서버는 제공자가 계정에 대해 알려 준 인증된 주소를 대표 주소뿐 아니라 모두 보관하며, 사용자가 제공자에서 주소를 지운 뒤에도 그 주소를 계속 보관합니다. 예를 들어 GitHub는 GitHub 계정의 인증된 주소를 모두 알려 줍니다. 따라서 그중 한 주소의 메일을 읽을 수 있는 사람은 누구나 이메일로 그 계정에 로그인할 수 있습니다. 켜기 전에 사람들이 계정의 모든 주소를 여전히 관리하고 있는지 확인하세요.
주소가 둘 이상의 계정에 속해 있으면 링크는 어느 계정에도 로그인시키지 않습니다. 그 주소를 가진 유일한 계정이 정지되었거나 제거되었다면, 그 사람을 다시 들여보내기 전까지 링크는 거부됩니다.
서버는 한 이메일 주소에 15분 동안 최대 3개, 한 IP 주소에 최대 100개의 링크를 보내므로, 한 주소를 쓰는 50명 규모의 수업도 모두 로그인할 수 있습니다. OLEAFLY_EMAIL_LINKS_PER_ADDRESS와 OLEAFLY_EMAIL_LINKS_PER_IP로 이 숫자를 바꿀 수 있습니다. 하나의 /64 네트워크에 있는 모든 IPv6 주소는 한 주소로 칩니다. 이메일로 로그인을 끄면 이미 보낸 링크도 쓸 수 없게 됩니다.
코드로 로그인
섹션 제목: “코드로 로그인”로그인 뒤에 브라우저가 Oleafly로 돌아오지 못할 때, 예를 들어 잠긴 컴퓨터에서는 코드로 로그인할 수 있습니다. 별도 설정이 필요 없으며 서버의 모든 로그인 방법에서 동작합니다.
Oleafly는 서버 주소 뒤에 /auth/device를 붙인 주소와 글자 여덟 개로 된 코드를 보여 줍니다. 사용자는 아무 휴대폰이나 컴퓨터에서 그 주소를 열고, 코드를 입력하고, 페이지에 나온 컴퓨터 이름을 확인한 다음 로그인합니다. 로그인은 코드를 입력한 브라우저에서 끝내야 하므로, 다른 사람이 링크로 보낸 로그인 페이지로는 아무도 로그인되지 않습니다.
코드는 한 번만 쓸 수 있고 10분 뒤에 만료되며, 그 코드를 요청한 Oleafly만 로그인을 마칠 수 있습니다. 중지, 내가 한 것이 아닙니다를 선택하면 취소됩니다. 한 IP 주소는 10분 동안 코드를 100개 요청하고 틀린 코드를 10번 입력할 수 있습니다. 한 주소를 공유하는 50명 규모의 수업에는 충분한 수이며, OLEAFLY_DEVICE_CODES_PER_IP로 바꿀 수 있습니다.
접근 규칙
섹션 제목: “접근 규칙”로그인만으로는 들어올 수 없습니다. 접근 규칙이 그 사람을 들여보내야 합니다. 관리 콘솔의 접근 규칙에서 관리하세요.
- 허용된 사람: 이메일 주소나 GitHub 사용자 이름으로 사람을 추가하고 그 사람이 받을 역할을 정합니다. 다른 제공자는 사람들이 사용자 이름을 고르거나 바꿀 수 있으므로 사용자 이름은 GitHub에서만 쓸 수 있습니다. 서버가 메일을 보내면 이메일 주소로 추가한 사람에게 서버 주소와 Oleafly에 추가 링크가 전송됩니다.
- 도메인:
cs.example.edu같은 도메인의 인증된 이메일 주소가 있는 사람이면 누구나 내가 고른 역할로 로그인할 수 있게 합니다.
사람들을 추가했다면 이제 Oleafly에서 서버를 추가하고 로그인할 수 있습니다.
사용자에서 사람의 역할을 바꾸고, 정지하거나 다시 활성화하고, 제거하고, 기기를 로그아웃할 수 있습니다. 정지된 사람은 계정을 유지하지만 다시 활성화할 때까지 동기화할 수 없습니다. 그 사람의 변경은 그 사람의 컴퓨터에 남습니다.
제거한 사람은 도메인 규칙이 그 사람의 주소를 포함하거나 프로젝트 소유자가 게스트로 초대하더라도 들어올 수 없습니다. 다시 들여보내려면 이메일 주소나 사용자 이름으로 다시 추가하세요. 그러면 이전 계정이 모든 프로젝트와 함께 돌아옵니다.
공개 가입
섹션 제목: “공개 가입”누구나 쓸 수 있는 서버라면 OLEAFLY_OPEN_SIGNUP=true를 설정하고 서버를 다시 시작하세요. 그러면 내가 설정한 제공자 중 하나로 로그인하는 사람은 누구나 허용 목록 항목이나 도메인 규칙 없이 멤버 역할의 계정을 받습니다. 이메일로 로그인이 켜져 있으면 이메일 링크도 똑같이 동작합니다.
공개 가입이 켜져 있어도 내가 제거하거나 정지한 사람, 그리고 인증된 주소가 제거된 계정에 속한 사람은 들어올 수 없습니다. 게스트가 허용된 서버에서 게스트 초대를 받은 사람이 로그인하면 멤버가 되며, 초대받은 프로젝트도 그대로 받습니다.
공개 가입은 계정별 한도도 켭니다. 다른 값을 설정하지 않으면 각 계정은 100 MB까지 저장하고, 공유 프로젝트를 50개까지 소유하고, 한 시간에 300번까지 업로드할 수 있습니다.
관리 콘솔에는 공개 가입이 켜져 있는지 표시되지 않습니다. 서버 로그가 시작할 때마다 이를 알려 줍니다. “Open sign-up is on, so anyone who signs in gets an account as a member.” 멤버는 프로젝트를 공유할 때 서로를 찾아볼 수 있으므로, 공개 서버라면 서버 설정에서 멤버 디렉터리를 끄는 것을 고려하세요.
역할과 권한
섹션 제목: “역할과 권한”사람마다 서버 역할이 하나씩 있으며, 관리자와 유지 관리자가 부여합니다. 추가된 각 프로젝트에서는 그 프로젝트의 소유자가 부여하는 프로젝트 역할도 가집니다. 프로젝트 역할인 소유자, 편집자, 검토자, 댓글 작성자, 뷰어는 역할에 나와 있습니다.
어떤 서버 역할도 그것만으로 프로젝트를 열 수 없습니다. 프로젝트 접근은 프로젝트 소유자만 줄 수 있습니다.
| 작업 | 관리자 | 유지 관리자 | 멤버 | 게스트 |
|---|---|---|---|---|
| Oleafly에 서버 추가 | 예 | 예 | 예 | 예 |
| 멤버 목록 보기 | 예 | 예 | 예, 관리자가 숨기지 않은 경우 | 아니요 |
| 프로젝트 공유 | 예 | 예 | 예 | 아니요 |
| 보안 로그 읽기 | 예 | 예 | 아니요 | 아니요 |
| 서버에 멤버 추가 | 예 | 예 | 아니요 | 아니요 |
| 유지 관리자 지정 | 예 | 아니요 | 아니요 | 아니요 |
| 서버 설정 변경 | 예 | 아니요 | 아니요 | 아니요 |
| 저장 공간 확보를 위해 프로젝트 삭제 | 예 | 아니요 | 아니요 | 아니요 |
| 다른 사람의 기기 로그아웃 | 예 | 예, 단 다른 관리자나 유지 관리자의 기기는 제외 | 본인 기기만 | 본인 기기만 |
| 서버에 직접 접근해 저장된 프로젝트 읽기 | 앱에서는 불가 | 앱에서는 불가 | 앱에서는 불가 | 앱에서는 불가 |
마지막 행이 가장 중요합니다. 서버에서 프로젝트는 암호화되지 않으므로, 장비를 운영하는 사람은 역할과 관계없이 저장된 모든 프로젝트를 읽을 수 있습니다. Oleafly는 관리자를 포함해 어떤 역할에도 앱에서 그렇게 할 방법을 주지 않습니다. 관리자가 저장 공간을 확보하려고 프로젝트를 삭제하면 그 소유자와 멤버에게 알림이 가며, 각자의 컴퓨터에 있는 사본은 그대로 남습니다.
게스트
섹션 제목: “게스트”게스트는 다른 대학의 공저자처럼 서버 밖에 있는 사람으로, 프로젝트 소유자가 프로젝트에 초대합니다. 게스트는 초대받은 프로젝트만 볼 수 있습니다.
게스트 켜기
섹션 제목: “게스트 켜기”새 서버에서는 게스트가 꺼져 있습니다. 관리자가 서버 설정에서 게스트 허용을 켭니다. 게스트 사전 승인은 기본값이 켜짐이어서 관리자나 유지 관리자가 각 초대를 승인해야 효력이 생깁니다. 끄면 초대가 바로 효력을 갖습니다. 관리자나 유지 관리자가 보낸 초대는 즉시 승인됩니다.
나중에 게스트 허용을 끄면 소유자가 새 초대를 보낼 수 없고 사용하지 않은 초대는 효력을 잃습니다. 이미 로그인한 게스트는 소유자가 제거하거나 사용자에서 내가 제거하기 전까지 자기 프로젝트를 유지합니다.
프로젝트에 게스트를 초대할 수 있는 사람은 그 프로젝트의 소유자뿐이며, 프로젝트의 공유 대화 상자에서 초대합니다.
- 초대는 주소 하나와 프로젝트 하나에 대한 것이며 14일이 지나면 끝납니다.
- 한 사람이 한 시간에 최대 20개의 초대를 보낼 수 있습니다.
- 승인이 켜져 있으면 초대는 사용자 맨 위의 대기 중인 게스트에서 기다립니다. 관리자와 유지 관리자가 그곳에서 승인, 거절, 취소합니다. 소유자도 취소할 수 있습니다.
- 서버가 메일을 보내고 이메일 알림이 켜져 있으면 게스트가 초대 메일을 받습니다. 그렇지 않으면 Oleafly가 소유자에게 직접 보낼 수 있는 Oleafly에 추가 링크를 줍니다.
- 프로젝트에 서버가 허용하는 최대 인원이 이미 있으면 초대는 대기하며, 누군가 나간 뒤 그 사람이 다음에 로그인할 때 효력이 생깁니다.
게스트는 서버를 추가하고, 초대받은 주소를 서버에 인증된 주소로 알려 주는 방법으로 로그인합니다. GitHub, OpenID Connect 제공자, 이메일 링크가 그런 방법입니다. 인증되지 않은 주소는 인정되지 않습니다. 첫 로그인에서 게스트 계정이 만들어지고 그 주소가 초대받은 모든 프로젝트가 열립니다.
게스트가 할 수 있는 일
섹션 제목: “게스트가 할 수 있는 일”게스트는 초대받은 프로젝트를 열고 컴파일할 수 있으며, 역할이 허용하면 편집할 수 있고, 자기 기기를 로그아웃할 수 있습니다. 멤버 디렉터리나 누구의 이메일 주소도 볼 수 없고, 프로젝트를 공유하거나, 다른 사람을 초대하거나, 프로젝트 링크로 참여할 수 없습니다. 게스트에게 다른 프로젝트를 주려면 그 프로젝트의 소유자가 같은 주소를 초대하면 됩니다.
게스트가 마지막 프로젝트에서 제거되거나 스스로 나가면 서버가 그 게스트의 접근을 끝냅니다. 계정이 제거되고 모든 기기가 로그아웃됩니다. 새 초대를 받으면 같은 계정이 돌아옵니다. 게스트에게 아직 프로젝트가 있는데 사용자에서 제거했다면 새 초대로도 돌아오지 않습니다.
제거는 유지됩니다
섹션 제목: “제거는 유지됩니다”소유자가 게스트든 아니든 프로젝트에서 사람을 제거하면, 링크 공유가 켜져 있어도 그 사람은 프로젝트 링크로 다시 들어올 수 없습니다. 시도할 때마다 보안 로그에 나타납니다. 다시 들여보내려면 소유자가 그 사람을 다시 추가하거나, 게스트라면 새 초대를 보냅니다. 스스로 프로젝트를 나간 사람은 링크로 다시 참여할 수 있습니다.
브라우저 접근
섹션 제목: “브라우저 접근”브라우저 접근이 켜져 있으면 사람들은 Oleafly를 설치하지 않고 웹 브라우저에서 자신과 공유된 프로젝트를 열 수 있습니다. 편집하고, 변경을 제안하고, 댓글을 달고, 채팅하고, 가장 최근에 컴파일된 PDF를 읽을 수 있습니다. 사람들에게 보이는 화면은 브라우저에서 작업하기에서 다룹니다.
OLEAFLY_WEB=true를 설정하고 서버를 다시 시작하세요. 배포되는 컨테이너 이미지에는 브라우저 앱이 들어 있습니다. 브라우저 앱이 없는 빌드는 로그에 “OLEAFLY_WEB is true, but this build of Oleafly Server has no browser app, so browser access stays off.”라고 남깁니다.
켜고 나면 다음과 같습니다.
- 브라우저 앱은 서버 주소 뒤에
/web/을 붙인 곳에 있습니다. 예를 들면https://collab.example.org/web/입니다./p/아래의 각 프로젝트 페이지에도 브라우저에서 열기 링크가 생깁니다. - 사람들은 Oleafly에서와 같은 제공자와 이메일 링크로
/web/sign-in에서 로그인하며, 누가 들어올 수 있는지도 같은 접근 규칙이 정합니다. 브라우저는 30일 동안 로그인 상태를 유지합니다. - 각 브라우저는 그 계정의 기기로 계산되며, “Safari on macOS” 같은 이름이 붙습니다. 그 사람의 기기 목록과 보안 로그에 나타나며, 로그아웃하면 그 브라우저의 세션이 끝납니다.
- 브라우저는 WebSocket으로
/web/ws에 연결하며 더 느린 대체 경로가 없으므로, 프록시가 그 경로의 WebSocket 업그레이드를 통과시켜야 합니다. Caddy와 리버스 프록시 뒤에서의 nginx, Apache 예시는 이미 그렇게 합니다. - 사람들이 읽는 PDF는 소유자나 편집자가 Oleafly에서 컴파일한 최신 PDF입니다. PDF가 서버에 올라가는 방식은 컴파일된 PDF에서 설명합니다.
브라우저 앱은 다른 사이트의 프레임 안에 표시될 수 없습니다. 사람들의 아바타 사진을 불러올 때를 빼면 내 서버에만 연결합니다.
관리 콘솔
섹션 제목: “관리 콘솔”관리 콘솔은 Oleafly에서 서버 하나를 운영하기 위한 창입니다. 관리자와 유지 관리자가 열 수 있습니다. 설정 → 공동 작업에서 서버 카드의 관리 콘솔 열기를 선택하거나 서버 관리 맨 위에서 선택하세요. 서버마다 자기 창이 열립니다.
| 섹션 | 보여 주는 것과 하는 일 |
|---|---|
| 개요 | 서버가 정상인지, 사용자, 기기, 프로젝트가 몇 개인지, 누가 온라인인지, 저장소를 얼마나 쓰는지, 이메일과 로그인 방법, 설정을 한눈에 보여 줍니다. 서버에 로그인 방법이 없으면 아무도 로그인할 수 없습니다, 데이터 폴더에 쓸 수 없으면 서버가 파일을 저장할 수 없습니다라고 경고합니다. |
| 사용자 | 로그인한 적이 있는 모든 사람. 역할을 바꾸고, 사람을 정지하거나 제거하고, 기기를 로그아웃합니다. 승인을 기다리는 게스트 초대가 맨 위에 있습니다. |
| 접근 규칙 | 허용된 사람 목록과 도메인 규칙. |
| 프로젝트 | 서버에서 공유된 모든 프로젝트와 그 소유자, 인원, 크기, 마지막 활동. 제목이나 소유자로 검색하고, 공유 중, 보관됨, 업로드 중인 프로젝트만 표시하고, 프로젝트를 보관하거나 복원합니다. |
| 서버 설정 | 서버 설정. |
| 이메일 | 이메일이 설정되어 있는지, 발신자 주소, 마지막 실패. 여기서 테스트 이메일을 보냅니다. |
| 보안 로그 | 로그인과 거부된 로그인, 기기, 사람, 설정, 프로젝트, 게스트. 각 항목에는 누가, 언제, 어떤 IP 주소에서 했는지가 나오며, 프로젝트, 사용한 로그인 방법, 로그인이 거부된 이유 같은 세부 정보도 있습니다. |
| 연결 점검 | 연결 테스트와 같은 검사를 내 컴퓨터에서 서버로 실행합니다. |
유지 관리자는 모든 섹션을 쓸 수 있지만, 누구도 관리자나 유지 관리자로 만들 수 없고, 다른 관리자나 유지 관리자의 기기를 보거나 로그아웃할 수 없고, 저장소 사용량을 볼 수 없고, 프로젝트를 보관하거나 복원할 수 없고, 서버 설정을 바꾸거나 테스트 이메일을 보낼 수 없습니다. 관리자는 이 모든 것을 할 수 있습니다.
프로젝트를 보관하면 모든 사람에 대해 공유가 중지됩니다. 사람들은 동기화를 멈추고 자기 사본을 유지하며, 관리자가 먼저 복원하지 않으면 서버는 OLEAFLY_ARCHIVE_DAYS일 뒤에 프로젝트를 삭제합니다. 복원하면 같은 사람들과 다시 공유됩니다. 첫 업로드를 끝내지 못한 프로젝트는 복원할 수 없습니다. 둘 다 보안 로그에 나타납니다.
콘솔은 프로젝트를 절대 열지 않습니다. 제목, 소유자, 크기를 보여 줄 뿐 그 안의 내용은 보여 주지 않습니다.
서버 설정
섹션 제목: “서버 설정”이 설정은 서버의 모든 사람에게 적용됩니다. 관리자만 바꿀 수 있습니다.
| 설정 | 하는 일 |
|---|---|
| 게스트 허용 | 멤버가 자신이 소유한 프로젝트에 서버 외부의 사람을 초대할 수 있습니다. |
| 게스트 사전 승인 | 게스트 초대가 효력을 갖기 전에 유지 관리자나 관리자가 각 초대를 승인합니다. |
| 멤버 디렉터리 | 프로젝트를 공유할 때 멤버끼리 이름으로 서로를 찾을 수 있습니다. |
| 디렉터리에 이메일 주소 표시 | 다른 사람을 찾을 때 멤버끼리 서로의 이메일 주소를 볼 수 있습니다. |
| 링크 공유 허용 | 프로젝트 소유자는 멤버라면 누구나 링크로 프로젝트를 열 수 있게 할 수 있습니다. |
| 노트 공개 링크 허용 | 멤버가 노트의 읽기 전용 사본을, 로그인하지 않고 누구나 열 수 있는 링크에 게시할 수 있습니다. 기본으로는 꺼져 있습니다. 이 설정을 끄면 다시 켤 때까지 게시된 모든 링크가 중단됩니다. 읽기 전용 사본 게시하기를 참고하세요. |
| 프로젝트 접근 로그 허용 | 프로젝트 소유자가 누가 프로젝트를 열었는지 기록을 남길 수 있습니다. |
| 댓글 허용 | 공유 프로젝트의 사람들이 텍스트에 댓글을 달고 답할 수 있습니다. 끄면 모든 곳에서 댓글이 숨겨지고 저장은 유지됩니다. |
| 이메일 알림 | 끄면 로그인 링크를 제외한 서버의 메일을 모든 사람에게 보내지 않습니다. |
| 이메일로 로그인 | 이메일 주소로 보낸 링크로 로그인할 수 있습니다. 서버의 이메일 설정이 필요합니다. |