# 로그인과 접근

Oleafly Server의 로그인 제공자와 이메일을 설정하고, 접근 규칙, 공개 가입, 역할, 게스트로 누가 들어올 수 있는지 정하고, 브라우저 접근을 켜고, 관리 콘솔에서 서버를 운영합니다.

사람들은 내가 설정한 제공자를 통해 Oleafly Server에 로그인하므로 서버가 비밀번호를 다루는 일은 없습니다. 누가 들어올 수 있는지는 접근 규칙으로 정합니다. 나머지는 관리자가 Oleafly의 관리 콘솔에서 관리합니다.

## 로그인 제공자

제공자를 하나 이상 설정하세요. 제공자가 없으면 서버가 시작되지 않으며, 로그에 추가해야 할 설정이 나옵니다. [이메일 링크 로그인](#sign-in-by-email-link)은 관리자가 켜기 전까지 꺼져 있으므로, 첫 관리자는 이 제공자로 로그인합니다. 각 제공자는 사람들을 서버의 콜백 주소로 돌려보냅니다.

`https://collab.example.org/auth/callback/<provider>`

`OLEAFLY_PUBLIC_URL`에 경로가 있으면 콜백 주소에도 같은 경로가 붙습니다. 예를 들면 `https://www.cs.example.edu/oleafly/auth/callback/github`입니다.

### GitHub

1. GitHub에서 프로필 사진을 선택한 다음 **Settings › Developer settings › OAuth apps**를 거쳐 **New OAuth App**을 선택합니다. 조직이 소유하는 앱이라면 대신 조직 설정의 **Developer settings**를 사용하세요.
2. **Application name**(예: `Smith Lab Oleafly`), **Homepage URL**(`https://collab.example.org`), **Authorization callback URL**(`https://collab.example.org/auth/callback/github`)을 채웁니다. **Enable Device Flow**는 꺼 둡니다.
3. **Register application**을 선택합니다. **Client ID**를 복사한 다음 **Generate a new client secret**을 선택해 시크릿을 복사합니다.
4. `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는 GitLab, Google, Microsoft Entra ID, Keycloak, Authentik, Okta, 그리고 대부분의 대학 통합 인증(SSO) 시스템을 포괄합니다. 대학이 SAML만 제공한다면 중간에 Keycloak이나 Dex를 두세요.

1. `GITLAB`처럼 문자와 숫자로 된 짧은 이름을 정합니다. 이 이름은 변수 이름의 일부가 되고, 소문자로는 콜백 주소의 일부가 됩니다. Compose의 `.env`에서는 `UNIVERSITY` 줄의 이름을 바꾸거나 두 번째 블록을 추가하세요.
2. 제공자에 애플리케이션을 등록합니다. 기밀(confidential) 또는 웹 애플리케이션을 고르고, 리디렉션 URI를 `https://collab.example.org/auth/callback/gitlab`으로 설정하고, 스코프 `openid`, `email`, `profile`을 허용합니다.
3. 제공자 정보를 추가합니다.

   ```ini
   OLEAFLY_OIDC_GITLAB_ISSUER=https://gitlab.com
   OLEAFLY_OIDC_GITLAB_CLIENT_ID=example-client-id
   OLEAFLY_OIDC_GITLAB_CLIENT_SECRET=example-client-secret
   OLEAFLY_OIDC_GITLAB_LABEL=GitLab
   ```

4. 서버를 다시 시작합니다.

레이블은 `University login`처럼 로그인 버튼에 표시되는 텍스트입니다. 발급자(issuer)는 제공자가 `/.well-known/openid-configuration`을 게시하는 주소입니다. 흔한 예는 다음과 같습니다.

| 제공자 | 발급자 |
| --- | --- |
| GitLab.com | `https://gitlab.com` |
| 자체 관리형 GitLab | `https://gitlab.example.edu` 같은 내 GitLab 주소 |
| Google | `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` 옆에서 다음을 실행하세요.

```sh
cat /etc/ssl/certs/ca-certificates.crt university-ca.pem > ca-bundle.pem
chmod 644 ca-bundle.pem
```

그런 다음 `docker-compose.override.yml`에서 이 파일을 서버에 추가하고 `docker compose up -d`를 다시 실행하세요.

```yaml
services:
  oleafly-server:
    volumes:
      - ./ca-bundle.pem:/etc/ssl/certs/ca-certificates.crt:ro
```

## 이메일

이메일은 선택 사항이며, 없어도 나머지는 모두 동작합니다. 이메일이 없으면 서버 주소를 사람들에게 직접 보내야 하며, Oleafly는 각 사람에게 공유된 프로젝트를 **나와 공유된 프로젝트**에 나열합니다.

설정하려면 서버에 SMTP 계정을 지정하세요.

```ini
OLEAFLY_SMTP_URL=smtps://oleafly%40example.org:example-app-password@smtp.example.org:465
OLEAFLY_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분 안에 같은 사람에 대한 멘션은 메일 한 통으로 합쳐집니다. 자기 댓글이나 열 수 없는 프로젝트에 대해서는 보내지지 않으며, 댓글을 수정해도 같은 멘션이 두 번 보내지지 않습니다. 각 사람은 **설정 → 공동 작업**의 서버 카드에서 **누군가 댓글에서 나를 멘션하면 이메일로 알려 주기**로 이 메일을 끌 수 있습니다. |
| 로그인 링크 | 서버의 로그인 페이지에서 누군가 요청할 때. |

관리자는 서버 설정의 **이메일 알림**으로 로그인 링크를 제외한 모든 종류를 멈출 수 있습니다. 로그인 링크는 없으면 로그인할 수 없으므로 항상 보내집니다.

### 테스트하기

[관리 콘솔](#admin-console)에서 **이메일**을 여세요. 이메일이 켜져 있는지와 발신자(From) 주소가 표시되며, 비밀번호는 절대 표시되지 않습니다. 관리자는 **테스트 이메일 보내기**를 선택해 자신의 인증된 주소로 메일을 보낼 수 있습니다. 그러면 페이지에 메일이 발송되었는지, 아니면 메일 서버가 무엇이라고 답했는지가 표시됩니다.

이메일이 꺼져 있으면 페이지에 **Oleafly에 추가** 링크와 서버 주소가 표시되므로 직접 보낼 수 있습니다.

### 메일 서버가 멈췄을 때

메일 발송은 그 뒤의 동작을 붙잡지 않습니다. 서버는 메일을 메모리의 대기열에 두고 30초, 2분, 10분, 30분, 2시간 뒤에 다시 시도합니다. 실패한 시도마다 서버 로그에 경고가 남으며, **이메일** 페이지에는 가장 최근의 실패가 표시됩니다. 마지막 시도도 실패하면 서버는 오류를 기록하고 그 메일을 버립니다. 서버가 다시 시작될 때 대기 중이던 메일은 사라집니다.

## 이메일 링크로 로그인

서버가 이메일로 보낸 링크로 로그인할 수도 있어서 GitHub나 OpenID Connect 계정이 필요 없습니다. 이를 쓰려면 [이메일](#email)이 필요합니다. 그다음 관리자가 서버 설정에서 **이메일로 로그인**을 켭니다. 기본값은 꺼짐입니다.

사용자는 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`를 설정하고 서버를 다시 시작하세요. 그러면 내가 설정한 제공자 중 하나로 로그인하는 사람은 누구나 허용 목록 항목이나 도메인 규칙 없이 멤버 역할의 계정을 받습니다. **이메일로 로그인**이 켜져 있으면 이메일 링크도 똑같이 동작합니다.

공개 가입이 켜져 있어도 내가 제거하거나 정지한 사람, 그리고 인증된 주소가 제거된 계정에 속한 사람은 들어올 수 없습니다. 게스트가 허용된 서버에서 게스트 초대를 받은 사람이 로그인하면 멤버가 되며, 초대받은 프로젝트도 그대로 받습니다.

공개 가입은 [계정별 한도](/docs/collaboration/server-operations/#limits-per-account)도 켭니다. 다른 값을 설정하지 않으면 각 계정은 100 MB까지 저장하고, 공유 프로젝트를 50개까지 소유하고, 한 시간에 300번까지 업로드할 수 있습니다.

관리 콘솔에는 공개 가입이 켜져 있는지 표시되지 않습니다. 서버 로그가 시작할 때마다 이를 알려 줍니다. "Open sign-up is on, so anyone who signs in gets an account as a member." 멤버는 프로젝트를 공유할 때 서로를 찾아볼 수 있으므로, 공개 서버라면 서버 설정에서 **멤버 디렉터리**를 끄는 것을 고려하세요.

## 역할과 권한

사람마다 서버 역할이 하나씩 있으며, 관리자와 유지 관리자가 부여합니다. 추가된 각 프로젝트에서는 그 프로젝트의 소유자가 부여하는 프로젝트 역할도 가집니다. 프로젝트 역할인 소유자, 편집자, 검토자, 댓글 작성자, 뷰어는 [역할](/docs/collaboration/sharing/#roles)에 나와 있습니다.

어떤 서버 역할도 그것만으로 프로젝트를 열 수 없습니다. 프로젝트 접근은 프로젝트 소유자만 줄 수 있습니다.

| 작업 | 관리자 | 유지 관리자 | 멤버 | 게스트 |
| --- | --- | --- | --- | --- |
| Oleafly에 서버 추가 | 예 | 예 | 예 | 예 |
| 멤버 목록 보기 | 예 | 예 | 예, 관리자가 숨기지 않은 경우 | 아니요 |
| 프로젝트 공유 | 예 | 예 | 예 | 아니요 |
| 보안 로그 읽기 | 예 | 예 | 아니요 | 아니요 |
| 서버에 멤버 추가 | 예 | 예 | 아니요 | 아니요 |
| 유지 관리자 지정 | 예 | 아니요 | 아니요 | 아니요 |
| 서버 설정 변경 | 예 | 아니요 | 아니요 | 아니요 |
| 저장 공간 확보를 위해 프로젝트 삭제 | 예 | 아니요 | 아니요 | 아니요 |
| 다른 사람의 기기 로그아웃 | 예 | 예, 단 다른 관리자나 유지 관리자의 기기는 제외 | 본인 기기만 | 본인 기기만 |
| 서버에 직접 접근해 저장된 프로젝트 읽기 | 앱에서는 불가 | 앱에서는 불가 | 앱에서는 불가 | 앱에서는 불가 |

마지막 행이 가장 중요합니다. 서버에서 프로젝트는 암호화되지 않으므로, 장비를 운영하는 사람은 역할과 관계없이 저장된 모든 프로젝트를 읽을 수 있습니다. Oleafly는 관리자를 포함해 어떤 역할에도 앱에서 그렇게 할 방법을 주지 않습니다. 관리자가 저장 공간을 확보하려고 프로젝트를 삭제하면 그 소유자와 멤버에게 알림이 가며, 각자의 컴퓨터에 있는 사본은 그대로 남습니다.

## 게스트

게스트는 다른 대학의 공저자처럼 서버 밖에 있는 사람으로, 프로젝트 소유자가 프로젝트에 초대합니다. 게스트는 초대받은 프로젝트만 볼 수 있습니다.

### 게스트 켜기

새 서버에서는 게스트가 꺼져 있습니다. 관리자가 서버 설정에서 **게스트 허용**을 켭니다. **게스트 사전 승인**은 기본값이 켜짐이어서 관리자나 유지 관리자가 각 초대를 승인해야 효력이 생깁니다. 끄면 초대가 바로 효력을 갖습니다. 관리자나 유지 관리자가 보낸 초대는 즉시 승인됩니다.

나중에 **게스트 허용**을 끄면 소유자가 새 초대를 보낼 수 없고 사용하지 않은 초대는 효력을 잃습니다. 이미 로그인한 게스트는 소유자가 제거하거나 **사용자**에서 내가 제거하기 전까지 자기 프로젝트를 유지합니다.

### 초대

프로젝트에 게스트를 초대할 수 있는 사람은 그 프로젝트의 소유자뿐이며, 프로젝트의 **공유** 대화 상자에서 초대합니다.

- 초대는 주소 하나와 프로젝트 하나에 대한 것이며 14일이 지나면 끝납니다.
- 한 사람이 한 시간에 최대 20개의 초대를 보낼 수 있습니다.
- 승인이 켜져 있으면 초대는 **사용자** 맨 위의 **대기 중인 게스트**에서 기다립니다. 관리자와 유지 관리자가 그곳에서 승인, 거절, 취소합니다. 소유자도 취소할 수 있습니다.
- 서버가 메일을 보내고 **이메일 알림**이 켜져 있으면 게스트가 초대 메일을 받습니다. 그렇지 않으면 Oleafly가 소유자에게 직접 보낼 수 있는 **Oleafly에 추가** 링크를 줍니다.
- 프로젝트에 서버가 허용하는 최대 인원이 이미 있으면 초대는 대기하며, 누군가 나간 뒤 그 사람이 다음에 로그인할 때 효력이 생깁니다.

게스트는 서버를 추가하고, 초대받은 주소를 서버에 인증된 주소로 알려 주는 방법으로 로그인합니다. GitHub, OpenID Connect 제공자, 이메일 링크가 그런 방법입니다. 인증되지 않은 주소는 인정되지 않습니다. 첫 로그인에서 게스트 계정이 만들어지고 그 주소가 초대받은 모든 프로젝트가 열립니다.

### 게스트가 할 수 있는 일

게스트는 초대받은 프로젝트를 열고 컴파일할 수 있으며, 역할이 허용하면 편집할 수 있고, 자기 기기를 로그아웃할 수 있습니다. 멤버 디렉터리나 누구의 이메일 주소도 볼 수 없고, 프로젝트를 공유하거나, 다른 사람을 초대하거나, 프로젝트 링크로 참여할 수 없습니다. 게스트에게 다른 프로젝트를 주려면 그 프로젝트의 소유자가 같은 주소를 초대하면 됩니다.

게스트가 마지막 프로젝트에서 제거되거나 스스로 나가면 서버가 그 게스트의 접근을 끝냅니다. 계정이 제거되고 모든 기기가 로그아웃됩니다. 새 초대를 받으면 같은 계정이 돌아옵니다. 게스트에게 아직 프로젝트가 있는데 **사용자**에서 제거했다면 새 초대로도 돌아오지 않습니다.

### 제거는 유지됩니다

소유자가 게스트든 아니든 프로젝트에서 사람을 제거하면, 링크 공유가 켜져 있어도 그 사람은 프로젝트 링크로 다시 들어올 수 없습니다. 시도할 때마다 보안 로그에 나타납니다. 다시 들여보내려면 소유자가 그 사람을 다시 추가하거나, 게스트라면 새 초대를 보냅니다. 스스로 프로젝트를 나간 사람은 링크로 다시 참여할 수 있습니다.

## 브라우저 접근

브라우저 접근이 켜져 있으면 사람들은 Oleafly를 설치하지 않고 웹 브라우저에서 자신과 공유된 프로젝트를 열 수 있습니다. 편집하고, 변경을 제안하고, 댓글을 달고, 채팅하고, 가장 최근에 컴파일된 PDF를 읽을 수 있습니다. 사람들에게 보이는 화면은 [브라우저에서 작업하기](/docs/collaboration/browser/)에서 다룹니다.

`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와 [리버스 프록시 뒤에서](/docs/collaboration/server-operations/#behind-a-reverse-proxy)의 nginx, Apache 예시는 이미 그렇게 합니다.
- 사람들이 읽는 PDF는 소유자나 편집자가 Oleafly에서 컴파일한 최신 PDF입니다. PDF가 서버에 올라가는 방식은 [컴파일된 PDF](/docs/collaboration/server-operations/#compiled-pdfs)에서 설명합니다.

브라우저 앱은 다른 사이트의 프레임 안에 표시될 수 없습니다. 사람들의 아바타 사진을 불러올 때를 빼면 내 서버에만 연결합니다.

## 관리 콘솔

관리 콘솔은 Oleafly에서 서버 하나를 운영하기 위한 창입니다. 관리자와 유지 관리자가 열 수 있습니다. **설정 → 공동 작업**에서 서버 카드의 **관리 콘솔 열기**를 선택하거나 **서버 관리** 맨 위에서 선택하세요. 서버마다 자기 창이 열립니다.

| 섹션 | 보여 주는 것과 하는 일 |
| --- | --- |
| **개요** | 서버가 정상인지, 사용자, 기기, 프로젝트가 몇 개인지, 누가 온라인인지, 저장소를 얼마나 쓰는지, 이메일과 로그인 방법, 설정을 한눈에 보여 줍니다. 서버에 로그인 방법이 없으면 **아무도 로그인할 수 없습니다**, 데이터 폴더에 쓸 수 없으면 **서버가 파일을 저장할 수 없습니다**라고 경고합니다. |
| **사용자** | 로그인한 적이 있는 모든 사람. 역할을 바꾸고, 사람을 정지하거나 제거하고, 기기를 로그아웃합니다. 승인을 기다리는 게스트 초대가 맨 위에 있습니다. |
| **접근 규칙** | 허용된 사람 목록과 도메인 규칙. |
| **프로젝트** | 서버에서 공유된 모든 프로젝트와 그 소유자, 인원, 크기, 마지막 활동. 제목이나 소유자로 검색하고, 공유 중, 보관됨, 업로드 중인 프로젝트만 표시하고, 프로젝트를 보관하거나 복원합니다. |
| **서버 설정** | [서버 설정](#server-settings). |
| **이메일** | 이메일이 설정되어 있는지, 발신자 주소, 마지막 실패. 여기서 테스트 이메일을 보냅니다. |
| **보안 로그** | 로그인과 거부된 로그인, 기기, 사람, 설정, 프로젝트, 게스트. 각 항목에는 누가, 언제, 어떤 IP 주소에서 했는지가 나오며, 프로젝트, 사용한 로그인 방법, 로그인이 거부된 이유 같은 세부 정보도 있습니다. |
| **연결 점검** | **연결 테스트**와 같은 검사를 내 컴퓨터에서 서버로 실행합니다. |

유지 관리자는 모든 섹션을 쓸 수 있지만, 누구도 관리자나 유지 관리자로 만들 수 없고, 다른 관리자나 유지 관리자의 기기를 보거나 로그아웃할 수 없고, 저장소 사용량을 볼 수 없고, 프로젝트를 보관하거나 복원할 수 없고, 서버 설정을 바꾸거나 테스트 이메일을 보낼 수 없습니다. 관리자는 이 모든 것을 할 수 있습니다.

프로젝트를 보관하면 모든 사람에 대해 공유가 중지됩니다. 사람들은 동기화를 멈추고 자기 사본을 유지하며, 관리자가 먼저 복원하지 않으면 서버는 `OLEAFLY_ARCHIVE_DAYS`일 뒤에 프로젝트를 삭제합니다. 복원하면 같은 사람들과 다시 공유됩니다. 첫 업로드를 끝내지 못한 프로젝트는 복원할 수 없습니다. 둘 다 보안 로그에 나타납니다.

콘솔은 프로젝트를 절대 열지 않습니다. 제목, 소유자, 크기를 보여 줄 뿐 그 안의 내용은 보여 주지 않습니다.

### 서버 설정

이 설정은 서버의 모든 사람에게 적용됩니다. 관리자만 바꿀 수 있습니다.

| 설정 | 하는 일 |
| --- | --- |
| **게스트 허용** | 멤버가 자신이 소유한 프로젝트에 서버 외부의 사람을 초대할 수 있습니다. |
| **게스트 사전 승인** | 게스트 초대가 효력을 갖기 전에 유지 관리자나 관리자가 각 초대를 승인합니다. |
| **멤버 디렉터리** | 프로젝트를 공유할 때 멤버끼리 이름으로 서로를 찾을 수 있습니다. |
| **디렉터리에 이메일 주소 표시** | 다른 사람을 찾을 때 멤버끼리 서로의 이메일 주소를 볼 수 있습니다. |
| **링크 공유 허용** | 프로젝트 소유자는 멤버라면 누구나 링크로 프로젝트를 열 수 있게 할 수 있습니다. |
| **노트 공개 링크 허용** | 멤버가 노트의 읽기 전용 사본을, 로그인하지 않고 누구나 열 수 있는 링크에 게시할 수 있습니다. 기본으로는 꺼져 있습니다. 이 설정을 끄면 다시 켤 때까지 게시된 모든 링크가 중단됩니다. [읽기 전용 사본 게시하기](/docs/notes/projects-and-sharing/#publish-a-read-only-copy)를 참고하세요. |
| **프로젝트 접근 로그 허용** | 프로젝트 소유자가 누가 프로젝트를 열었는지 기록을 남길 수 있습니다. |
| **댓글 허용** | 공유 프로젝트의 사람들이 텍스트에 댓글을 달고 답할 수 있습니다. 끄면 모든 곳에서 댓글이 숨겨지고 저장은 유지됩니다. |
| **이메일 알림** | 끄면 로그인 링크를 제외한 서버의 메일을 모든 사람에게 보내지 않습니다. |
| **이메일로 로그인** | 이메일 주소로 보낸 링크로 로그인할 수 있습니다. 서버의 이메일 설정이 필요합니다. |
