The RSS Feed macro embeds an RSS feed on a page. It can display the contents of external feeds, or of internal feeds generated by Confluence. To display blog posts or to list recently updated pages in a space, use the Feed Builder to create an internal feed, then render it using this macro.

警告: Web ページに不明な HTML を含めることは危険です。

RSS フィード内のの HTML には、アクティブなスクリプト コンポーネントが含まれる場合があります。つまり、不正な攻撃者がサイト ユーザーにスクリプトを示し、ユーザーの Web ブラウザーがそれを貴社のものと判断してしまう可能性があります。これらのコードは、ユーザーの認証 cookie を盗んだり、攻撃者にユーザーの Confluence ログイン パスワードを提供するためなどに使用されることがあります。

The RSS Feed macro will only be available if it has been enabled by your Confluence administrator. Also, your Confluence administrator can define a whitelist of trusted URLs. You will see an error message on the Confluence page, if the included URL is not in the whitelist.

Using the RSS Feed Macro

ページに RSS フィード マクロを追加するには:

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

オートコンプリートでマクロを素早く入力する方法

Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

To edit an existing macro: Click the macro placeholder and choose Edit. This will display the parameters of the macro in the Macro Browser.

パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。

パラメーター

既定

説明

RSS Feed URL

なし

表示したい RSS フィード リンクの URL。

Maximum Number of Entries

15

表示されるエントリ数を指定します。

Show Item Titles Only

false

新しい項目のタイトルのみ (コンテンツではない) を表示します。

Show Name/Title of RSS Feed

true

フィードのタイトル バーを非表示にします。

How Up to Date is the Feed?

既定では、RSS フィード マクロはデータを再度取得するまで、60 分の間フィード結果をキャッシュします。

If you wish to change the default caching, use the Cache macro to define how often the RSS Feed macro fetches the feed updates. You will need to install the Cache plugin onto your Confluence site.

What Happens to a Page Containing a Disallowed URL?

Confluence 管理者は承認済み URL のホワイトリスト を設定きます。その場合、RSS フィード マクロを含むページにエラーが表示される場合があります。

A user can add the RSS Feed macro or the HTML-include macro to a Confluence page. The macro code includes a URL from which the content is drawn. When the page is displayed, Confluence will check the URL against the whitelist. If the URL is not allowed, Confluence will display an error message on the page.

Confluence が「URL のコンテンツへアクセスできません。許可されているソースのものではありません。」というエラーメッセージとともに、攻撃側の URL が表示されます。 このページを閲覧している人物が Confluence 管理者の場合、URL ホワイトリストを設定できる管理ページへのリンクも表示されます。

Here is an example of the error message, including the link shown only to Confluence Administrators:

Here is an example of the error message, but without the link.

認証

Private Feeds from External Sites

RSS フィード マクロを使用して、認証が必要な RSS フィードにアクセスすることはできません。

Accessing Internal HTTPS Feeds

This applies only to Confluence instances which have enabled HTTPS for all content. If your site is fully HTTPS, the RSS Feed macro cannot access internal feeds. To enable the RSS Feed macro to access internal feeds without affecting your HTTPS setup, enable local-only HTTP access:

  1. Confluence をシャットダウンします。
  2. Consult the SSL guide to enable HTTP access to Confluence. You'll want to ensure that you have an HTTP connector and an SSL connector, both commented in. This means that Confluence will be accessible via both HTTP and HTTPS. However, you should not have a redirect port, nor rules in web.xml to redirect all traffic.
  3. Instead of using web.xml to redirect traffic, insert a firewall rule to redirect all HTTP requests not from the Confluence server to the equivalent HTTPS URL. This ensures that users will only be able to access Confluence via HTTPS, as intended. If you have still left HTTP access for attachments enabled (to avoid the IE download bug) you must selectively enable those URLS as well.
  4. HTTP URL を使用するよう Confluence RSS フィード マクロ フィード リンクを変更して、Confluence を再起動する

関連トピック

Subscribing to RSS Feeds within Confluence 
Watching Changes
Working with Macros
Configuring a URL Whitelist for Macros

Return to the Confluence User's Guide.