# サインインとアクセス

Oleafly Server のサインインプロバイダとメールを設定し、アクセスルール、オープンサインアップ、役割、ゲストで誰を入れるかを決め、ブラウザからのアクセスをオンにし、管理コンソールからサーバーを運用します。

ユーザーは、あなたが設定したプロバイダ経由で Oleafly Server にサインインするため、サーバーがパスワードを扱うことはありません。誰を入れるかは、アクセスルールで決めます。それ以外の管理は、管理者が Oleafly の管理コンソールから行います。

## サインインプロバイダ

プロバイダを少なくとも 1 つ設定してください。1 つもないとサーバーは起動せず、ログに追加すべき設定が示されます。[メールのリンクによるサインイン](#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`）を設定します。`OLEAFLY_GITHUB_API_URL` は、API のアドレスが特殊な場合にだけ設定します。

### OpenID Connect

OpenID Connect は、GitLab、Google、Microsoft Entra ID、Keycloak、Authentik、Okta、そしてほとんどの大学のシングルサインオンシステムに対応します。大学が SAML しか提供していない場合は、間に Keycloak か Dex を置きます。

1. 文字と数字からなる短い名前（`GITLAB` など）を決めます。この名前は変数名の一部になり、小文字にするとコールバックのアドレスの一部にもなります。Compose の `.env` では、`UNIVERSITY` の行の名前を変更するか、2 つ目のブロックを追加します。
2. プロバイダにアプリケーションを登録します。機密クライアントまたは Web アプリケーションを選び、リダイレクト 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` を公開しているアドレスです。代表的なものを挙げます。

| プロバイダ | Issuer |
| --- | --- |
| GitLab.com | `https://gitlab.com` |
| セルフマネージドの GitLab | お使いの GitLab のアドレス（`https://gitlab.example.edu` など） |
| Google | `https://accounts.google.com` |
| Microsoft Entra ID | `https://login.microsoftonline.com/` に、テナント ID と `/v2.0` を続けたもの |
| Keycloak | `https://sso.example.edu/realms/` に、レルム名を続けたもの |

### 確認済みのメールアドレス

許可リストの項目とドメインのルールは、確認済みのメールアドレスにしか一致しません。サーバーがアドレスを確認済みとみなすのは、プロバイダがそう伝えたときだけです。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 なしで送信します。
- 同じプライベートネットワーク上のリレーは、`?tls=none` を付けると TLS を省略できます。たとえば `smtp://mailpit:1025?tls=none` です。その場合、ユーザー名とパスワードは暗号化されずにネットワークを流れてしまうため、アドレスに含めることはできません。ほかの誰もそのネットワークにアクセスできない場合にだけ使ってください。

サーバーは、メールサーバーの証明書を、システムが信頼する証明書と照合します。

### サーバーが送信するメール

メールには 6 種類あります。すでにアカウントを持っているユーザーへのメールは、確認済みのアドレスにだけ送られ、GitHub の noreply アドレスは常に除外されます。

| メール | 送信されるタイミング |
| --- | --- |
| サーバーへの追加 | 管理者がメールアドレスで許可リストにユーザーを追加したとき。サーバーの名前、 **Oleafly に追加**リンク、サーバーのアドレスが含まれます。GitHub のユーザー名やドメインのルールでユーザーを追加した場合は、まだサーバーにそのユーザーのアドレスがないため、何も送信されません。 |
| プロジェクトの共有 | プロジェクトの所有者がプロジェクトにユーザーを追加したとき。プロジェクトのタイトル、共有した人、その人の役割、プロジェクトを開くリンクが含まれ、リンクでアプリが開かない場合のために、プロジェクトの Web ページも載っています。後から役割を変更しても、何も送信されません。各ユーザーは、 **設定 → 共同編集**にあるサーバーのカードで、このメールをオフにできます。 |
| 新しいデバイス | アカウントが別のデバイスでサインインしたとき。デバイスの名前、システム、サーバーのタイムゾーンでの時刻が含まれ、本人でなければそのデバイスをサインアウトするよう促す注意書きも付きます。新しいアカウントの最初のデバイスには、メールは送信されません。タイムゾーンは `TZ` を設定して選びます。たとえば `TZ=Europe/Berlin` です。 |
| ゲストの招待 | プロジェクトの所有者がゲストを招待したとき。プロジェクトのタイトル、招待した人、 **Oleafly に追加**リンク、サインインに使うアドレスが含まれます。承認がオンの場合は、招待が承認された後に送信されます。 |
| メンション | 誰かがコメントや返信でメンバーをメンションしたとき。メンションした人、プロジェクトとファイル、コメントが付いているテキストとコメント本文が含まれ、Oleafly でそのコメントを開くリンクが付きます。コメントがサーバーに届いてから約 1 分後に送信され、その 1 分の間に同じユーザーへのメンションがあれば、1 通にまとめられます。自分のコメントについても、開けないプロジェクトについても、メールは届きません。コメントを編集しても、同じメンションが 2 回送信されることはありません。各ユーザーは、 **設定 → 共同編集**にあるサーバーのカードの**コメントでメンションされたらメールを受け取る**で、このメールをオフにできます。 |
| サインインリンク | 誰かがサーバーのサインインページでリンクをリクエストしたとき。 |

管理者は、サーバー設定の**メール通知**で、サインインリンク以外のすべての種類を止められます。サインインリンクは、これがないとサインインできないため、常に送信されます。

### テストする

[管理コンソール](#admin-console)で**メール**を開きます。メールがオンかどうかと From アドレスが表示され、パスワードは表示されません。管理者は**テストメールを送信**を選んで、自分の確認済みアドレスにテストメールを送れます。ページには、送信できたか、あるいはメールサーバーが何と応答したかが表示されます。

メールがオフの場合、ページには**Oleafly に追加**リンクとサーバーのアドレスが表示されるので、自分で送れます。

### メールサーバーが止まっているとき

メールの送信が、その元になった操作を妨げることはありません。サーバーはメールをメモリ上のキューに保持し、30 秒後、2 分後、10 分後、30 分後、2 時間後に再試行します。失敗した試行は、そのたびにサーバーのログに警告として記録され、 **メール**ページには最新の失敗が表示されます。最後の試行も失敗すると、サーバーはエラーを記録し、そのメールを破棄します。サーバーの再起動時にまだ待機しているメールは失われます。

## メールのリンクでサインインする

サーバーがメールで送るリンクでサインインすることもできるため、GitHub や OpenID Connect のアカウントは不要です。これには[メール](#email)が必要です。そのうえで、管理者がサーバー設定で**メールでサインイン**をオンにします。既定ではオフです。

ユーザーは Oleafly で**メールで続行**を選び、ブラウザでアドレスを入力して**リンクをメールで送信**を選びます。リンクは、リクエストしたコンピュータで、15 分間、1 回だけ使えます。リンクを開くと、 **サインイン**ボタンのあるページが表示されます。リンクを開いただけではリンクは消費されないため、リンクを辿るメールスキャナーに使い切られることはありません。

誰を入れるかは、引き続きアクセスルールが決めます。そのメールアドレスの許可リストの項目、ドメインのルール、ゲストの招待のいずれかです。GitHub のユーザー名による許可リストの項目は、メールのリンクには一致しません。サーバーがそのアドレスを入れるかどうかにかかわらず、ページの表示は同じなので、誰がアカウントを持っているかを調べるために使われることはありません。

オンにすると、既存のアカウントもメールのリンクでサインインできるようになります。リンクは、そのアドレスを確認済みのアドレスとして持つアカウントにサインインします。サーバーは、プロバイダがアカウントについて報告した確認済みのアドレスを、メインのものだけでなくすべて保持し、ユーザーがプロバイダからそのアドレスを削除した後も保持します。たとえば GitHub は、GitHub アカウントのすべての確認済みアドレスを報告します。そのため、それらのアドレスのいずれかでメールを読める人は、メールでそのアカウントにサインインできます。オンにする前に、ユーザーがアカウントのすべてのアドレスを今も管理していることを確認してください。

アドレスが複数のアカウントに属している場合、リンクはどのアカウントにもサインインしません。そのアドレスを持つ唯一のアカウントが停止または削除されている場合、そのユーザーを再び入れるまで、リンクは拒否されます。

サーバーが 15 分間に送るリンクは、1 つのメールアドレスに最大 3 通、1 つの IP アドレスに最大 100 通なので、同じアドレスを使う 50 人のクラスの全員がサインインできます。これらの数は `OLEAFLY_EMAIL_LINKS_PER_ADDRESS` と `OLEAFLY_EMAIL_LINKS_PER_IP` で変更できます。1 つの `/64` ネットワーク内のすべての IPv6 アドレスは、1 つのアドレスとして数えられます。 **メールでサインイン**をオフにすると、すでに送信されたリンクも使えなくなります。

## コードでサインインする

ロックダウンされたコンピュータなどで、サインイン後にブラウザから Oleafly に戻れない場合は、コードでサインインできます。設定は不要で、サーバーが持つすべてのサインイン方法で使えます。

Oleafly は、サーバーのアドレスに `/auth/device` を続けたものと、8 文字のコードを表示します。ユーザーはそのアドレスを任意のスマートフォンかコンピュータで開き、コードを入力し、ページに表示されるコンピュータの名前を確認して、サインインします。サインインは、コードを入力したブラウザで完了する必要があるため、他の人がリンクとして送ってきたサインインページでは、誰もサインインできません。

コードは 1 回だけ使え、10 分で無効になり、サインインを完了できるのは、それをリクエストした Oleafly だけです。 **自分ではないので停止**を選ぶと、キャンセルされます。1 つの IP アドレスは、10 分間に 100 個のコードをリクエストでき、誤ったコードを 10 回入力できます。これは、1 つのアドレスを共有する 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 件まで所有でき、1 時間に 300 回までアップロードできます。

オープンサインアップがオンかどうかは、管理コンソールには表示されません。サーバーのログが、起動するたびに「Open sign-up is on, so anyone who signs in gets an account as a member.」と記録します。メンバーはプロジェクトを共有するときに互いを検索できるため、誰でも入れるサーバーでは、サーバー設定の**メンバー名簿**をオフにすることを検討してください。

## 役割と権限

ユーザーには、管理者とメンテナーが付与するサーバーの役割が 1 つあります。追加されたプロジェクトごとに、そのプロジェクトの所有者が付与するプロジェクトの役割もあります。プロジェクトの役割（所有者、編集者、レビュアー、コメント投稿者、閲覧者）は[役割](/docs/collaboration/sharing/#roles)に一覧があります。

サーバーの役割だけでプロジェクトを開くことはできません。プロジェクトへのアクセスは、プロジェクトの所有者からのみ与えられます。

| 操作 | 管理者 | メンテナー | メンバー | ゲスト |
| --- | --- | --- | --- | --- |
| サーバーを Oleafly に追加する | はい | はい | はい | はい |
| メンバー一覧を見る | はい | はい | はい（管理者が非表示にしていない場合） | いいえ |
| プロジェクトを共有する | はい | はい | はい | いいえ |
| セキュリティログを読む | はい | はい | いいえ | いいえ |
| サーバーにメンバーを追加する | はい | はい | いいえ | いいえ |
| メンテナーを任命する | はい | いいえ | いいえ | いいえ |
| サーバー設定を変更する | はい | いいえ | いいえ | いいえ |
| ストレージを空けるためにプロジェクトを削除する | はい | いいえ | いいえ | いいえ |
| ユーザーのデバイスをサインアウトする | はい | はい（ただし、ほかの管理者やメンテナーのデバイスは不可） | 自分のデバイスのみ | 自分のデバイスのみ |
| サーバーに直接アクセスして保存されたプロジェクトを読む | アプリではできません | アプリではできません | アプリではできません | アプリではできません |

最後の行が最も重要です。プロジェクトはサーバー上で暗号化されていないため、マシンを運用する人は、役割にかかわらず、保存されているすべてのプロジェクトを読めます。Oleafly は、管理者を含め、どの役割にも、アプリからそれを行う手段を与えていません。管理者がストレージを空けるためにプロジェクトを削除すると、その所有者とメンバーに通知され、各自のコピーはそれぞれのコンピュータに残ります。

## ゲスト

ゲストは、他大学の共同執筆者など、サーバーの外にいるユーザーで、プロジェクトの所有者がプロジェクトに招待します。ゲストに見えるのは、招待されたプロジェクトだけです。

### ゲストをオンにする

新しいサーバーでは、ゲストはオフです。管理者が、サーバー設定の**ゲストを許可**でオンにします。 **ゲストを先に承認**は既定でオンなので、管理者かメンテナーが各招待を承認して初めて、招待が有効になります。オフにすると、招待がすぐに有効になります。管理者かメンテナーが送った招待は、すぐに承認されます。

後から**ゲストを許可**をオフにすると、所有者は新しい招待を送れなくなり、未使用の招待は無効になります。すでにサインインしたゲストは、所有者が削除するか、あなたが**ユーザー**で削除するまで、プロジェクトを保持します。

### 招待

プロジェクトにゲストを招待できるのは、そのプロジェクトの所有者だけで、プロジェクトの**共有**ダイアログから行います。

- 招待は 1 つのアドレスと 1 つのプロジェクトに対するもので、14 日後に無効になります。
- 1 人が 1 時間に送れる招待は最大 20 件です。
- 承認がオンの場合、招待は**ユーザー**の上部にある**保留中のゲスト**で待機します。管理者とメンテナーはそこで承認、辞退、取り下げができます。所有者も取り下げられます。
- サーバーがメールを送信でき、**メール通知**がオンの場合、ゲストには招待メールが届きます。そうでない場合は、Oleafly が所有者に **Oleafly に追加**リンクを表示するので、自分で送ります。
- プロジェクトがすでにサーバーが許可する上限の人数に達している場合、招待は待機し、誰かが抜けた後にそのユーザーが次にサインインしたときに有効になります。

ゲストはサーバーを追加し、招待されたアドレスを確認済みのアドレスとしてサーバーに渡すサインイン方法ならどれでもサインインできます。GitHub、OpenID Connect プロバイダ、メールのリンクです。確認されていないアドレスは対象になりません。最初のサインインでゲストアカウントが作成され、そのアドレスが招待されたすべてのプロジェクトが開けるようになります。

### ゲストにできること

ゲストは、招待されたプロジェクトを開いてコンパイルでき、役割で許可されていれば編集でき、自分のデバイスをサインアウトできます。メンバーディレクトリや誰かのメールアドレスを見ること、プロジェクトの共有、他のユーザーの招待、リンクからのプロジェクト参加はできません。ゲストに別のプロジェクトを渡すには、そのプロジェクトの所有者が同じアドレスを招待します。

ゲストが最後のプロジェクトから削除されるか、退出すると、サーバーはそのゲストのアクセスを終了します。アカウントを削除し、すべてのデバイスをサインアウトします。新しい招待を送れば、同じアカウントが戻ります。プロジェクトがまだ残っているゲストを**ユーザー**で削除した場合は、新しい招待を送っても戻りません。

### 削除は取り消されない

所有者がプロジェクトからユーザーを削除すると、ゲストかどうかにかかわらず、そのユーザーは、リンク共有がオンでも、プロジェクトのリンクから戻れません。試みるたびに、セキュリティログに記録されます。再び入れるには、所有者がもう一度追加するか、ゲストの場合は新しい招待を送ります。自分で退出したユーザーは、リンクから再び参加できます。

## ブラウザからのアクセス

ブラウザからのアクセスをオンにすると、ユーザーは Oleafly をインストールしなくても、共有されたプロジェクトを Web ブラウザで開けます。編集、変更の提案、コメント、チャットができ、最新のコンパイル済み 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/` の下にある各プロジェクトのページにも、 **ブラウザで開く**リンクが付きます。
- ユーザーは `/web/sign-in` で、Oleafly と同じプロバイダとメールのリンクを使ってサインインします。誰が入れるかも、同じアクセスルールで決まります。ブラウザは 30 日間サインインしたままになります。
- 各ブラウザは、そのアカウントのデバイスの 1 つとして数えられ、「Safari on macOS」のような名前が付きます。本人のデバイスの一覧とセキュリティログに表示され、サインアウトすると、そのブラウザのセッションが終了します。
- ブラウザは WebSocket で `/web/ws` に接続し、より遅い代わりの経路はありません。そのため、プロキシはそこへの WebSocket のアップグレードを通す必要があります。Caddy と、[リバースプロキシの内側で動かす](/docs/collaboration/server-operations/#behind-a-reverse-proxy)にある nginx と Apache の例は、すでにそうなっています。
- ユーザーが読む PDF は、所有者または編集者が Oleafly でコンパイルした最新のものです。PDF がサーバーに届く仕組みは、[コンパイル済みの PDF](/docs/collaboration/server-operations/#compiled-pdfs)で説明しています。

ブラウザ用アプリは、ほかのサイトのフレームの中には表示できません。ユーザーのアバター画像を読み込む場合を除き、接続先はあなたのサーバーだけです。

## 管理コンソール

管理コンソールは、Oleafly から 1 つのサーバーを運用するためのウィンドウです。管理者とメンテナーが開けます。 **設定 → 共同編集**で、サーバーのカードにある**管理コンソールを開く**か、 **サーバーを管理**の上部にある同じボタンを選びます。サーバーごとに専用のウィンドウが開きます。

| セクション | 表示と操作の内容 |
| --- | --- |
| **概要** | サーバーが正常か、ユーザー、デバイス、プロジェクトの数、誰がオンラインか、ストレージの使用量、メールとサインイン方法、設定の概要。サーバーにサインイン方法がない場合は**誰もサインインできません**と、データフォルダに書き込めない場合は**サーバーはファイルを保存できません**と警告します。 |
| **ユーザー** | これまでにサインインしたすべてのユーザー。役割の変更、ユーザーの停止や削除、デバイスのサインアウトができます。承認待ちのゲストの招待は、上部にあります。 |
| **アクセスルール** | 許可するユーザーのリストとドメインのルール。 |
| **プロジェクト** | サーバーで共有されているすべてのプロジェクトと、その所有者、ユーザー数、サイズ、最終アクティビティ。タイトルや所有者で検索でき、共有中、アーカイブ済み、アップロード中のプロジェクトだけを表示でき、プロジェクトのアーカイブと復元もできます。 |
| **設定** | [サーバー設定](#server-settings)。 |
| **メール** | メールが設定されているか、From アドレス、最後の失敗。ここからテストメールを送れます。 |
| **セキュリティログ** | サインインと拒否されたサインイン、デバイス、ユーザー、設定、プロジェクト、ゲスト。各項目には、誰がいつどの IP アドレスから行ったかと、プロジェクト、使用したサインイン方法、サインインが拒否された理由などの詳細が示されます。 |
| **接続チェック** | **接続をテスト**と同じチェックを、あなたのコンピュータからサーバーに対して実行します。 |

メンテナーはすべてのセクションを使えますが、誰かを管理者やメンテナーにすること、ほかの管理者やメンテナーのデバイスを見たりサインアウトしたりすること、ストレージの使用量を見ること、プロジェクトのアーカイブや復元、サーバー設定の変更、テストメールの送信はできません。管理者はそのすべてができます。

プロジェクトをアーカイブすると、全員に対する共有が停止します。ユーザーは同期を止めて各自のコピーを保持し、管理者が先に復元しない限り、サーバーは `OLEAFLY_ARCHIVE_DAYS` 日後にそのプロジェクトを削除します。復元すると、同じユーザーと再び共有されます。最初のアップロードを完了しなかったプロジェクトは復元できません。どちらもセキュリティログに記録されます。

コンソールがプロジェクトを開くことはありません。表示されるのはタイトル、所有者、サイズで、中身は表示されません。

### サーバー設定

これらはサーバーの全員に適用されます。変更できるのは管理者だけです。

| 設定 | 内容 |
| --- | --- |
| **ゲストを許可** | メンバーが、自分が所有者のプロジェクトに、サーバーの外のユーザーを招待できます。 |
| **ゲストを先に承認** | ゲストの招待が有効になる前に、メンテナーか管理者が各招待を承認します。 |
| **メンバーディレクトリ** | メンバーが、プロジェクトを共有するときに、お互いを名前で検索できます。 |
| **ディレクトリにメールアドレスを表示** | メンバーが誰かを検索したときに、お互いのメールアドレスが表示されます。 |
| **リンク共有を許可** | プロジェクトの所有者が、メンバーなら誰でもリンクからプロジェクトを開けるようにできます。 |
| **ノートの公開リンクを許可** | メンバーが、ノートの読み取り専用のコピーを、サインインなしで誰でも開けるリンクに公開できます。既定ではオフです。オフにすると、オンに戻すまで、公開済みのすべてのリンクが止まります。[読み取り専用のコピーを公開する](/docs/notes/projects-and-sharing/#publish-a-read-only-copy)を参照してください。 |
| **プロジェクトのアクセスログを許可** | プロジェクトの所有者が、誰がプロジェクトを開いたかのログを残せます。 |
| **コメントを許可** | 共有プロジェクトのユーザーが、テキストにコメントしたり返信したりできます。オフにすると、コメントはすべての場所で非表示になりますが、保存されたままです。 |
| **メール通知** | オフにすると、サインインリンクを除く、サーバーからのメールがすべてのユーザーに対して停止します。 |
| **メールでサインイン** | メールアドレスに送られたリンクでサインインできます。サーバーのメール設定が必要です。 |
