メインコンテンツまでスキップ

統合

統合設定​

統合セクションでは、LDAP設定を有効にし、SSO設定を有効にし、プラグインを追加し、ワークスペースをサードパーティサービスと統合し、SMTP設定を調整することができます。ドキュメントサービスの設定を確認または構成することもできます。

LDAP設定​

ONLYOFFICE Appsを使用する際、最初に行うべきことは、会社の全従業員のアカウントを作成することです。しかし、従業員数が50人以上の場合、新しいワークスペースユーザーを作成するプロセスには多くの時間がかかります。LDAP設定オプションを使用すると、必要なユーザーとグループをLDAPサーバー（例：OpenLDAPサーバーやMicrosoft Active Directory）からワークスペースに数分でインポートすることができます。新しく作成されたユーザーは、LDAPサーバーに保存された資格情報を使用してワークスペースにサインインするため、新しいパスワードやログインを覚える必要はありません。

SaaSバージョンでは、これは有料機能です（有料のビジネスプランでのみ利用可能）。

必要なフィールドに入力し、保存をクリックしてください。

LDAP設定 - メインページ

各フィールドと対応する値の詳細については、こちらの指示をご参照ください。

シングルサインオン設定​

シングルサインオンセクションでは、SAMLを使用したサードパーティ認証を有効/無効にすることができ、ユーザーにワークスペースへのより迅速で簡単かつ安全なアクセス方法を提供します。

SaaSバージョンでは、これは有料機能です（有料のビジネスプランでのみ利用可能）。

一般的に、シングルサインオン技術は、ユーザーが一度サインインするだけで、複数の認証された（つまり、アイデンティティプロバイダーと統合された）アプリケーション/サービスにアクセスできるようにします。

SSO認証の有効化

SSOの設定について詳しくは、この記事をお読みください。

プラグイン​

ワークスペースを拡張するためにプラグインを追加します。

プラグインには2種類あります：システムプラグイン（自社開発）とカスタムプラグインです。このページでカスタムプラグインをアップロードすることができますが、このオプションは設定で有効にする必要があります。

SaaSバージョンでは、いくつかの制限があります：

  • プラグインはzip形式でアップロードでき、以下の構造を持つ必要があります：

    - config.json
    - plugin.js
    - assets
      - image1
      - ...
      - imageN

  • アーカイブ自体と各ファイルの最大サイズは5MBに制限されています。

  • 画像の最大数は10です。

  • 画像形式のリストは以下のものに制限されています：.jpg, .jpeg, .png, .svg。

現在、以下のシステムプラグインが利用可能です：draw.io、pdf-converter、speech-to-text、markdown、zip-archives、image-editor、codemirror。

サーバーバージョンでは、設定と構成が許可する場合、システムプラグインを削除することができます。

互換性のないバージョンのプラグインは赤で強調表示されます。古いプラグインバージョンにカーソルを合わせるか、新しいカスタムプラグインをアップロードすると、互換性のあるバージョンに更新するように促されます。

デベロッパーツール

注記

すでにインストールされているプラグインと同じバージョンをアップロードすると、キャッシュに関する警告が表示されます。変更を反映させるには、プラグインのキャッシュをクリアするか、バージョン番号を上げてください。

プラグインの警告

プラグインSDKの詳細については、api.onlyoffice.comをご参照ください。

サードパーティサービスの統合​

認証キーを使用して、ワークスペースをサードパーティサービスと接続します：Amazon AWS S3、Apple、Box.com、DropBox、Facebook、Google Cloud Storage、LinkedIn、Nextcloud、OneDrive、Telegram、X、Rackspace Cloud Storage、WeChat、Zoom。

SaaSバージョンでは、いくつかのサービスは有料のビジネスプランでのみ利用可能です（Amazon AWS S3、Google Cloud Storage、Rackspace Cloud Storage）。

  • Apple、FB、LinkedIn、Nextcloud、X、WeChat、Zoomアカウントを接続して、ワークスペースに迅速にログインできます。クラウドバージョンでは、これらのサービスの認証キーのパラメータは自動的に設定されます。Zoomとの統合は現在サーバーバージョンでのみ利用可能です。
  • ワークスペースをBox、Dropbox、OneDriveとリンクして、バックアップ作成時に接続されたアカウントをサードパーティリソースとして使用します。クラウドバージョンでは、これらのサービスの認証キーのパラメータは自動的に設定されます。
  • Amazon AWS S3、Google Cloud Storage、Rackspace Cloud Storageサービスを接続して、バックアップ作成時に接続されたクラウドストレージをサードパーティストレージとして使用します。
  • Telegramサービスを接続して、Telegramを通じてワークスペース通知を受け取ります。

サードパーティサービスの統合の詳細については、こちらの指示をご参照ください。

統合設定の調整

SMTP設定​

SMTP設定サブセクションでは、ワークスペースを設定して、独自のSMTPサーバーを使用してメール通知を送信できるようにします。そのためには、

  • ホストフィールドに、使用しているSMTPサーバーのドメイン名を指定します。

  • ポートフィールドに、SMTPポート番号を指定します。ポート587または25を使用することをお勧めします。

  • SMTPサーバーが認証を必要とする場合は、認証スイッチをオンにします。

  • ホストログインおよびホストパスワードフィールドに、SMTPサーバーにアクセスするために使用するログインとパスワードを指定します。

  • NTLMによる認証ボックスをチェックして、SaslMechanismNtlmを使用してログインできるようにします。

  • 送信者表示名フィールドに、From: フィールドに表示される送信者の名前を指定します。

  • 送信者メールアドレスフィールドに、送信者のメールアドレスを指定します。

  • SSLを有効にするボックスをチェックして、暗号化された接続を有効にします。

  • 保存ボタンをクリックします。変更を破棄してデフォルトのサーバーに戻すには、デフォルト設定ボタンをクリックします。

    注記

    指定した設定が正しいかどうかを確認するには、テストメールを送信ボタンをクリックしてください。設定が正しく指定されている場合、ユーザープロフィールに指定されたメールアドレスにSMTPテストメッセージが届きます。

SMTP設定の調整

ドキュメントサービス設定​

ドキュメントサービスサブセクションには、ファイルの編集とOfficeOpen XML形式への変換に使用されるONLYOFFICE Docsサービスの設定が表示されます。SaaSバージョンでは、ワークスペースがデフォルトで使用するサービスが表示されます。サーバーバージョンでは、ここで独自のONLYOFFICE Docsを接続できます。手順は以下の通りです：

注記

ONLYOFFICE編集エンジンをクラウドで実行し、代わりに独自のプラットフォームに接続するには、Docs Connectを使用してください。

  1. ワークスペースの設定に移動し、統合 > ドキュメントサービスセクションを選択します。

  2. ドキュメント編集サービスアドレスフィールドに入力します。ONLYOFFICE DocsがインストールされているURLアドレスを指定してください。ONLYOFFICE Docsをカスタムポートにインストールした場合は、ポートを指定する必要があります。例：http://127.0.0.1:8081/

    重要

    ONLYOFFICE DocsのアドレスはONLYOFFICE Appsからアクセス可能でなければならず、またONLYOFFICE AppsのアドレスもONLYOFFICE Docsからアクセス可能でなければなりません。

  3. 自己署名証明書を使用している場合、 証明書の検証を無効にする（非推奨） オプションをチェックして、証明書の検証を無効にし、ワークスペースがONLYOFFICE Docsと接続できるようにすることができます（そうでない場合、ワークスペースは自己署名証明書を検証せず、ONLYOFFICE Docsとの接続を許可しません）。これは安全でない解決策であり、CAから発行された証明書に置き換えることを強くお勧めします。

  4. データの署名に使用するシークレットを指定してシークレットキーフィールドに入力します。この設定を無効にするには空欄のままにしておくことができます。

    注記

    ONLYOFFICE Docs v7.2以降、JWTはデフォルトで有効になっており、シークレットキーは自動的に生成されます。ONLYOFFICE Appsの設定ファイルにもJWTパラメータを指定する必要があります。詳細については、この記事を参照してください。

    ONLYOFFICE Docsの接続

  5. 詳細サーバー設定セクションの横にある表示リンクをクリックします。

  6. 認証ヘッダーフィールドに入力します。デフォルトのヘッダーを使用するには空欄のままにしておくことができます。

  7. ネットワーク構成がインストールされたONLYOFFICE AppsとONLYOFFICE Docs間のパブリックアドレスを使用したリクエストを許可しない場合、内部リクエスト用のアドレスを対応するフィールドに指定します：

    • ワークスペースからの内部リクエスト用のドキュメントサービスアドレスフィールドに入力します。ONLYOFFICE AppsからONLYOFFICE Docsにアクセスするために使用するアドレスを指定します。
    • ドキュメントサービスからの内部リクエスト用のワークスペースアドレスフィールドに入力します。ONLYOFFICE DocsからONLYOFFICE Appsにアクセスするために使用するアドレスを指定します。

    ONLYOFFICE Docs/ONLYOFFICE Appsのインストールがhttpsに切り替えられていない場合、アドレスにhttpを指定してください。

  8. 保存ボタンをクリックして設定を保存します。変更を破棄してワークスペースがデフォルトで使用する設定に戻すには、デフォルト設定ボタンをクリックします。

重要

別のマシンにインストールされた外部エディターを接続した場合、ワークスペースにアップロードしたライセンスファイルをこの外部マシンのDocsにも複製してください。

例えば、DocsのDockerバージョンがインストールされたマシンでは、デフォルトのパスは/var/www/onlyoffice/Data/license.licです。他のOSのパスについてはこの記事を参照してください。