Collabora管理コンソールに安全なパスワードを設定する

Collabora Online 管理コンソールのパスワードは、サーバーのデプロイ方法に応じて設定してください。CODE Docker イメージの場合は、環境変数usernameとpassword環境変数を設定します。Linux パッケージのインストールの場合は、を実行しますcoolconfig set-admin-password。その後、サービスを再起動または再作成し、管理ページにサインインして、新しい認証情報が正しく機能することを確認してください。

変更するパスワードを把握しておきましょう

管理コンソールは、Collabora Onlineのサービス管理ページです。Nextcloudなどのストレージプラットフォームの管理者アカウントとは別個のものであり、パスワードを変更しても、ドキュメントユーザーのログイン情報や、プラットフォームがCollaboraに接続するために使用する認証情報は変更されません。また、Dockerとパッケージベースのインストールでは構成ワークフローが異なるため、変更を加える前にデプロイメントを特定してください。

Docker 内の CODE については、Collabora のドキュメントusernameおよびpasswordコンテナ環境設定を参照してください。パッケージベースのインストールの場合、Collabora の設定ツールで管理者パスワードを対話的に設定できます。現在の設定リファレンスでは、admin_console.passwordほとんどのプラットフォームでこの設定を直接使用することは非推奨とされており、代わりに PAM または の使用が推奨されていますcoolconfig。Collaboraの CODE Docker イメージのドキュメントおよびCollabora の設定リファレンスを参照してください。

資格情報を変更する前に準備してください

• ホスト名、コンテナ名またはサービス名、そしてCollaboraがDocker上で動作しているかLinuxパッケージとして動作しているかを確認してください。複数のインスタンスがある場合は、どのインスタンスがユーザーにサービスを提供しているかをメモしておいてください。
• 固有のパスワードを選択し、パスワードマネージャーまたはデプロイメントシークレットストアに保存してください。チュートリアルのサンプルパスワードは使用しないでください。
• Docker Compose を管理している場合は、機密情報をコミットせずに Compose ファイルをバックアップまたはコミットしてください。機密情報を含むファイルへのアクセスを制限してください。環境変数は、コンテナを検査できる管理者には引き続き表示されます。
• 管理エンドポイントは、通常のアクセス制御の背後に設置してください。強力なパスワードは有効ですが、管理ページへのアクセス権限を制限することに代わるものではありません。

CODE Dockerコンテナのパスワードを設定します

Collabora の Compose サービスで、ドキュメントに記載されている変数を設定しますusername。この例では、パスワードをCompose ファイルに直接記述するのではなく、passwordローカル ファイルから読み込みます。.env

services:
  collabora:
    image: collabora/code
    environment:
      username: admin
      password: "${COLLABORA_ADMIN_PASSWORD:?Set it in .env}"

同じプロジェクトディレクトリ内に、シークレットを次の場所に配置します.env。

COLLABORA_ADMIN_PASSWORD=replace-with-your-unique-secret

サンプル値を実際のパスワードに置き換えてください。また、.env共有リポジトリにはコミットしないでください。Composeサービスが既に存在する場合、ディスク上の環境を変更しても、実行中のコンテナの環境は変更されません。新しい設定を有効にするには、そのサービスを再作成してください。

docker compose up -d --force-recreate collabora

Compose サービス名が空でない場合は、実際の Compose サービス名を使用してくださいcollabora。これにより Collabora コンテナが再起動されますが、接続されているプラ​​ットフォームに保存されているドキュメントは削除されません。デプロイメントが Kubernetes、Helm、またはその他のコントロール プレーンによって管理されている場合は、実行中のコンテナを手動で編集するのではなく、対応するシークレットまたは値を変更し、そのデプロイメントの通常のロールアウト プロセスを適用してください。

Linuxパッケージのインストール時にパスワードを設定する

Collaboraがシステムパッケージとしてインストールされているサーバー上で、設定ツールを実行します。

sudo coolconfig set-admin-password

ツールは新しいパスワードの入力を求めるため、シェルコマンドにパスワードを含める必要はありません。プロンプトが表示されたらパスワードを入力し、求められたら再度入力してください。その後、サービスを再起動して更新された設定を読み込みます。

sudo systemctl restart coolwsd

Nextcloudの現在のUbuntuインストール例では、設定後にcoolconfig set-admin-password再起動も行われますcoolwsd。パッケージやサービスマネージャはディストリビューションによって異なる場合があります。コマンドやサービス名が利用できない場合は、そのディストリビューションのCollaboraインストール手順を参照してください。Nextcloudの例は、Ubuntu 24.04セットアップガイドに記載されています。

ログインして結果を確認してください

Collaboraホストの管理コンソールを開きます。通常は （https://collabora.example.com/browser/dist/admin/admin.html例のホストはご使用のサーバーの公開URLに置き換えてください） 設定済みの管理者ユーザー名と新しいパスワードでサインインします。サインインが成功すると、コンソールが認証情報を受け入れたことが確認できますが、ドキュメント編集やWOPI接続が正常であることはそれ自体では確認されません。

1. Docker でログインに失敗した場合は、実際にその URL を提供している Compose プロジェクトを編集したこと、変数名が正確にusernameまたは であることpassword、および変更後にコンテナを再作成したことを確認してください。
2. パッケージのアップデート後にログインに失敗した場合は、coolwsdシステムが正常に再起動され、ブラウザが目的のサーバーに接続できていることを確認してください。サポート投稿に機密情報をコピーせずに、サービスログで構成エラーを確認してください。
3. PAM認証を有効にした場合、設定された値admin_console.usernameはadmin_console.password無視されます。代わりに、ホスト用に設定されたPAMアカウントとパスワードを使用してください。CODE Docker環境変数を変更しても、PAMは上書きされません。
4. ログインはできるものの、管理ページが表示されない場合は、リバースプロキシのCollaboraルーティングとアクセスポリシーを確認してください。プロキシまたはネットワークの問題は、パスワードが拒否された場合とは異なります。

避けるべきよくある間違い

管理コンソールのパスワードをNextcloudの管理者パスワードと混同しないでください。また、docker run -e password=...シェル履歴やプロセス検査などでシークレットが漏洩する可能性があるため、シークレットをコマンドに貼り付けないでください。Composeデプロイメントの場合は、シークレットを保護された環境ファイルまたは利用可能なシークレットマネージャーに保存し、アクセスをDockerホストに制限してください。また、直接編集することは避けてくださいcoolwsd.xml。Collaboraは、従来のパスワード設定をほとんどのプラットフォームで非推奨としています。

正しい手順を踏んでもログインできない場合は、まずインスタンスと認証モードを確認し、次に新しい設定が実際に適用されていることを確認してください。この手順を踏むことで、古いコンテナや間違ったホストをパスワードの入力ミスと区別でき、次に調査すべき箇所が明確になります。