Seafile과 Collabora를 올바른 WOPI URL로 연결하세요
Seafile에서 안전한 문서 편집을 활성화하려면 Collabora의 검색 URL, HTTPS 및 WOPI 액세스를 배포 환경에 맞게 구성하십시오.
먼저 일반 텍스트와 키보드를 사용하여 테스트해 보세요. 로컬 앱에서 텍스트를 복사한 다음 Collabora 문서 내부를 클릭하고 Ctrl+V(macOS에서는 또는 Command+V)를 누릅니다. 복사하려면 Collabora에서 텍스트를 선택하고 Ctrl+C또는 를 누른 Command+C후 로컬 앱에 붙여넣습니다. 단축키는 작동하지만 도구 모음이나 마우스 오른쪽 버튼을 클릭하여 붙여넣기가 되지 않으면 브라우저의 클립보드 권한 경로에 문제가 있을 가능성이 높습니다. 단축키도 작동하지 않으면 양방향으로 테스트하고 Collabora가 다른 사이트에 포함되어 있는지 확인하세요.
시스템 클립보드는 애플리케이션 간에 데이터를 전송하는 데 사용되는 공유 버퍼입니다. Collabora Online은 브라우저 내에서 실행되므로, 브라우저 경계를 넘어 복사할 때에도 브라우저 보안 규칙이 적용됩니다.
첫 번째 테스트에는 일반 텍스트를 사용하세요. 이미지, 표, 스프레드시트 범위 및 서식이 지정된 텍스트는 서로 다른 클립보드 형식을 사용할 수 있으므로 일반 텍스트 테스트를 통해 기본 액세스 문제와 형식 변환 문제를 구분할 수 있습니다.

문서 편집 영역을 클릭하여 포커스를 맞추세요. 편집기 도구 모음이나 브라우저 컨텍스트 메뉴 대신 시스템 바로 가기 키를 사용하세요. Windows 및 Linux에서는 Ctrl+C및 키를 Ctrl+V, macOS에서는 Command+C및 키를 사용하세요 Command+V. Collabora 메시지에 브라우저의 클립보드 접근이 제한되어 바로 가기 키를 사용하라는 메시지가 표시되면 해당 지침을 따르세요. 키보드 동작은 사용자 제스처에 직접 연결되어 있으므로 비동기 클립보드 API를 호출하는 메뉴 동작이 차단된 경우에도 작동할 수 있습니다.
문제가 해결되지 않으면 문서가 편집 가능한 상태인지, 커서가 검색 상자나 도구 모음 필드가 아닌 문서 내부에 있는지, 그리고 원본 텍스트가 실제로 선택되었는지 확인하십시오. 권한을 변경한 후에는 문서를 닫았다가 다시 여십시오. 오래된 편집기 프레임에는 이전 정책이 남아 있을 수 있습니다.
먼저 일반 텍스트가 제대로 전송되는지 확인하세요. 그런 다음 필요한 서식 있는 콘텐츠를 테스트합니다. 글꼴, 수식, 이미지 및 셀 서식이 동일하게 전송되지 않을 수 있습니다. 대상 위치에서 붙여넣기 옵션(붙여넣기 선택)을 사용할 수 있는 경우 해당 옵션을 사용하세요.
최신 클립보드 API는 일반적으로 HTTPS와 같은 보안 컨텍스트로 제한되며, 브라우저에 따라 사용자 동작이나 권한이 필요할 수 있습니다. Chrome 또는 Edge에서 주소 표시줄 옆의 사이트 정보 컨트롤을 열고 사이트 설정을 열어 신뢰할 수 있는 사이트에 대해 클립보드 허용 권한이 있는 경우 이를 설정 하세요 . 붙여넣기를 선택할 때 브라우저에서 메시지가 표시되면 신뢰하는 오피스 서비스에 대해서만 허용하세요. 문서를 새로고침하고 양방향 텍스트 테스트를 다시 수행하세요.

클립보드 권한 레이블과 동작 방식은 브라우저마다 다릅니다. 일부 브라우저는 영구적인 권한 설정 대신 사용자 제스처나 짧은 시간 동안 표시되는 붙여넣기 프롬프트를 사용합니다. 관리되는 브라우저는 사용자의 설정을 무시하는 정책을 적용할 수도 있습니다. 제어가 잠겨 있거나 정책에 의해 권한이 거부된 경우, 브라우저 관리자에게 문의하여 회사 사이트에 대한 규칙을 확인해 보세요. 사이트는 항상 HTTPS를 사용하도록 유지하세요. 권한을 부여한다고 해서 안전하지 않은 출처가 안전한 컨텍스트로 바뀌는 것은 아닙니다.
iframe은 다른 페이지 안에 삽입된 웹 페이지입니다. 많은 Collabora 배포 환경에서 호스트 플랫폼이 편집기를 표시할 수 있도록 iframe을 사용합니다. Chromium 기반 브라우저에서 교차 출처 프레임을 사용할 경우, 삽입된 페이지에서 클립보드 접근 권한을 위임해야 할 수 있습니다. Collabora SDK 설명서에는 클립보드 권한 쿼리를 위한 iframe 속성에 대한 내용이 나와 있습니다.
<iframe allow="clipboard-read *; clipboard-write *">
이 설정은 프레임을 생성하는 통합 기능에 대한 설정이며, Collabora 서버의 Docker 설정이 아닙니다. 호스트 애플리케이션을 관리하는 경우 브라우저 개발자 도구에서 실제 에디터 iframe을 확인하고 상위 페이지의 응답 헤더에 차단 또는 Permissions-Policy예외가 없는지 확인하십시오 . 상위 페이지의 정책이 엄격하면 iframe에 예외 속성이 있더라도 액세스가 거부될 수 있습니다. 사용자가 필요로 하는 Collabora 프레임에만 권한을 위임하고, 관련 없는 임베디드 콘텐츠에 광범위한 클립보드 액세스 권한을 부여하지 마십시오.clipboard-readclipboard-writeallow
호스팅된 Nextcloud, 학습 플랫폼 또는 문서 포털을 사용 중이고 프레임 마크업이나 응답 헤더를 편집할 수 없는 경우, 해당 관리자에게 브라우저 및 버전, 오류 발생 위치, 키보드 단축키 작동 여부, 클립보드 관련 콘솔 오류 등을 알려주세요. 통합 업데이트가 필요할 수 있습니다. CODE의 네트워크 포트를 변경하거나 컨테이너를 재시작해도 iframe 브라우저에 대한 권한이 부여되지는 않습니다.
| 당신이 관찰하는 것 | 다음으로 확인해야 할 사항 |
|---|---|
툴바 붙여넣기가 실패하지만, Ctrl+V작동은 합니다. | 바로 가기를 사용하거나 신뢰할 수 있는 사이트에 대해 요청된 브라우저 클립보드 권한을 부여하세요. |
| Collabora에서 데스크톱으로 복사하는 과정에서만 오류가 발생합니다. | 복사 제한 또는 브라우저 쓰기 권한을 확인하고, 선택한 텍스트만 복사되는지 확인하십시오. |
| 데스크톱에서 Collabora로 붙여넣기하는 경우에만 오류가 발생합니다. | 브라우저의 붙여넣기 권한, 문서 내 포커스 상태, 그리고 호스트 프레임이 읽기 권한을 위임했는지 여부를 확인하십시오. |
| 콘솔에 "클립보드 API가 권한 정책에 의해 차단되었습니다."라는 메시지가 표시됩니다. | 임베딩 페이지 또는 해당 응답 헤더가 액세스를 차단하고 있습니다. 통합 담당자가 이를 수정해야 합니다. |
| 일반 텍스트는 작동하지만 서식 있는 콘텐츠는 작동하지 않습니다. | 지원되는 클립보드 형식과 대상 앱의 붙여넣기 옵션을 비교해 보세요. 이는 클립보드 기능 자체의 오류가 아니라 형식 호환성 문제일 수 있습니다. |

권한 또는 통합 변경 후 문서를 다시 열고 일반 텍스트 테스트를 두 번 반복하세요. 첫 번째는 로컬 앱에서 Collabora로, 두 번째는 Collabora에서 로컬 앱으로 텍스트를 전송하는 것입니다. 텍스트가 의도한 위치에 나타나는지 확인한 다음, 사용하는 특정 서식 있는 콘텐츠를 테스트하세요. 변경 후 메뉴만 작동하는 경우 키보드 경로도 확인하세요. 단축키만 작동하는 경우 핵심 클립보드 경로는 사용 가능하지만 비동기 브라우저 권한 경로가 여전히 차단되었을 수 있습니다.
브라우저 클립보드 접근에 대한 보안 규칙은 MDN의 클립보드 API 참조를 확인하세요 . Chrome 사이트 권한 제어에 대해서는 Chrome 사이트 설정 도움말을 참조하세요. 통합 담당자는 Collabora의 고급 통합 문서 에서 iframe 클립보드 권한 요구 사항을 확인할 수 있습니다 .
Seafile에서 안전한 문서 편집을 활성화하려면 Collabora의 검색 URL, HTTPS 및 WOPI 액세스를 배포 환경에 맞게 구성하십시오.
시스템 클립보드를 테스트하고, 브라우저 권한을 조정하고, 내장된 Collabora 통합에 iframe 정책 변경이 필요한 시점을 파악합니다.
글꼴 파일을 Docker 및 Collabora의 시스템플레이트에 마운트하여 사용자 지정 글꼴이 편집기에 표시되고 문서에서 올바르게 렌더링되도록 합니다.
coolwsd.xml 파일과 배포 소스를 백업하고 안전하게 복원한 다음, 사용자가 편집을 재개하기 전에 코드를 검증하십시오.
CODE에서 정확한 Nextcloud 또는 기타 WOPI 출처를 허용한 다음 활성 호스트 허용 목록을 확인하고 Nextcloud의 소스 IP 제한과 구분하십시오.
Collabora의 브라우저, WOPI 및 WebSocket 연결을 추적하여 문서가 열리지 않는 이유를 찾은 다음 Nextcloud 설정에 맞는 해결 방법을 적용하십시오.
Helm을 사용하여 Collabora CODE 복제본을 배포하고, WOPI 어피니티를 통해 각 문서를 하나의 Pod에 유지하며, 인그레스, 노드 배치 및 Nextcloud 편집을 검증합니다.
브라우저에서 coolwsd로의 소켓 핸드셰이크 실패를 추적한 다음, 역방향 프록시 경로를 Collabora 버전(CODE 26.04 Apache 변경 사항 포함)과 일치시키십시오.
Collabora WOPI 증명 실패 원인을 키 불일치, 오래된 검색 데이터, 시간 오차 또는 프록시 URL 변경으로 추적할 수 있으며, 이 과정에서 유효성 검사를 약화시키지 않습니다.
브라우저 확대/축소 설정을 초기화하고, 깨끗한 세션을 테스트하고, 잘못된 크기 메뉴에 Collabora 서버 업데이트가 필요한 시점을 파악합니다.