RSS Feed Macro

페이지에 RSS 피드를 포함한다. 

Confluence가 생성한 외부 피드 또는 내부 피드의 내용을 표시할 수 있다. 

블로그 게시물을 표시하거나 공간에서 최근에 업데이트된 페이지를 나열하려면  피드 작성기를 사용하여 내부 피드를 만든다음 이 매크로를 사용하여 피드를 렌더링한다.

주의 : 알수없는 HTML을 웹 페이지에 포함시키는 것은 위험하다.

RSS 피드 내부의 HTML에는 활성 스크립팅 구성 요소가 포함될 수 있다. 즉, 악의적인 공격자가 자신의 웹 브라우저에서 내보낸 것으로 믿을 수 있는 스크립트로 사이트의 사용자를 표시할 수 있다. 

이러한 코드는 예를 들어 사용자의 인증 쿠키를 훔쳐 공격자에게 Confluence 로그인 비밀번호를 제공하는데 사용될 수 있다.

 

Confluence관리자가 RSS Feed 매크로를 비활성화할 수 있다. 또한, Confluence관리자는 신뢰할 수 있는 URL의 화이트리스트를 정의할 수 있다. 

포함된 URL이 화이트리스트에 없으면 Confluence 페이지에 오류 메시지가 나타난다.

 

RSS Feed Macro 사용

페이지에 RSS Feed Macro를 추가하려면 :

  1. Confluence 편집기에서 삽입 > 다른 매크로 선택
  2. 필요한 매크로 찾기 및 선택

자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력.

기존 매크로 편집 : 매크로 자리 표시자를 클릭하고 편집 선택. 매크로 대화 상자 창이 열리고 매크로 매개변수를 편집할 수 있다.

 

매개변수

매크로 출력의 내용이나 형식을 제어하도록 설정할 수 있는 옵션. 

Confluence 스토리지 포맷 또는 wikimarkup에서 사용되는 매개변수 이름이 매크로 브라우저에서 사용된 레이블과 다른 경우, 아래에 대괄호 ( example) 로 표시된다.

매개변수

기본값

설명

RSS피드 URL(url

없음

표시할 RSS 피드 링크의 URL

최대 항목 수(max

15

표시된 항목 수를 제한

항목 제목만 표시 
(showTitlesOnly

false

뉴스 항목의 제목만 표시하고 내용은 표시하지 않는다.

쇼 이름/RSS 피드제목 
(titleBar

true

피드 제목 표시 줄을 숨긴다.

 

피드가 최신 상태입니까? 

기본적으로 RSS 피드 매크로는 데이터를 다시 가져 오기 전에 피드 결과를 60분 동안 캐시한다.

기본 캐싱을 변경하려면 캐시 매크로를 사용하여 RSS 피드 매크로가 피드 업데이트를 가져 오는 빈도를 정의한다. 캐시 플러그인을 Confluence 사이트에 설치해야 한다.

 

허용되지 않는 URL이 포함된 페이지는 어떻게됩니까?

Confluence 관리자는 허용된 URL의 화이트리스트를 설정할 수 있다. 이 경우 RSS 피드 매크로가 포함된 페이지에 오류가 표시 될 수 있다.

사용자는 RSS 피드 매크로 또는 HTML include 매크로를 Confluence 페이지에 추가 할 수 있다. 매크로 코드에는 콘텐츠가 그려지는 URL이 포함된다. 

페이지가 표시되면, Confluence는 URL을 화이트리스트와 대조한다. URL이 허용되지 않으면 Confluence는 페이지에 오류 메시지를 표시한다.

오류 메시지는 Confluence가 "허용된 출처의 URL이 아니기 때문에 URL의 내용에 액세스 할 수 없습니다"라는 메시지를 표시하고 잘못된 URL을 표시한다. 

페이지를 보는 사람이 Confluence 관리자인 경우 관리 페이지로 연결되는 링크가 표시되어 URL 화이트리스트를 구성 할 수 있다.

 

Confluence 관리자에게만 보여지는 링크를 포함한 오류 메시지의 예:

링크가없는 오류 메시지의 예:

 

입증

외부 사이트의 비공개 피드

인증이 필요한 RSS 피드는 RSS 피드 매크로를 사용하여 액세스 할 수 없다.

내부 HTTPS 피드 액세스

이것은 모든 컨텐츠에 대해 HTTPS를 사용하는 Confluence 인스턴스에만 적용된다. 

사이트가 완전히 HTTPS인 경우 RSS 피드 매크로는 내부 피드에 액세스할 수 없다. 

RSS 피드 매크로가 HTTPS 설정에 영향을 미치지 않고 내부 피드에 액세스할 수 있게 하려면 로컬 전용 HTTP 액세스를 활성화한다.

  1. Confluence를 종료
  2. Confluence에 HTTP 액세스를 가능하게 하려면 SSL 가이드를 참조. 
    HTTP 커넥터와 SSL 커넥터가 둘 다 주석 처리되어 있는지 확인. 이는 HTTP와 HTTPS를 통해 Confluence에 액세스할 수 있음을 의미한다. 
    그러나 모든 트래픽을 리디렉션하도록 web.xml에 리디렉션 포트 또는 규칙이 없어야 한다.
  3. web.xml을 사용하여 트래픽을 리디렉션하는 대신 방화벽 규칙을 삽입하여 Confluence 서버가 아닌 모든 HTTP 요청을 동등한 HTTPS URL로 리디렉션한다.
    이렇게하면 사용자가 의도한대로 HTTPS를 통해서만 Confluence에 액세스 할 수 있다. 
    IE 다운로드 버그를 피하기 위해 첨부 파일에 대한 HTTP 액세스를 사용하도록 설정한 경우 해당 URL을 선택적으로 활성화해야한다.
  4. HTTP URL을 사용하기 위해 Confluence RSS 피드 매크로 피드 링크를 수정하고 Confluence를 다시 시작한다.

 

RSS 피드 매크로 사용

RSS 피드 매크로는 기본적으로 비활성화되어 있다.

RSS Feed 매크로를 활성화하려면 :

  1. 부가 기능으로 이동
  2. 드롭 다운에서 시스템을 선택 하고 Confluence HTML 매크로 추가 기능 검색
  3. 추가 기능을 확장하고 rss (rss-xhtml) 모듈을 사용하도록 설정

 

위키 마크 업 예제

이 예제는 편집기 외부에 매크로를 추가하려는 경우 (예 : 스페이스의 세로 막대, 머리글 또는 바닥 글에 사용자 지정 내용으로) 유용

매크로 이름 : rss

매크로 본문 : 없음

{rss:max=10|showTitlesOnly=true|url=http://myblog.com/feed|titleBar=false}