WOPI를 통한 Collabora CODE의 블록 파일 내보내기

Collabora Online CODE에서 사용자가 열려 있는 문서를 내보내지 못하도록 하려면 WOPI 호스트가 "DisableExport": true해당 문서의 CheckFileInfo응답에 특정 값을 반환하도록 설정하십시오. Collabora 통합 문서에서는 이를 내보내기 기능 비활성화라고 설명합니다. 이 값을 설정하면 '다운로드' 메뉴 옵션도 숨겨집니다. HideExportOption이 속성만으로는 인터페이스만 변경되므로 내보내기를 금지하는 것이 목표라면 적절한 제어 방법이 아닙니다. Collabora의 확장된 CheckFileInfo 응답 속성을 참조하십시오 .

메뉴 설정만 사용하지 말고 WOPI 권한을 사용하세요.

CODE는 WOPI 통합에서 편집 구성 요소입니다. 스토리지 또는 애플리케이션 서비스는 WOPI 호스트 역할을 하며 Collabora가 문서를 열 때 파일별 정보를 제공합니다. 따라서 특정 사용자가 특정 파일을 내보낼 수 있는지 여부를 결정하는 것은 호스트에서 수행하는 것이 적절합니다.

호스트 CheckFileInfo엔드포인트에서 반환되는 JSON 객체에 부울 속성을 포함시키세요.

{
  "BaseFileName": "quarterly-plan.docx",
  "Size": 24576,
  "UserCanWrite": true,
  "DisableExport": true
}

이것은 예시를 위한 일부 예시이며, CheckFileInfo 응답의 전체 내용이 아닙니다. 다른 필수 필드와 호스트에서 이미 반환하는 기존 통합 속성은 그대로 유지하십시오. 키 값은 텍스트 문자열이 아닌 JSON 부울 값이어야 합니다 "true". 애플리케이션에서 파일 및 현재 사용자에 대해 사용하는 것과 동일한 권한 부여 방식을 사용하여 설정하십시오.

예를 들어, 조직에서 직원들이 기밀 예산 통합 문서를 편집하도록 허용하면서도 Collabora의 내보내기 기능을 사용하지 못하도록 제한할 수 있습니다. WOPI 호스트가 직원을 위해 해당 통합 문서를 열면 null 값을 반환합니다 DisableExport: true. 공개 템플릿이나 일반 문서의 경우 호스트는 false자체 정책에 따라 null 값을 반환할 수 있습니다. 모든 문서에 고정된 값을 적용하는 것은 모든 사용자와 문서에 동일한 제한을 적용해야 하는 경우에만 적합합니다.

파일을 제공하는 WOPI 호스트를 업데이트하세요.

1. 통합 엔드포인트를 식별합니다. Collabora의 WOPI 파일 요청에 응답하는 호스트 경로를 찾습니다 CheckFileInfo. Nextcloud, ownCloud 또는 다른 스토리지 제품의 경우 일반적으로 응답을 생성하는 통합 또는 정책 계층을 변경해야 합니다. Collabora 컨테이너의 전역 구성을 편집하는 것은 호스트의 파일별 권한 설정을 대체할 수 없습니다.
2. 규칙을 적절한 범위에 적용하세요. 인증된 사용자, 파일 분류, 공유 권한 또는 애플리케이션의 다른 규칙에서 값을 가져오세요. 간단한 전체 사용자 정책의 경우 관련 문서마다 true를 반환하면 됩니다. 브라우저 측 메뉴 설정이나 클라이언트에서 제공하는 값에 의존하지 마세요.
3. CheckFileInfo에 부울 값을 반환합니다. 응답이 유효한 JSON 형식인지 확인하고 Collabora가 수신하는 응답에 해당 속성이 포함되어 있는지 확인합니다. 코드 수준 정책 변경은 프레임워크에 따라 WOPI 호스트 애플리케이션을 배포하거나 다시 시작해야 할 수 있습니다. 호스트가 필드를 동적으로 제공하는 경우에는 코드 자체에 구성 변경이 필요하지 않을 수 있습니다.
4. 문서를 다시 여세요. 현재 편집기 세션을 닫고 해당 계정으로 파일을 다시 여세요. CheckFileInfo는 문서 열기 과정의 일부로 참조되므로 이미 열려 있는 세션에는 권한 변경 사항이 반영되지 않을 수 있습니다.

정확한 파일, 클래스, 설정 또는 관리 인터페이스는 WOPI 호스트 및 제품 버전에 따라 다릅니다. Collabora 설명서에는 해당 필드가 정의되어 있지만, Nextcloud 또는 타사 애플리케이션에 공통적으로 적용되는 설정은 명시되어 있지 않습니다. 호스트에서 다운로드 제한을 제공하지 않는 경우, 해당 제품의 최신 관리 설명서를 확인하거나 지원되는 WOPI 응답 경로에 정책을 구현하십시오.

HideExportOption은 언제 설정해야 할까요?

내보내기 금지를 강제하지 않고 다운로드 컨트롤을 숨기려면 이 값 HideExportOption을 설정하세요 . 실제 제한을 적용하려면 를 사용하는 것이 좋습니다 . Collabora 통합 가이드에 따르면 이 경우 메뉴 숨김 동작도 포함됩니다. 두 필드를 모두 true로 반환하면 통합에서 의도를 명확히 할 수 있지만, 문서화된 동작을 위해서는 필요하지 않습니다.trueDisableExport: true

extra_export_formats이 내용을 Collabora의 현재 구성 템플릿 에 있는 항목과 혼동하지 마십시오 coolwsd.xml. Collabora의 현재 구성 템플릿에는 이러한 선택적 형식을 비활성화해도 시각적으로만 숨겨질 뿐 서버 측 내보내기가 비활성화되지 않는다고 명시되어 있습니다. 이러한 옵션은 제공되는 추가 형식을 제어하는 ​​것이지 사용자가 문서를 내보낼 수 있는 권한을 제어하는 ​​것이 아닙니다. 전역 설정을 변경하기 전에 현재 Collabora Online 구성 템플릿을 검토하십시오 .

이 제한 조치가 보호하는 것과 보호하지 못하는 것은 무엇인가?

DisableExport이 설정은 Collabora의 세션 내보내기 기능에 적용됩니다. 사용자가 브라우저에서 파일을 편집해야 하지만 편집기의 내보내기 또는 다운로드 기능을 사용하지 않아야 할 때 유용합니다. 이 설정 자체만으로는 스토리지 서비스에 있는 원본 파일에 대한 사용자 접근 권한을 제거하지 않습니다. 호스트에서 해당 사용자가 다른 곳에서 소스 파일을 다운로드할 수 있도록 허용하는 경우, Collabora 설정은 해당 경로를 차단하지 않습니다.

마찬가지로, 콘텐츠를 볼 수 있는 사용자는 수동으로 정보를 복사하거나, 스크린샷을 찍거나, 정책에서 허용하는 다른 애플리케이션 기능을 사용할 수 있습니다. 이 설정이 모든 데이터 유출을 방지하거나 콘텐츠 복사를 완전히 차단한다고 설명해서는 안 됩니다. 원본에 대한 접근을 제한하려면 WOPI 호스트 및 스토리지 애플리케이션에서도 다운로드 및 공유 규칙을 적용해야 합니다. 사용자가 콘텐츠를 전혀 볼 수 없도록 하려면 내보내기 플래그에 의존하는 대신 문서 접근 자체를 거부해야 합니다.

인터페이스 항목을 숨기는 것과 작업을 비활성화하는 것에는 차이가 있습니다. Collabora의 구성 템플릿은 선택적 내보내기 형식 설정에서 이러한 차이를 구분하는 반면, WOPI 응답 필드는 통합 수준의 제한 사항입니다. 첫 번째 작업은 메뉴를 간소화하는 데 유용하고, 두 번째 설정은 Collabora를 통한 내보내기를 차단하기 위한 것입니다. 기존 통합이 다르게 동작하는 경우, 특정 호스트 제품이 자체 "다운로드 비활성화" 확인란을 두 필드 모두에 매핑한다고 가정하기보다는 Collabora 릴리스를 확인하고 실제 CheckFileInfo 응답을 검사해야 합니다.

테스트 계정을 사용하여 제한 사항을 확인하십시오.

1. 제한 정책에 맞는 관리자 계정이 아닌 계정을 사용하여 새 세션에서 테스트 문서를 여십시오.
2. 편집기의 '다운로드' 옵션이 더 이상 표시되지 않는지 확인하십시오. 만약 여전히 표시된다면, 해당 사용자와 파일에 대해 생성된 CheckFileInfo 응답을 검사하여 해당 필드가 부울 값인지 true, 그리고 새로운 응답이 제공되고 있는지 확인하십시오.
3. Collabora의 일반 인터페이스를 통해 내보내기 기능을 테스트하십시오. 호스트의 정책이 편집기 동작에 반영되어야 합니다. 메뉴 항목이 숨겨져 있다는 이유만으로 정책이 적용되었다고 단정하지 마십시오.
4. 스토리지 애플리케이션을 별도로 확인하세요. 테스트 계획에서 허용하는 경우에만 해당 애플리케이션의 다운로드 경로를 시도해 보세요. 해당 경로에서 다운로드가 성공하면 Collabora에서 내보내기를 차단하더라도 소스 파일 액세스 정책이 여전히 허용한다는 의미입니다.
5. 내보내기 권한이 있는 사용자로 문서를 열고 호스트가 해당 경우에 대해 의도한 권한을 반환하는지 확인하십시오. 이렇게 하면 실수로 전역적으로 적용된 규칙을 찾아낼 수 있습니다.

구현 세부 정보는 Collabora의 WOPI 통합 참조 및 프로젝트 구성 템플릿을 참조하십시오 . CODE에서 지원하는 동작은 릴리스 및 호스트 통합에 따라 다를 수 있으므로 배포하는 버전에서 응답 및 결과를 검증하십시오. 특정 호스트 버전 또는 샘플 배포가 테스트되었다는 보장은 없습니다.