Collabora Onlineの管理コンソールパスワードの設定方法

Collabora Onlineを開くことはできるものの、管理コンソールにサインインできない場合は、Collaboraサーバーの認証情報が正しく設定されていない可能性があります。解決策はCollaboraのインストール方法によって異なります。Linuxパッケージのインストールではcoolconfigユーティリティを使用し、公式のCODE Dockerイメージでは環境変数を使用しますusername。passwordこれらはそれぞれ異なる設定パスですので、ご自身の環境に合ったパスを選択してください。

管理コンソールはサーバー側の管理ページです。これは、Nextcloud管理者アカウント、ドキュメントユーザーのログイン、またはWOPI統合認証情報とは異なります。CollaboraのSDKマニュアル24.04には、コンソールアドレス、Linux構成方法、およびDockerイメージ変数が記載されています。デプロイの詳細はリリース間で変更される可能性があるため、本番環境に変更を加える前に、実行しているバージョンのドキュメントを確認してください。CollaboraオンラインSDKマニュアル24.04を参照してください。

インストール環境に合った構成方法を選択してください。

まず、デプロイメントを特定します。coolwsdシステムサービスとして直接実行され、ホストにcoolconfigコマンドがある場合は、パッケージ方式を使用します。サービスが に基づくコンテナ内で実行されている場合はcollabora/code、代わりにその環境を構成します。ホストにパスワードを設定して、既に実行中のコンテナを変更することは避けてください。

Linuxパッケージのインストールでは、パスワードを対話的に設定してください。

1. Collaboraサーバー上でターミナルを開くか、sudo権限を持つアカウントを使用してSSH経由で接続してください。
2. 走るsudo coolconfig set-admin-password。
3. プロンプトが表示されたら、管理コンソールのユーザー名とパスワードを入力し、パスワードを確認してください。入力中に端末にパスワードが読み上げられることはありません。
4. 構成変更後にサービスの再起動が必要な場合は、 を実行しますsudo systemctl restart coolwsd。 でサービスの状態を確認しますsudo systemctl status coolwsd。
5. 管理コンソールのURLを開き、先ほど設定した認証情報でサインインしてください。

ドキュメントに記載されているユーティリティは、ユーザー名とパスワードを対話形式で入力するように求め、パスワードをソルト付きハッシュとして設定ファイルに保存します。これは、平文のパスワードをコマンドラインに直接入力したり、XMLファイルに手動で書き込んだりするよりも推奨されます。このコマンドは管理操作として扱ってください。CollaboraがNextcloudホストにもインストールされていない限り、NextcloudホストではなくCollaboraホスト上で実行してください。

が見つからない場合はcoolconfig、パッケージベースの Collabora インストールであること、および正しいサーバーに接続していることを確認してください。CODE コンテナには独自の構成メカニズムがあります。コマンドが成功しても認証が失敗する場合は、ホスト名とポートを確認し、設定したユーザー名で再試行し、無関係なプロキシまたは WOPI 設定を変更する前にサービスログを確認してください。

CODE Dockerイメージの場合、両方の環境変数を設定します。

公式のCODEイメージは、コンテナ起動時に環境変数からusernameとを読み取りますpassword。両方の値をコンテナ構成に追加してください。パスワードだけを設定するだけでは不十分です。Docker Composeの場合、マッピングは次のようになります。

services:
  collabora:
    image: collabora/code
    restart: unless-stopped
    ports:
      - "9980:9980"
    environment:
      username: collabora_admin
      password: ${COLLABORA_ADMIN_PASSWORD}

実際のパスワードは、ソースリポジトリにコミットしたり、公開サポートリクエストに貼り付けたりするのではなく、保護された環境ファイルまたはデプロイメントシークレットストアに保存してください。Compose.envファイルは変数置換に便利ですが、機密データを含むファイルであるため、読み取り権限を制限してください。Dockerデーモンへのアクセス権を持つユーザーは一般的にコンテナ構成を検査できるため、環境変数はホスト上のアクセス制御の代わりにはなりません。

Compose ファイルを保存し、コンテナを再作成して、Docker が起動時に更新された環境を渡すようにします。 という名前のサービスの場合collabora、通常は ですdocker compose up -d --force-recreate collabora。単純なコンテナの再起動では、そのコンテナが作成されたときに保存された環境値は置き換えられません。コマンドを実行する前に Compose のバージョンとサービス名を確認し、シェル履歴にパスワードをそのまま表示しないようにしてください。

直接docker runデプロイの場合、同等の設定は-e、やなどの-e username=collabora_admin環境変数として渡されます-e password=...。値を指定するには、独自のシークレット管理方法を使用してください。チュートリアルからサンプルパスワードをコピーして、インターネットに公開されているサービスに貼り付けないでください。

管理コンソールを開いてログインを確認してください

ドキュメントに記載されているコンソールパスは です/browser/dist/admin/admin.html。デフォルトポートの場合、完全なURLは ですhttps://your-collabora-host:9980/browser/dist/admin/admin.html。TLSがリバースプロキシで終端する場合は、そのプロキシが公開しているパブリックHTTPSホスト名とポートを使用してください。管理者がデフォルト以外のポートまたはURLルーティングを設定している場合は、アドレスが異なる場合があります。

サインインして、コンソールが監視情報をロードしたことを確認してください。SDK マニュアルには、開いているドキュメントやユーザーなど、ライブセッション監視について説明されています。コンソールは操作の詳細を公開し、ドキュメントセッションを閉じるなどの管理操作を可能にするため、アクセスを信頼できる管理者のみに制限し、HTTPS を使用し、管理エンドポイントをパブリックインターネットに広く公開しないようにしてください。展開環境でファイアウォールまたはリバースプロキシがサポートされている場合は、ネットワーク制限を適用してください。

パッケージのインストールについては、サービスが正常であることを確認してくださいsudo systemctl status coolwsd。Docker の場合は、コンテナの状態をdocker compose ps、最近のログをで確認してくださいdocker compose logs --tail=100 collabora。サービスが正常であるだけでは、パスワードが正しいことを証明するものではありません。最終的な確認は、管理コンソールの URL で正常にサインインすることです。

よくある誤解と、その対処法

「管理コンソールは私のNextcloudのパスワードを使用します。」

デフォルトでは有効になっていません。Collabora Admin Console の認証情報は、Nextcloud ユーザー アカウントとは別に Collabora サーバー上で設定されます。対処方法：coolconfig set-admin-passwordパッケージのインストール時に使用するか、CODE コンテナ環境を更新してコンテナを再作成してください。

「Docker Composeファイルを変更したので、実行中のコンテナには新しいパスワードが設定されています。」

ファイルを編集しても、既存のコンテナの保存済み環境は変更されません。対処方法：該当するComposeサービスを再作成し、新しい認証情報をテストしてください。パスワードはコマンド出力やバージョン管理システムには含めないでください。

「管理コンソールのURLが開けば、サーバーは安全に保護されています。」

ページへのアクセスは、ルートが応答することのみを証明するものであり、強力な認証情報が設定されていることや、ネットワークアクセスが制限されていることを証明するものではありません。SDKマニュアルには、必要なユーザー名またはパスワードが設定されていない場合、コンソールが無効になること、および管理監視機能について記載されています。対処方法：一意のパスワードを設定し、認証が必要であることを確認し、コンソールエンドポイントにアクセスできるユーザーを制限してください。

「管理コンソールは、文書編集の認証情報を設定する場所です。」

コンソールパスワードは管理インターフェースを保護するためのものであり、WOPIホストの設定やファイルプラットフォームで使用されるIDシステムに取って代わるものではありません。対処方法：個別の接続のトラブルシューティングを行う場合を除き、WOPIおよびリバースプロキシの設定は変更しないでください。

ログインがまだ失敗する場合は

• Collaboraがホストサービスとして実行されているか、CODEコンテナ内で実行されているかを確認し、一致する構成パスのみを使用してください。
• HTTPS、ポート、およびを含む正確な公開コンソール URL を確認してください/browser/dist/admin/admin.html。
• Docker の場合、有効なサービス構成に とusernameの両方passwordが存在することを確認し、変更後にコンテナを再作成してください。
• パッケージのインストールについては、coolconfigCollaboraホスト上で対話型コマンドを再実行し、coolwsdステータスとログを確認してください。
• リバースプロキシが関与している場合は、管理者に管理コンソールのルートと必要なWebSocketトラフィックが正しく通過していることを確認してもらうよう依頼してください。プロキシの問題を回避するために認証を弱めないでください。

ログインできてサービスが正常に動作していることを確認したら、新しい認証情報を承認済みのパスワードマネージャーに保存し、どのホストまたはコンテナがその認証情報を所有しているかを記録してください。Collabora の管理コンソールの設定は、リリースやパッケージング方法によって異なる場合があります。上記の 24.04 SDK マニュアルはバージョン固有のものであるため、より新しいバージョンまたはベンダーがカスタマイズしたデプロイメントの場合は、対応するドキュメントを使用してください。