Memories / ドキュメント

このページの内容

Memories Web

ブラウザーで Memories Web を開き、既存のホスト型 Center に接続してください。これは Center クライアントであり、ブラウザー内のローカル暗号化保管庫ではありません。Center の運営者はホストされたコンテンツを読み取れます。デバイス限定のシークレット、エンドツーエンドのペアリング、競合解決には引き続きネイティブクライアントを使用してください。

接続

アカウント認証が有効な場合は、ログインまたは登録を選択します。メール登録では、有効期間 15 分のワンタイム確認コードが送信されます。コードを入力し、12-256 UTF-8 バイトのパスワードを選択して非公開のホスト型保管庫を作成し、その後ログインします。運営者が選択した場合はユーザー名による登録も利用できます。登録はログインとは独立して停止できます。SMTP の失敗によって検証が省略されることはありません。パスワードのリセットやメールアドレス/ユーザー名の変更には、まだ対応していません。

管理者が用意したメンバーや古い Center では、トークンを使用を選択します。

  1. Center の HTTPS オリジンと、メンバートークンまたはスコープ付き許可トークンを管理者から入手します。管理者トークンはコンテンツへのアクセスを許可しません。
  2. Web にオリジンとトークンを入力します。ホスト型 SaaS では https://memories.ivjn.us を使用します。公開 Web ページは既定でこのアドレスを選択します。独自の Center(たとえば https://center.example.com)も入力できます。URL にトークンやパスワードを含めないでください。既存のメンバートークンは引き続き機能し、パスワードアカウントに自動変換されることはありません。
  3. 接続後、許可された保管庫とスコープが表示されます。読み取り、書き込み、削除の操作は許可に従い、サーバーは各操作を独立して強制します。

記憶、ナレッジカード、ファイルの閲覧、タイトル/タグの検索、記憶/カード本文の作成と編集、カードのタグと非公開設定の編集、最大 12 MiB のファイルのアップロード、ファイルのダウンロード、許可がある場合の項目削除が可能です。追加のカードフィールドは読み取り専用で表示され、機密フィールドは非表示です。本文を更新しても、サーバー上の既存の構造化メタデータと保護されたメタデータは保持されます。このクライアントでは認証情報、E2E シークレット素材、競合リビジョンは編集できません。ファイルは添付ファイルとしてダウンロードされ、ページ内で実行やプレビューされることはありません。

Center とともにデプロイする

新しい Center ビルドには、同じフロントエンドが /app/ に含まれています。追加のウェブサーバーは不要です。リモートアクセスには Center の前段にある既存の HTTPS リバースプロキシを使用してください。平文 HTTP は、ローカル開発用のループバックでのみ対応します。

同一オリジンの使用(https://center.example.com/app/ から https://center.example.com への接続)には CORS 設定は不要です。公開ウェブサイトをフロントエンドとして使用するには、Center の起動時にその特定のオリジンを許可します。

memories-center --data /path/to/center --web-origin https://memories.ivjn.us

署名、管理者トークン、許可、ホスト型保管庫のパスワードには既存の保護された環境設定を維持してください。--web-origin は繰り返し指定またはカンマ区切りで指定でき、MEMORIES_CENTER_WEB_ORIGINS は同等の環境設定です。明示的な localhost/ループバック開発オリジンを除き、HTTPS オリジンが必要です。ワイルドカード、認証情報を含む URL、パス、クエリ、フラグメントは受け付けません。

CORS は、ホスト型セッション、アカウント認証、記憶、RPC のエンドポイントに限定されます。管理、登録、許可管理のエンドポイントへのブラウザーアクセスを許可せず、Bearer 認証も緩和しません。既存の Center で /app/ を提供したり、このオリジン設定を使用したりするには、アップグレードが必要です。同等の厳密なオリジンポリシーをすでに実装しているリバースプロキシは、代わりに既存のコンテンツ API を提供できます。

セッションの動作

アカウントログインで、1 時間の Bearer 許可が作成されます。切断時には、ページのロックや終了の場合を含めて、そのセッションの取り消しを試みます。ブラウザーがログアウトリクエストを送信できない場合、許可はサーバーで強制される期限まで有効です。登録の停止やモード変更によって既存のアカウントは終了しません。

Bearer と返されたコンテンツは、localStorage、sessionStorage、IndexedDB、サービスワーカーのキャッシュには保存せず、ページのメモリにのみ保持します。保存するのは言語設定だけです。再読み込み、ページからの移動、バックグラウンドへの移行、または操作なしで 5 分が経過すると、接続と表示中のコンテンツが消去されます。自動ロック時に未保存の変更は破棄されます。JavaScript のガベージコレクションはメモリの物理的消去を保証せず、ブラウザー拡張機能やデバッグツールは内容を調べることができ、ダウンロードしたファイルはデバイスに残ります。

クライアントは各トークンを選択されたオリジンに結び付け、リダイレクトを拒否します。切断時には保留中のリクエストをキャンセルし、遅れて到着した応答を破棄します。サーバーに到達したリクエストはキャンセル後も完了する可能性があります。中断した書き込みを再試行する前に結果を確認してください。

中国語版の使用説明

Web 版を開き、自分の Center の HTTPS アドレスと、管理者から提供されたメンバートークンまたは許可トークンを入力してください。ホスト型 SaaS のアドレスは https://memories.ivjn.us で、公式サイトの Web 版は既定でこのアドレスを選択します。独自の Center に手動で接続することもできます。アカウントサービスが有効な場合、ログインまたは登録を選択できます。メールモードではメールを検証してからパスワードを設定し、ユーザー名モードでは直接アカウントを作成します。管理者は登録を停止できますが、既存のアカウントは引き続きログインできます。既存のメンバーは「トークンを使用」を選択できます。管理者トークンをコンテンツへのログインに使用することはできません。

接続後は記憶/カード/ファイルの閲覧、タイトルとタグによる検索、記憶とカードの本文、タグ、非公開フラグの編集、最大 12 MiB のファイルのアップロードとダウンロード、権限がある場合のコンテンツ削除ができます。カードの追加フィールドは現在読み取り専用で、機密フィールドは非表示のままです。本文の編集はサーバー上の既存の構造化情報を上書きしません。認証情報、デバイスのエンドツーエンドシークレット、バージョン競合については、引き続きネイティブクライアントを使用してください。

新しい Center には /app/ ページが含まれ、同一オリジンの接続にはクロスオリジン設定は不要です。公式サイトから自分の Center に接続する場合は、サービスに --web-origin https://memories.ivjn.us を追加し、元の保護されたサービス環境設定を引き続き使用してください。これは指定されたコンテンツインターフェースのブラウザーオリジンのみを開放し、リクエストごとのトークンと権限の検証を変更しません。

トークンとコンテンツはページのメモリにのみ保持されます。再読み込み、バックグラウンドへの移行、または 5 分間のアイドル状態でロックされ、ページの情報が消去されます。自動ロックは未保存の編集を破棄します。データは Center に保存され、サーバー運営者が読み取れます。このバージョンはブラウザー内のローカル暗号化保管庫を提供しません。ネットワークが中断した場合は、まず再読み込みして書き込み結果を確認し、重複送信を避けてください。