RSS フィード マクロ

マクロ

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

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

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

On this page:

Security considerations

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

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

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

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

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

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. [外部コンテンツ] カテゴリから [RSS フィード] を選択します。
  3. RSS フィードの URL を入力します。
  4. [挿入] をクリックします。 

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

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

マクロ パラメーターは、マクロの動作を変えるために使用します。

マクロ パラメーターを変更するには、次の手順を実行します。

  1. エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
  2. 必要に応じてパラメーターを更新し、[挿入] を選択します。

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

パラメーター

既定

説明

RSS フィード URL
(url

なし

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

最大エントリ数
(max

15

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

項目のタイトルのみを表示
(showTitlesOnly

false

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

RSS フィードの名前 / タイトルを表示
(titleBar

true

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

Confluence の保存形式または wiki マークアップで使用されるパラメーター名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

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

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

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

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

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

ユーザーは、RSS フィード マクロまたはHTML インクルード マクロ を Confluence ページに追加できます。マクロ コードには、コンテンツの取得元となる URL が含まれます。ページが表示されると、Confluence は URL をホワイトリストと照合します。URL が許可されていない場合、Confluence によってページにエラー メッセージが表示されます。

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

Confluence 管理者にのみ表示されるリンクを含むエラーメッセージの例:

エラーメッセージの例 (リンクなし)。

認証

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

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

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

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

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

RSS フィード マクロを有効または無効にする

RSS フィード マクロを有効または無効にするには、次の手順を実行します。

  1. > [アプリの管理] に移動します。
  2. ドロップダウンから [システム] を選択し、Confluence HTML Macros システム アプリを検索します。
  3. 一覧を展開し、rss (rss-xhtml) モジュールを有効または無効にします。

このマクロを追加するその他の方法

手入力でこのマクロを追加する

{」と入力してからマクロ名の入力を開始すると、マクロの一覧が表示されます。

Wiki マークアップを使用してこのマクロを追加する

これは、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。

マクロ名: rss

マクロ本体: なし。

{rss:max=10|showTitlesOnly=true|url=http://myblog.com/feed|titleBar=false}
最終更新日 2020 年 8 月 12 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.