Collabora Online 관리자 콘솔 비밀번호 설정 방법

Collabora Online은 실행되지만 관리 콘솔에 로그인할 수 없는 경우, Collabora 서버에 대한 자격 증명이 구성되지 않았을 수 있습니다. 해결 방법은 Collabora 설치 방식에 따라 다릅니다. Linux 패키지 설치의 경우 유틸리티를 사용하고 coolconfig, 공식 CODE Docker 이미지의 경우 환경 변수를 사용합니다 username. password이 두 가지 설정 경로는 서로 다르므로 배포 환경에 맞는 경로를 선택하십시오.

관리 콘솔은 서버 측 관리 페이지입니다. Nextcloud 관리자 계정, 문서 사용자 로그인 계정 또는 WOPI 통합 자격 증명과는 다른 계정입니다. Collabora SDK 설명서 24.04에는 콘솔 주소, Linux 구성 방법 및 Docker 이미지 변수에 대한 정보가 나와 있습니다. 배포 세부 정보는 릴리스 간에 변경될 수 있으므로 프로덕션 환경에 변경 사항을 적용하기 전에 사용 중인 버전의 설명서를 확인하십시오. Collabora Online SDK 설명서 24.04를 참조하세요 .

설치 환경에 맞는 구성 방법을 선택하십시오.

먼저 배포 방식을 파악하십시오. 서비스 coolwsd가 시스템 서비스로 직접 실행되고 호스트에 해당 coolconfig명령이 있는 경우 패키지 방식을 사용하십시오. 서비스가 컨테이너 기반으로 실행되는 경우 collabora/code해당 컨테이너의 환경을 구성하십시오. 호스트에 암호를 설정하고 이미 실행 중인 컨테이너의 암호를 변경하려고 시도하지 마십시오.

리눅스 패키지 설치 시, 암호를 대화형으로 설정하세요.

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일반적으로 ` service` 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를 사용하며, 관리 엔드포인트가 공용 인터넷에 광범위하게 노출되지 않도록 하십시오. 배포 환경에서 지원하는 경우 방화벽 또는 리버스 프록시에서 네트워크 제한을 적용하십시오.

패키지 설치의 경우, `status` 명령어를 사용하여 서비스가 정상 작동하는지 확인하십시오 sudo systemctl status coolwsd. Docker의 경우, `status` 명령어로 컨테이너 상태를 확인하고 docker compose ps, `status` 명령어로 최근 로그를 확인하십시오 docker compose logs --tail=100 collabora. 서비스가 정상 작동하는 것만으로는 비밀번호가 올바르다는 것을 보장할 수 없습니다. 최종 확인은 관리 콘솔 URL에서 로그인에 성공하는 것입니다.

흔히 잘못 알려진 사실과 그 대신 해야 할 일

"관리 콘솔에서 Nextcloud 비밀번호를 사용합니다."

기본적으로는 그렇지 않습니다. Collabora 관리 콘솔 자격 증명은 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 설명서는 버전별로 작성되었으므로 최신 버전 또는 공급업체 맞춤형 배포에 해당하는 설명서를 참조하십시오.