# Server SDK

> アプリケーションのドキュメントサービス、ストレージ、アクセス権限を準備します。

- Human documentation: [https://docs.univer.ai/ja-JP/server](https://docs.univer.ai/ja-JP/server)

- Agent Markdown: [https://docs.univer.ai/ja-JP/server.md](https://docs.univer.ai/ja-JP/server.md)

- Requested language: `ja-JP`

- Content language: `ja-JP`

- Documentation version: `1.1.0`

- Source: [index.ja-JP.mdx](https://github.com/dream-num/documentation/blob/dev/content/server/index.ja-JP.mdx)

---

**Univer Server SDK は組み合わせて使うモジュール群です。** 必要なモジュールを自分のバックエンドに組み込み、そのアプリをデプロイします。認証、権限、文書の所有関係、ファイル保存、運用はアプリ側の責任です。

このページではバックエンドの設定、ストレージ、権限を説明します。[共同編集の統合](https://docs.univer.ai/ja-JP/server/collaboration/browser-integration.md)ではエディターを共有ドキュメントに接続し、[ファイル交換の統合](https://docs.univer.ai/ja-JP/server/import-export.md)ではアップロード、変換、ダウンロードを扱います。必要な機能のガイドを選んでください。ライセンスが必要な機能は[ライセンス設定](https://docs.univer.ai/ja-JP/server/license.md)から始めます。ブラウザー内だけでの編集に共同編集サービスは不要です。

## 統合の順序

1. [Quick Start](https://docs.univer.ai/ja-JP/server/collaboration/quick-start.md)：独立した 2 つのブラウザー環境で双方向編集を確認します。
2. [永続化](https://docs.univer.ai/ja-JP/server/collaboration/database-adapters.md#verify-persistence)：SQLite サンプルを再起動し値を確認します。
3. [認証と権限](https://docs.univer.ai/ja-JP/server/collaboration/identity-and-authorization.md#verify-permissions)：editor と viewer を確認します。
4. [業務フロントエンド](https://docs.univer.ai/ja-JP/server/collaboration/browser-integration.md)：デモの認証、文書作成、URL を置き換えます。
5. [拡張機能](https://docs.univer.ai/ja-JP/server/collaboration/examples.md)：履歴、コメント、Worktree、Exchange を追加します。ファイル変換だけなら [Exchange](https://docs.univer.ai/ja-JP/server/import-export/node.md) から開始できます。

## 必要なサービスを選ぶ

| 要件              | バックエンドの準備                     | 実装ガイド                                                                                        |
| --------------- | ----------------------------- | -------------------------------------------------------------------------------------------- |
| 共有ドキュメントの編集     | Collaboration SDK、ドキュメント保存、権限 | [共同編集クイックスタート](https://docs.univer.ai/ja-JP/server/collaboration/quick-start.md)                                            |
| Office ファイルの入出力 | 変換、アップロード、タスク照会、ダウンロード        | [ファイル変換](https://docs.univer.ai/ja-JP/server/import-export/node.md)と [Exchange の例](https://docs.univer.ai/ja-JP/server/collaboration/examples.md#exchange) |
| 履歴や共有コメント       | それぞれのサービス、ストレージ、権限            | [拡張モジュール](https://docs.univer.ai/ja-JP/server/collaboration/extensions.md)                                                  |

必要な機能だけを選びます。ファイル変換だけなら共同編集は不要です。[SDK 環境](https://docs.univer.ai/ja-JP/server/requirements.md)を準備し、Univer パッケージのバージョンに互換性を持たせてください。

## アプリケーションとストレージの接続

選んだサービスの例を実行してから、バックエンドに接続します。共同編集ドキュメントはアプリケーションが作成し、所有者を記録して ID をブラウザーに返します。作成 API は[モジュールの境界](https://docs.univer.ai/ja-JP/server/collaboration/modules.md)を参照してください。ユーザー、プロジェクト、フォルダーは引き続きアプリケーションが管理します。

共同編集の例はメモリストレージを使用するため、再起動で内容が失われます。[データベースアダプター](https://docs.univer.ai/ja-JP/server/collaboration/database-adapters.md)に従ってデータベースを接続し、保存したドキュメントが再起動後も残ることを確認してください。

ファイル変換でもアップロード、タスク、ダウンロードの保存とクリーンアップが必要です。[Exchange の例](https://docs.univer.ai/ja-JP/server/collaboration/examples.md#exchange)を参照してください。

## ログインと権限の接続

[ID と認可](https://docs.univer.ai/ja-JP/server/collaboration/identity-and-authorization.md)に従って既存のログイン資格情報を検証し、ユーザーがドキュメントを読み取り・変更できるか確認します。例の固定ユーザーと全許可のルールを置き換えてください。

ドキュメントの読み取り、共同編集接続、編集内容の送信、有効にした履歴・コメント・ダウンロードを保護します。ブラウザーの読み取り専用設定はサーバーの権限検証の代わりにはなりません。

## デプロイとフロントエンドの接続

アプリケーションのドメインにインターフェースを配置します。共同編集ではプロキシが HTTP と WebSocket の両方を転送する必要があり、HTTPS ページは WSS を使います。アップロードを制限し、変換失敗とタイムアウトを処理してください。単一マシンからインポートとエクスポートの分離、複数の共同編集ノードへ進む手順は[デプロイガイド](https://docs.univer.ai/ja-JP/server/deployment.md)を参照してください。

バックエンドの準備ができたら、対象機能の統合を完了します。

* [共同編集の統合](https://docs.univer.ai/ja-JP/server/collaboration/browser-integration.md)：エディターの接続、共有ドキュメントの作成と表示、同期の検証。
* [ファイル交換の統合](https://docs.univer.ai/ja-JP/server/import-export.md)：アップロード、変換、ダウンロードの接続と実際のファイルでの確認。