공지에 넣은 문서는 새 창에서 잘 열리는데, 게시글 안에서는 ‘docs.google.com에서 연결을 거부했습니다’만 보일 때가 있습니다. 같은 주소라도 직접 여는 것과 다른 사이트 안에 표시하는 것은 허용 조건이 다릅니다.
먼저 삽입용 주소를 사용했는지, 읽을 권한이 있는지, 어느 쪽에서 표시를 막는지를 나눠 확인하세요. 오류 문구만으로 파일이 깨졌거나 사이트 설정이 잘못됐다고 단정하면 불필요한 수정을 하게 될 수 있습니다.
1. Google 문서인지, 게시판 첨부파일인지 구분하세요
Google 문서에서 작성한 안내문을 사이트에 넣는 것과, 게시판에 올린 파일을 외부 뷰어로 보여주는 것은 서로 다른 작업입니다.
Google 문서라면 문서에서 제공하는 게시·삽입 기능을 확인합니다. 사이트 첨부파일 주소를 gview 같은 외부 뷰어에 연결했다면, 뷰어가 원본 파일을 가져올 수 있는지와 해당 방식의 지원 조건을 따로 확인해야 합니다.
Google 문서의 삽입 코드를 만드는 절차가 서버에 보관된 모든 첨부파일의 해결책은 아닙니다.
2. 공개 가능한 Google 문서는 삽입용 코드를 확인하세요
문서 편집 화면의 주소나 docs.google.com 첫 화면을 그대로 iframe에 넣었다면, 실제 문서의 삽입용 코드인지 확인하세요.
공개해도 되는 Google 문서는 파일 → 공유 → 웹에 게시 → 삽입에서 제공하는 코드를 확인할 수 있습니다. 사이트에는 관리자가 허용한 삽입 기능으로 적용합니다. 직장·학교 계정에서는 관리자가 웹 게시를 제한했을 수도 있습니다.
웹 게시는 오류를 없애기 위한 임시 설정이 아닙니다. 자료를 누가 볼 수 있게 할지 정하는 작업입니다. 고객 정보나 내부 자료가 든 문서를 미리보기 때문에 공개해서는 안 됩니다.
설정 후에는 작성자 계정에서만 확인하지 마세요. 일반 공개 문서는 로그인하지 않은 창에서, 열람 대상이 제한된 자료는 실제 대상 계정에서 확인해야 합니다.
3. 게시판 첨부파일은 원본 접근 조건을 살펴보세요
회원만 내려받을 수 있는 제안서를 외부 뷰어로 표시한다고 가정해 보겠습니다. 운영자는 로그인한 상태라 파일을 열 수 있지만, 외부 뷰어가 같은 회원 권한으로 파일을 가져올 수 있는지는 별개입니다.
개발 담당자에게 다음을 확인해 달라고 요청하세요.
- 원본 주소가 실제 파일을 반환하는지
- 로그인 화면이나 오류 페이지로 이동하는지
- 주소의 유효기간이 지났거나 외부 접근이 차단됐는지
- 파일 형식·용량이 뷰어의 지원 조건에 맞는지
로그인하지 않은 창에서 파일이 열리는지는 1차 점검에 도움이 됩니다. 다만 그 결과만으로 외부 뷰어의 접근과 표시 성공까지 보장하지는 않습니다.
회원 전용 자료라면 접근 제한을 풀기보다 권한이 유지되는 다운로드나 별도 미리보기 방식을 검토하세요.
4. 보안 설정을 바꾸기 전에 차단 위치를 확인하세요
iframe이 표시되지 않는 문제는 크게 세 곳으로 나눠 살펴볼 수 있습니다.
| 확인 위치 | 점검할 내용 |
|---|---|
| 게시판·에디터 | 저장 과정에서 iframe 코드나 주소가 제거됐는지 |
| 우리 사이트 | 외부 프레임을 불러오는 정책에서 차단했는지 |
| 표시할 문서 | 다른 사이트 안에 삽입되는 것을 제한했는지 |
우리 사이트에 X-Frame-Options: SAMEORIGIN을 추가한다고 Google의 삽입 제한이 풀리지는 않습니다. 이 설정은 우리 페이지가 다른 화면 안에 들어갈 수 있는 조건을 제한합니다.
개발 담당자는 저장 후 iframe이 남아 있는지부터 확인하고, 남아 있다면 브라우저 오류 기록과 실패한 요청의 최종 주소·응답 헤더를 살펴봐야 합니다. 우리 사이트의 frame-src와 외부 문서의 frame-ancestors·X-Frame-Options는 적용 방향이 다릅니다.
iframe 필터나 보안 헤더를 통째로 없애기보다, 실제로 차단된 위치를 확인하고 필요한 범위만 검토하는 것이 좋습니다.
5. 방문자 입장에서 확인하고 마무리하세요
수정 후에는 다음 세 가지를 확인하세요.
- 의도한 방문자가 PC와 모바일에서 자료를 읽을 수 있는가?
- 제한된 자료는 권한 없는 사용자에게 계속 차단되는가?
- 미리보기가 실패할 때 원문 보기나 다운로드 경로를 이용할 수 있는가?
문제가 계속된다면 담당자에게 문제가 생긴 페이지, 자료 종류, 삽입 방식, 발생 시각, 새 창과 게시글 안에서 각각 확인한 결과를 전달하세요. 접근용 토큰이 들어 있는 주소는 공개 질문에 그대로 올리지 않아야 합니다.
‘내 화면에서 보인다’에서 끝내지 않고, 자료를 읽어야 할 사람이 실제로 읽을 수 있는지까지 확인하는 것이 마무리입니다.