Kopano 웹 앱 파일 미리보기 및 MDM 플러그인 설정 방법

Kopano WebApp의 파일 미리보기 기능은 별도의 "FileViewer" 패키지를 설치하지 않고도 문서화된 구성에서 활성화할 수 있지만, MDM은 별도의 플러그인이므로 Z-Push에 연결하여 설치해야 합니다. 이 차이점이 중요합니다. WebApp 관리자 설명서에서는 미리보기 기능을 사용하는 방법을 설명하는 ENABLE_FILE_PREVIEWER반면, MDM 설명서에서는 전용 패키지, 구성 파일 및 종속성에 대해 설명합니다. 잘못된 "파일" 추가 기능을 설치하면 미리보기 기능이 활성화되지 않습니다.

이 가이드는 기존 Kopano 웹 애플리케이션 배포 환경의 관리자를 위한 것입니다. Kopano에서 제공하는 웹 애플리케이션 및 MDM 매뉴얼은 구형 버전이므로, 프로덕션 환경을 변경하기 전에 패키지 이름과 설정이 현재 사용 중인 웹 애플리케이션, PHP, Z-Push 및 운영 체제 버전과 정확히 일치하는지 확인하십시오. 아래 단계에서는 문서화된 경로와 이를 안전하게 확인하는 방법을 설명합니다.

파일 미리보기를 말씀하시는 건가요, 아니면 Kopano Files 플러그인을 말씀하시는 건가요?

웹 앱에서 지원되는 파일 첨부 파일을 미리 볼 필요가 있는 경우 내장 파일 미리 보기 설정을 사용하십시오. 문서에 나와 있는 관리자 옵션은 이며 ENABLE_FILE_PREVIEWER, 이 옵션은 사용자에게 미리 보기 설정을 제공할지 여부를 제어합니다. 웹 앱 설명서에는 이 기능이 패키지 관리자를 사용하여 설치하는 별도의 파일 뷰어 패키지로 설명되어 있지 않습니다.

Kopano Files는 다릅니다. WebDAV 또는 기타 구성된 백엔드와 같은 외부 스토리지 계정을 탐색하고 관리할 수 있는 파일 영역을 추가합니다. 별도의 패키지와 백엔드 구성이 필요할 수 있습니다. 첨부 파일 미리보기가 목표라면 Kopano Files가 아닌 미리보기 설정부터 시작하세요. 공유 스토리지를 웹 애플리케이션에 연결하는 것이 목표라면, 본문 끝에 링크된 별도 파일 설명서를 참조하세요.

MDM은 어떤 기능을 하며, 언제 유용하게 사용될까요?

Kopano의 모바일 기기 관리(MDM) 플러그인은 Z-Push를 통해 Kopano와 동기화되는 모바일 기기에 대한 정보와 작업을 제공합니다. 배포 환경에 따라 사용자는 기기 세부 정보를 확인하고 재동기화, 삭제, 새로 고침 또는 데이터 삭제와 같은 작업을 수행할 수 있습니다. 이 플러그인은 사용자가 웹 앱에서 이러한 기기 제어 기능을 필요로 할 때 유용하며, Z-Push를 대체하는 기능은 아니며 자체적으로 모바일 동기화를 설정하지도 않습니다.

Kopano MDM 설명서에는 Z-Push 2.0 이상 버전과 PHP SOAP 지원이 필수 요구 사항으로 명시되어 있습니다. Z-Push가 웹 애플리케이션과 다른 호스트에서 실행되는 경우, MDM 구성은 해당 Z-Push 서버를 가리켜야 합니다. 설치하기 전에 Z-Push 엔드포인트, 설치된 PHP 런타임 및 패키지가 사용 환경과 호환되는지 확인하십시오.

파일 미리보기 기능을 어떻게 활성화하나요?

config.php먼저 설치에서 사용 중인 활성 웹 애플리케이션의 위치를 찾으십시오 . 패키지 기반 배포의 경우 일반적으로 `/webapp` 경로에 있지만 /etc/kopano/webapp/, 컨테이너 및 사용자 지정 설치의 경우 구성 파일이 다른 위치에 마운트될 수 있습니다. 편집하기 전에 해당 파일을 백업하고, 설정이 이미 존재하는 경우 두 번째 정의를 생성하지 마십시오.

활성 구성에서 다음을 찾으세요 ENABLE_FILE_PREVIEWER. Kopano 웹 앱 관리자 설명서에는 true사용자가 설정에서 파일 미리보기 기능을 활성화할 수 있는 옵션과 false모든 사용자에 대해 해당 옵션을 숨기고 미리보기를 비활성화할 수 있는 옵션이 표시된다고 나와 있습니다. 예를 들면 다음과 같습니다.

define("ENABLE_FILE_PREVIEWER", true);

해당 줄이 이미 존재하는 경우, 중복해서 추가하는 대신 기존 값을 변경하십시오 define(). 주변의 PHP 구문은 그대로 유지하십시오. 해당 줄이 없는 경우, 전체 샘플 구성 파일을 실제 파일에 복사하는 대신 설치된 웹 애플리케이션 패키지에 맞는 템플릿이나 구성 지침을 사용하십시오.

저장 후 웹 애플리케이션을 실행하는 PHP 인터프리터를 사용하여 PHP 구문 오류를 확인하십시오. 예를 들어 구성 파일이 표준 패키지 경로에 있는 경우 다음과 같습니다.

php -l /etc/kopano/webapp/config.php

구문 검사는 PHP 구문 분석만 검증하며, 실행 중인 사이트에서 설정이 로드되었는지 여부는 확인하지 않습니다. 테스트 사용자로 로그인하여 웹 애플리케이션 설정을 열고 파일 미리보기 옵션이 있는지 확인하세요. 해당 옵션을 활성화하고 변경 사항을 적용한 다음, 웹 애플리케이션에서 지원하는 형식의 첨부 파일을 엽니다. 컨트롤이 없는 경우, 활성 구성을 편집했는지, 웹 애플리케이션 플러그인 및 설정이 사용 가능한지, 패키지 업그레이드 또는 컨테이너 마운트로 인해 다른 구성 파일이 제공되지 않는지 확인하세요.

MDM 플러그인은 어떻게 설치하나요?

서버와 동일한 Kopano WebApp 릴리스 및 배포판용으로 빌드된 MDM 패키지를 사용하십시오. Kopano MDM 설명서에는 Debian 계열 패키지 kopano-webapp-plugins-mdm와 RPM 기반 배포판용 RPM 패키지가 나와 있습니다. 아래에 Debian 설치 패턴이 나와 있는데, 자리 표시자를 신뢰할 수 있고 호환되는 패키지 소스에서 얻은 실제 패키지 버전으로 바꾸십시오.

sudo dpkg -i ./kopano-webapp-plugins-mdm_<version>.deb

꺾쇠괄호(|) 자리 표시자를 문자 그대로 입력하지 마십시오. 패키지 설치 시 해결되지 않은 종속성이 보고되면 배포판의 일반적인 패키지 관리 프로세스를 사용하여 신뢰할 수 있는 저장소에서 종속성을 해결한 다음, 설치된 MDM 패키지와 웹 애플리케이션 버전이 함께 작동하도록 설계된 것인지 확인하십시오. 종속성을 충족하기 위해 임의의 패키지 빌드를 다운로드하거나 여러 릴리스를 혼합하여 사용하지 마십시오.

웹 애플리케이션에서 사용하는 PHP 환경에서 PHP SOAP 확장 기능이 활성화되어 있는지 확인하십시오. 간단한 확인 방법은 다음과 같습니다.

php -m | grep -i '^soap$'

출력이 없으면 웹 애플리케이션에서 사용하는 PHP 버전 및 웹 서버 런타임에 맞는 SOAP 확장 프로그램을 설치하고 활성화하십시오. CLI PHP 검사는 PHP-FPM 또는 Apache의 PHP 모듈과 다를 수 있으므로, 명령에 SOAP가 표시되지만 MDM에서 여전히 SOAP 기능이 없다고 보고하는 경우 웹 서버 구성을 비교하십시오.

MDM 서버 연결은 어떻게 구성해야 합니까?

공개된 MDM 설명서에는 설정 파일이 있습니다 /etc/kopano/webapp/config-mdm.php. 해당 파일을 백업한 다음 설명서에 나와 있는 옵션을 확인하세요.

PLUGIN_MDM_USER_DEFAULT_ENABLE_MDM플러그인이 사용자에게 기본적으로 활성화되는지 여부를 제어합니다. 설명서에는 기본값이 로 나와 있습니다 false.
PLUGIN_MDM_SERVERZ-Push 서버를 식별합니다. 문서화된 기본값은 입니다 localhost.
PLUGIN_MDM_SERVER_SSLtrueSSL/TLS 연결을 사용하는 경우 이 값 을 로 설정해야 합니다 . 문서에 명시된 기본값은 입니다 false.

웹 애플리케이션과 Z-Push가 서로 다른 호스트에 있는 경우, 기본 서버 설정을 배포 환경에 필요한 실제 Z-Push 위치로 변경하십시오. 올바른 프로토콜과 호스트 이름을 사용하고, 해당 엔드포인트가 HTTPS를 사용하는 경우 SSL 옵션을 활성화하십시오. 플러그인이 응답하도록 하기 위해 엔드포인트를 공개적으로 노출하지 마십시오. 의도된 네트워크 경로와 유효한 인증서를 통해 접근 가능하도록 유지하십시오. 설치된 파일에서 사용된 PHP 구문을 그대로 유지하십시오.

기본 설정이 모든 조직에 적합한 것은 아닙니다. 사용자가 직접 MDM을 활성화하도록 허용하거나, 정책에 따라 기본적으로 활성화할 수 있습니다. 웹 애플리케이션 구성에서 플러그인을 전역적으로 비활성화하거나 MDM 플러그인을 차단하는 경우, 먼저 해당 설정을 해결해야 합니다. MDM 관련 기본 설정만 변경해서는 웹 애플리케이션 수준에서 명시적으로 비활성화된 플러그인을 재정의할 수 없습니다.

사용자 계정에서 MDM을 활성화하는 방법은 무엇입니까?

패키지 설치 및 구성이 완료되면 WebApp에 로그인하고 설정 > 플러그인 탭을 엽니다. MDM을 선택하고 변경 사항을 적용합니다. MDM 설명서에 따르면 장치 개요는 설정의 별도 MDM 탭에 표시되며 장치 정보, 마지막 동기화 시간 및 장치 ID가 포함됩니다. 플러그인이 목록에 표시되지 않으면 먼저 패키지 파일이 활성 WebApp 플러그인 디렉터리에 설치되었는지, 그리고 전역 플러그인 설정에서 해당 플러그인이 숨겨지거나 비활성화되어 있지 않은지 확인하십시오.

Z-Push를 통해 기기가 이미 동기화되고 있는 계정으로 테스트하십시오. 기기 목록이 비어 있는 경우 해당 계정에 Z-Push 기기가 있는지, MDM 서버 설정이 올바른 Z-Push 서비스를 가리키는지, 그리고 웹 애플리케이션 프로세스에서 PHP SOAP를 사용할 수 있는지 확인하십시오. 관련 없는 서버 설정을 변경하기 전에 테스트 요청과 관련된 웹 애플리케이션 및 Z-Push 로그를 검토하십시오.

Wipe or Remove를 사용하기 전에 알아야 할 사항은 무엇인가요?

MDM 작업은 단순한 새로 고침 버튼이 아닌 운영 제어 기능으로 간주해야 합니다. Kopano의 MDM 설명서에서는 데이터 삭제(Wipe) 기능이 기기의 모든 데이터를 삭제하므로 주의를 기울여야 한다고 경고합니다. 데이터 삭제 기능을 사용자에게 제공하기 전에 중요하지 않은 기기로 인터페이스를 테스트하고 조직의 복구 프로세스를 숙지하십시오. 데이터 삭제를 실행하기 전에 대상 기기 ID와 사용자를 반드시 확인하십시오.

제거(Remove) 또한 중요한 의미를 갖습니다. 설명서에 따르면 목록에서 기기를 제거하면 기기가 다시 표시되도록 휴대폰에서 계정을 제거한 후 다시 연결해야 합니다. 재동기화(Resync)는 추가 동기화를 요청하고, 새로 고침(Refresh)은 표시되는 기기 목록을 업데이트합니다. 단순히 동기화 속도가 느린 기기의 문제를 해결하기 위한 일반적인 방법으로 초기화(Wipe)를 사용하지 마십시오.

두 가지 기능을 어떻게 확인할 수 있습니까?

파일 미리보기의 경우, 사용자가 설정을 확인하고 활성화할 수 있는지 확인한 다음, 지원되는 첨부 파일을 먼저 다운로드하지 않고 열어보세요. MDM의 경우, 테스트 사용자가 예상되는 장치 정보를 볼 수 있는지, 그리고 마지막 동기화 세부 정보가 Z-Push를 통해 동기화되는 것으로 알려진 장치와 일치하는지 확인하세요. 새로 고침이나 재동기화와 같이 위험도가 낮은 작업부터 먼저 테스트하세요. 조직의 정책에 따라 데이터 삭제 기능을 비활성화하거나 제한적으로 유지하여 그 영향을 검증하세요.

미리보기 컨트롤이 누락된 경우 활성 웹 애플리케이션 구성 및 사용자 설정을 다시 확인하십시오. MDM이 누락되었거나 장치가 표시되지 않으면 패키지 호환성, PHP SOAP, MDM 구성 경로, Z-Push 호스트 및 전역 플러그인 제한 사항을 확인하십시오. Kopano에서 제공하는 설명서에는 설정 이름과 패키지 패턴이 설명되어 있지만 모든 최신 배포판 및 PHP 릴리스와의 호환성을 보장하지는 않습니다. 최종적인 확인은 해당 서버 빌드에 대한 패키지 설명서를 참조하십시오.