Collabora 관리 콘솔에 안전한 비밀번호를 설정하세요

Collabora Online 관리 콘솔 암호는 서버 배포 방식에 따라 설정하십시오. CODE Docker 이미지의 경우 환경 변수를 구성하고 username, passwordLinux 패키지 설치의 경우 다음 명령을 실행하십시오 coolconfig set-admin-password. 그런 다음 서비스를 다시 시작하거나 새로 생성하고 관리자 페이지에 로그인하여 새 자격 증명이 제대로 작동하는지 확인하십시오.

변경하려는 비밀번호가 무엇인지 알아두세요.

관리 콘솔은 Collabora Online의 서비스 관리 페이지입니다. Nextcloud 또는 다른 스토리지 플랫폼의 관리자 계정과는 별개이며, 관리 콘솔의 비밀번호를 변경해도 문서 사용자 로그인이나 플랫폼에서 Collabora에 연결하는 데 사용하는 자격 증명은 변경되지 않습니다. Docker 기반 설치와 패키지 기반 설치는 구성 워크플로가 다르므로 변경하기 전에 배포 환경을 정확히 확인해야 합니다.

Docker 환경에서 CODE를 사용하려면 Collabora 문서 username와 password컨테이너 환경 설정에서 해당 설정을 참조하십시오. 패키지 기반 설치의 경우 Collabora 구성 도구를 사용하여 관리자 암호를 대화형으로 설정할 수 있습니다. 현재 구성 참조에서는 admin_console.password대부분의 플랫폼에서 해당 설정을 직접 사용하는 것을 권장하지 않으며 PAM 또는 다른 방법을 사용할 것을 권장합니다 . 자세한 내용 은 Collabora의 CODE Docker 이미지 문서 와 Collabora 구성 참조를coolconfig 확인하십시오 .

자격 증명을 변경하기 전에 준비하세요

• 호스트 이름, 컨테이너 또는 서비스 이름, 그리고 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 서비스 이름이 아닌 경우 실제 서비스 이름을 사용하십시오 collabora. 이렇게 하면 Collabora 컨테이너가 다시 시작되지만 연결된 플랫폼에 저장된 문서는 삭제되지 않습니다. 배포가 Kubernetes, Helm 또는 다른 제어 플레인으로 관리되는 경우 실행 중인 컨테이너를 수동으로 수정하는 대신 해당 제어 플레인에서 관련 시크릿 또는 값을 변경하고 해당 배포의 일반적인 롤아웃 프로세스를 적용하십시오.

리눅스 패키지 설치 시 암호를 설정하세요

Collabora가 시스템 패키지로 설치된 서버에서 구성 도구를 실행하십시오.

sudo coolconfig set-admin-password

이 도구는 새 암호를 입력하라는 메시지를 표시하므로 셸 명령에 암호를 포함할 필요가 없습니다. 메시지가 나타나면 암호를 입력하고, 다시 입력하라는 메시지가 나타나면 반복하십시오. 그런 다음 서비스를 다시 시작하여 업데이트된 구성을 로드하십시오.

sudo systemctl restart coolwsd

Nextcloud의 현재 Ubuntu 설치 예제는 구성 후 coolconfig set-admin-passwordCollabora를 재시작합니다 coolwsd. 다른 배포판에서는 정확한 패키지 및 서비스 관리자가 다를 수 있으므로, 명령어나 서비스 이름을 알 수 없는 경우 해당 배포판의 Collabora 설치 지침을 참조하십시오. Nextcloud 예제는 Ubuntu 24.04 설정 가이드에 설명되어 있습니다 .

로그인 후 결과를 확인하세요

Collabora 호스트의 관리 콘솔을 엽니다. 일반적으로 `/etc/collabora/host`에서 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는 대부분의 플랫폼에서 기존 암호 설정이 더 이상 사용되지 않는다고 명시하고 있습니다.

올바른 절차를 따랐는데도 로그인할 수 없는 경우, 먼저 인스턴스와 인증 모드를 확인한 다음 새 구성이 실제로 적용되었는지 확인하십시오. 이 순서를 따르면 오래된 컨테이너나 잘못된 호스트 문제인지, 아니면 비밀번호 오타인지를 구분할 수 있으며, 다음으로 조사해야 할 부분을 명확하게 파악할 수 있습니다.