RSS フィードマクロ

RSS フィードマクロをページに追加すると、外部または内部の RSS フィードのコンテンツを表示できます。たとえば、ブログ投稿を表示したり、スペース内で最近更新されたページを一覧表示したりするために、フィードビルダーで内部フィードを作成し、このマクロを使用してレンダリングすることができます。

これは従来のマクロであり、多くの場合、セキュリティ上の理由で Confluence 管理者により無効化されています。

On this page:

Security considerations

RSS フィードマクロは Confluence 管理者によって無効化されている場合があります。また、Confluence 管理者は信頼できる URL の許可リストを定義できます。含まれている URL が許可リストにない場合は、Confluence ページにエラーメッセージが表示されます。

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

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

このマクロをページに追加する

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

Error rendering macro 'includeplus'

User 'anonymous' does not have permission to view the page with ID 993925286.
[外部コンテンツ] カテゴリから [RSS フィード] を選択します。
RSS フィードの URL を入力します。
[挿入] をクリックします。

その後、ページを公開するとマクロの動作を確認できます。

マクロパラメーターを変更する

Error rendering macro 'excerpt-include'

ユーザー 'null' にはこのページを表示する権限がありません。

このマクロで使用できるパラメーターの一覧は、次のとおりです。

パラメーター	既定	説明
RSS フィード URL `(url`)	なし	表示したい RSS フィードリンクの URL。
最大エントリ数 `(max`)	15	表示されるエントリ数を指定します。
項目のタイトルのみを表示 `(showTitlesOnly`)	false	新しい項目のタイトルのみ (コンテンツではない) を表示します。
RSS フィードの名前 / タイトルを表示 `(titleBar`)	true	フィードのタイトルバーを非表示にします。

Error rendering macro 'excerpt-include'

ユーザー 'null' にはこのページを表示する権限がありません。

フィードはどのように更新されますか?

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

デフォルトのキャッシュを変更したい場合、キャッシュマクロを使用して、RSS フィードマクロがフィードの更新を取得する頻度を定義します。Confluence サイトにキャッシュプラグインをインストールする必要があります。

許可されていない URL がページに含まれている場合はどうなりますか?

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

Error rendering macro 'excerpt-include'

ユーザー 'null' にはこのページを表示する権限がありません。

認証

外部フィードからの専用フィード

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

外部 HTTP フィードへのアクセス

すべてのコンテンツで HTTPS を有効化した Confluence にのみ適用されます。サイトが完全に HTTPS 化されている場合、RSS フィードマクロは内部フィードにアクセスすることはできません。RSS フィードマクロが HTTPS セットアップに影響を与えずに内部フィードにアクセスできるようにするには、ローカル専用 HTTP アクセスを有効化します。

Confluence をシャットダウンします。
Confluence HTTP アクセスを有効化するには、SSL ガイドをご確認ください。HTTP コネクターと SSL コネクターの両方を使用し、両方にコメントを付ける場合があります。つまり、HTTP と HTTPS の両方を介して Confluence にアクセスすることができます。ただし、リダイレクトポートを使用したり、すべてのトラフィックをリダイレクトするルールを web.xml で設定することはできません。
Instead of using web.xml を使用してトラフィックをリダイレクトする代わりに、ファイアウォールルールを挿入して Confluence サーバー以外からのすべての HTTP リクエストを同等の HTTPS URL へリダイレクトします。これにより、ユーザーは意図したとおりに HTTPS 経由でのみ Confluence にアクセスできるようになります。添付ファイルを有効にするため、HTTP アクセスを残している場合は (IE ダウンロードのバグを回避するため)、これらの URL も選択的に有効化する必要があります。
HTTP URL を使用するよう Confluence RSS フィードマクロフィードリンクを変更して、Confluence を再起動する