通知を設定する

通知配信オプション

次の場所で、お使いの GitHub Enterprise Server インスタンス のアクティビティに関する通知を受け取ることができます。

• お使いの GitHub Enterprise Server インスタンス Web インターフェイスの通知受信トレイ
• お使いの GitHub Enterprise Server インスタンスの受信トレイと同期する GitHub Mobile の通知受信トレイ
• 認証済みメール アドレスを使用するメール クライアント。お使いの GitHub Enterprise Server インスタンス および GitHub Mobile の通知受信トレイとも同期可能

GitHub及びGitHub Mobile上で通知インボックスを使うには、通知設定でWeb及びモバイル通知を有効化しなければなりません。 詳しい情報については、「通知設定を選択する」を参照してください。

通知インボックスの利点

お使いの GitHub Enterprise Server インスタンス および GitHub Mobile の通知受信トレイには、次のオプションを含む、GitHub 通知フロー用に特別に設計されたトリアージ オプションが含まれています。

• 複数の通知を一度にトリアージする。
• 完了した通知を [完了] としてマークし、インボックスから削除する。 [完了] とマークされているすべての通知を表示するには、is:done クエリを使います。
• 後で確認するために通知を保存する。 保存した通知にはインボックスでフラグが設定され、無期限に保持されます。 保存したすべての通知を表示するには、is:saved クエリを使います。
• 通知のサブスクライブを解除し、インボックスから削除する。
• 通知が通知受信トレイ内から お使いの GitHub Enterprise Server インスタンス で発生する issue、pull request、あるいは Team ディスカッション をプレビューする。
• reasons ラベルを使って、インボックスから通知を受信する最新の理由の 1 つを表示する。
• 必要に応じて、さまざまな通知に焦点を当てるカスタム フィルターを作成する。
• インボックスの通知をリポジトリまたは日付別にグループ化して、コンテキストの切り替えを減らし、概要をすばやく確認する。

さらに、GitHub Mobile を使用して、モバイル デバイスで通知を受信およびトリアージすることもできます。 詳細については、「GitHub Mobile で通知設定を管理する」または「GitHub Mobile」を参照してください。

通知にメールクライアントを使用する利点

メールクライアントを使用する利点の 1 つは、メールクライアントのストレージ容量に応じて、すべての通知を無期限に保持できることです。 受信トレイの通知は、保存済みとしてマークしていない限り、GitHub に対して 5 か月間のみ保持 されます。 保存済の通知は、無期限に保持されます。 インボックスの保持ポリシーの詳細については、「通知について」を参照してください。

メールクライアントに通知を送信すると、メールクライアントの設定に従ってインボックスをカスタマイズすることもできます。これには、カスタムラベルまたは色分けされたラベルを含めることができます。

メール通知では、受信する各種通知に柔軟に対応し、更新用にさまざまなメールアドレスを選択できます。 たとえば、リポジトリの特定の通知を検証済みの個人のメールアドレスに送信できます。 メールのカスタマイズ オプションの詳細については、「メール通知をカスタマイズする」を参照してください。

参加と Watch 対象の通知について

リポジトリの Watch 時は、そのリポジトリでのアクティビティの更新をサブスクライブしています。 同様に、特定の Team ディスカッションの Watch 時は、その Team のページですべての会話の更新をサブスクライブしていることになります。 詳細については、「Team ディスカッションについて」を参照してください。

自分が Watch しているリポジトリを表示するには、Watch ページにアクセスします。 詳しくは、「GitHub におけるアクティビティのサブスクリプションを管理する」を参照してください。

リポジトリに関する通知は、リポジトリ ページまたは Watch ページで設定できます。

カスタム通知について

リポジトリの通知はカスタマイズできます。 たとえば、リポジトリ内で複数のタイプのイベント (issue、pull request、リリース、セキュリティ アラート、またはディスカッション) の更新が発生した場合にのみ通知を受け取るか、リポジトリのすべての通知を無視するかを選択できます。 詳細については、後述の「個々のリポジトリのウォッチ設定の構成」を参照してください。

会話への参加

会話にコメントしたり、あなたのユーザー名が @mentions されたりすると、会話に 参加 することになります。 デフォルトでは、会話に参加すると、会話に自動的にサブスクライブされます。 手動で参加した会話をサブスクライブ解除するには、Issue または Pull Request で [サブスクライブ解除] をクリックするか、通知インボックスの [サブスクライブ解除] オプションを使用します。

Watch 中または参加中の会話については、メールまたは お使いの GitHub Enterprise Server インスタンス と GitHub Mobile の通知受信トレイのどちらで通知を受け取るかを選ぶことができます。 詳しくは、通知設定の選択に関するページを参照してください。

たとえば、[通知の設定] ページで次のようにします。

• メールで通知を受け取らない場合は、参加中とウォッチ中の通知で [電子メール] をオフにします。
• 会話に参加したときにメールで通知を受け取る場合は、[参加中] の [電子メール] をオンにします。

Web およびモバイルに対して Watch または参加通知を有効にしない場合、通知受信トレイは更新されません。

メール通知をカスタマイズする

メール通知を有効にした後、お使いの GitHub Enterprise Server インスタンス ではコンテンツの HTML とプレーン テキストの両方のコピーを含むマルチパートのメールとして通知が送信されます。 メール通知のコンテンツには、お使いの GitHub Enterprise Server インスタンス の元のコンテンツに示される Markdown、@mentions、絵文字、ハッシュリンクなどがすべて含まれます。 メールでテキストだけを見たいなら、プレーンテキストのコピーだけを表示するようにメールクライアントを設定できます。

参加中または Watch 中の会話の更新を送信するデフォルトのメールアドレスを選択します。 また、既定のメール アドレスの用途として、お使いの GitHub Enterprise Server インスタンス のどのアクティビティの更新を受信するかを指定できます。 たとえば、デフォルトのメールを次の場所から更新するかどうかを選択します。

• Issue やプルリクエストへのコメント。
• Pull request のレビュー。
• プルリクエストのプッシュ。
• Issue やプルリクエストのオープン、コメント、クローズなどの、自分自身の操作による更新。

リポジトリを所有する Organization に応じて、さまざまなメールアドレスに通知を送信することもできます。 Organization では、特定のドメインのメールアドレスを検証する必要がある場合があります。 詳しくは、「通知を設定する」を参照してください。

特定のリポジトリの通知をメールアドレスに送信することもできます。 詳しくは、「リポジトリへのプッシュに対するメール通知について」を参照してください。

通知メールを受信するのは、通知設定でメール通知を選択している場合のみです。

メール通知のフィルタリング

お使いの GitHub Enterprise Server インスタンス で送信される各メール通知には、ヘッダー情報が含まれています。 各メールのヘッダー情報には一貫性があるので、それを使ってメール クライアントですべての GitHub 通知あるいは特定の種類の GitHub 通知をフィルタリングしたりフォワードしたりできます。

自分に属していない通知を受け取っていると思われる場合は、その X-GitHub-Recipient ヘッダーと X-GitHub-Recipient-Address ヘッダーを調べます。 これらのヘッダは、対象の受信者を示しています。 メールの設定によっては、別のユーザ向けの通知を受け取る場合があります。

ヘッダー情報は、お使いの GitHub Enterprise Server インスタンス からのメール通知に含まれています。

Header	情報
From アドレス	このアドレスは常に、"サイトの管理者が設定した no-reply メール アドレス" になります。
To のフィールド	このフィールドはスレッドに直接接続します。 メールに返信すると、会話に新しいコメントが追加されます。
Cc アドレス	あなたが会話をサブスクライブしていれば、GitHub Enterprise Server はあなたに Cc します。 2 番目の Cc メール アドレスは、通知の理由にマッチします。 これらの通知理由に対するサフィックスはサイト管理者が設定した no-reply メール アドレスに基づくです。 通知の理由には以下のようなものがあります。 assign: あなたに Issue または Pull Request が割り当てられた。 author: あなたが Issue または Pull Request を作成した。 ci_activity: あなたがトリガーした GitHub Actions ワークフローの実行が完了した。 comment: Issue または Pull Request にあなたがコメントした。 manual: あなたが手動でサブスクライブした Issue または Pull Request が更新された。 mention: Issue または Pull Request についてあなたがメンションされた。 push: あなたがサブスクライブしている Pull Request に誰かがコミットした。 review_requested: あなた、またはあなたがメンバーになっている Team が Pull Request のレビューをリクエストされた。 security_alert: GitHub で、あなたがアラート受信者になっているリポジトリに脆弱性が検出された。 state_change: あなたがサブスクライブしている Issue または Pull Request がクローズまたはオープンされた。 subscribed: あなたが Watch しているリポジトリに更新があった。 team_mention: あなたが属している Team が、Issue または Pull Request についてメンションされた。 your_activity: あなたが Issue または Pull Request をオープン、コメントまたはクローズした。
List-Id のフィールド	このフィールドはリポジトリの名前とそのオーナーを特定します。 このアドレスの形式は常に OWNER/REPOSITORY <REPOSITORY.OWNER> となり、例としては List-Id: grain-lang/grain <grain.grain-lang.[ホスト名]> となります。
X-GitHub-Severity のフィールド	1 つ以上のリポジトリに影響する Dependabot alerts のメール通知には、X-GitHub-Severity ヘッダー フィールドが含まれます。 X-GitHub-Severity ヘッダー フィールドの値を使用して、Dependabot alerts のメール通知をフィルター処理できます。 考えられる重大度レベルは次のとおりです。 low moderate high critical 詳しくは、「Dependabot アラートについて」を参照してください。

通知設定を選択する

1. 任意のページの右上隅で をクリックします。

   

2. 左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。

   

3. 通知設定ページで、次の場合の通知の受信方法を選択します。

   • Watch しているリポジトリまたは Team ディスカッション、または参加している会話に更新がある場合。 詳細については、「参加と Watch 対象の通知について」を参照してください。
   • 新しいリポジトリにアクセスするか、新しい Team に参加した場合。 詳しくは、「自動 Watch」をご覧ください。
   • リポジトリには新しい Dependabot alerts があります。 詳細については、「Dependabot alertsの通知オプション」を参照してください。
   • あなたが所有者である組織に属するリポジトリに、新しいデプロイ キーが追加された場合。 詳細については、「組織アラートの通知オプション」を参照してください。

自動 Watch

デフォルトでは、新しいリポジトリにアクセスすると、そのリポジトリの Watch が自動的に開始されます。 新しいチームに参加するたびに、更新が自動的にサブスクライブされ、その Team が @mentioned されたときに通知を受け取ります。 自動でサブスクライブしない場合は、通知設定で自動 Watch オプションの選択を解除できます。

「リポジトリを自動的に Watch する」が無効になっている場合、自分のリポジトリを自動的に Watch することはありません。 リポジトリページに移動して、Watch オプションを選択する必要があります。

詳しくは、「通知を設定する」を参照してください。

個々のリポジトリの Watch 設定を行う

リポジトリごとに Watch するどうかを選択できます。 また、issue、pull request、リリース、セキュリティ アラート、またはディスカッション (リポジトリで有効になっている場合) など、特定のイベント タイプのみを通知するようにしたり、個々のリポジトリを完全に無視したりすることもできます。

1. お使いの GitHub Enterprise Server インスタンス で、リポジトリのメイン ページへ移動します。

2. 右上隅の [ウォッチ] ドロップダウン メニューを選んで、ウォッチ オプションをクリックします。

   通知をさらにカスタマイズする場合は、 [カスタム] をクリックし、参加と @mentions に加えて、通知を受け取る特定のイベント (issue や pull requests など) を選びます。

   たとえば、[Issue] を選ぶと、リポジトリ内のすべての issue (このオプションを選ぶ前からあった issue を含む) についての更新の通知を受け取り、それに登録されます。 このリポジトリの Pull Request で @mentioned されている場合は、その通知も受信し、Issue についての通知に加えて、その特定の Pull Request の更新をサブスクライブします。

Organization のメール通知の送信先を選択する

Organization に所属している場合、Organization のアクティビティに関する通知の送信先にするメールアカウントを指定できます。 たとえば、職場の Organization に所属している場合、通知を個人のアドレスではなく、職場のアドレスに送信する方が良いでしょう。

通知メールを受信するのは、通知設定でメール通知を選択している場合のみです。

1. 任意のページの右上隅で をクリックします。

   

2. 左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。

   

3. [既定の通知メール] で、通知の送信先にするメールアドレスを選びます。

4. [保存] をクリックします。

Organization ごとにメールの送信先を設定する

2 つ以上の Organization のメンバーになっている場合は、各 Organization で、通知が自分のアカウントのメール アドレスに送信されるよう設定できます。

1. 任意のページの右上隅で をクリックします。

   

2. 左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。

   

3. [Custom routing] で、一覧から Organization の名前を見つけます。

4. 変更したいアドレスの隣にある [編集] をクリックします。

5. 検証済みメール アドレスのうち 1 つを選択し、 [保存] をクリックします。

Dependabot alerts の通知オプション

ユーザー アカウントの通知オプションは、https://github.com/settings/notifications にあります。 各リポジトリの通知設定は、リポジトリの Watch 設定で構成できます。

リポジトリの Dependabot alerts に関する通知を受け取るには、これらのリポジトリを監視し、"すべてのアクティビティ" 通知を受け取るようにサブスクライブするか、"セキュリティ アラート" を含めるようにカスタム設定を構成する必要があります。 詳しくは、「通知を設定する」を参照してください。 通知の配信方法と、通知が送信される頻度を選択できます。 既定では、Enterprise 所有者がインスタンスにおいて通知するようにメールを構成している場合、Dependabot alertsを受け取ります。

• インボックス (Web 通知として)。 Web 通知は、Dependabot がリポジトリで有効にされていて、新しいマニフェスト ファイルがリポジトリにコミットされたときに、重要度が重大または高の新しい脆弱性が見つかった場合に送信されます ( [GitHub 上] オプション)。
• メールでは、Dependabot がリポジトリで有効にされており、新しいマニフェスト ファイルがリポジトリにコミットされたときに重要度が重大または高の新しい脆弱性が見つかった場合、メールが送信されます ([Email] オプション)。
• コマンド ライン。セキュリティで保護されていない依存関係を使用してリポジトリにプッシュすると、警告がコールバックとして表示されます ( [CLI] オプション)。
• GitHub Mobileでは、Web通知として表示されます。 詳しくは、「通知を設定する」を参照してください。

Dependabot alertsに関する通知を受け取る方法をカスタマイズできます。 たとえば、 [脆弱性の要約をメールで送る] と [週単位のセキュリティ メール ダイジェスト] オプションを使用すると、最大 10 個のリポジトリについてアラートを要約した週単位のダイジェスト メールを受け取ることができます。

利用可能な通知の配信方法の詳細、および Dependabot alertsの通知を最適化するためのアドバイスについては、「Dependabot アラートの通知を構成する」を参照してください。

Secret scanning 通知オプション

新しいシークレットが検出されると GitHub Enterprise Server によって、通知設定に従ってリポジトリのセキュリティ アラートにアクセスできるすべてのユーザーに通知されます。 これらのユーザーは次のとおりです。

• リポジトリ管理者
• セキュリティマネージャー
• 読み書きアクセス権が与えられるカスタム ロールを持つユーザー
• Organization 所有者とエンタープライズ所有者。シークレットが漏洩したリポジトリの管理者である場合

次の場合に、電子メール通知を受け取ります。

• リポジトリをウォッチしている。
• リポジトリ

シークレット スキャンニング アラート の通知を構成する方法について詳しくは、「シークレット スキャン アラートの通知を構成する」をご覧ください。

GitHub Actions の通知オプション

GitHub Actions で設定されており、確認中のリポジトリについては、ワークフロー実行更新を受信する方法を選べます。

[通知設定] ページで、[メール] または [Web] の通知を選びます。 または、失敗したワークフロー実行についての通知のみ受信する場合は、[失敗したワークフローについてのみ送信する] を選びます。

組織アラートの通知オプション

組織の所有者は、組織のメンバーが組織内のリポジトリに新しいデプロイ キーを追加すると、既定で電子メール通知を受け取ります。 これらの通知はいつでもサブスクライブ解除できます。 通知設定ページの Organization alerts で、 [メール] を選択解除します。

GitHub Mobile で通知設定を管理する

GitHub Mobile をインストールすると、自動的に Web 通知が有効になります。 アプリケーション内で、次のイベントのプッシュ通知を有効にできます。

• ダイレクトメンション
• Issue またはプルリクエストへの割り当て
• プルリクエストのレビューをリクエスト
• デプロイメントの承認をリクエスト

GitHub Mobile がモバイルデバイスにプッシュ通知を送信するタイミングをスケジュール設定することもできます。

GitHub Enterprise Serverは、ユーザの情報をサードパーティのサービスに送信することなくプッシュ通知をサポートするためにバックグラウンドフェッチを使用するので、プッシュ通知の受信に遅延が生じることがあります。

GitHub for iOS

で通知設定を管理する

1. 下部のメニューで、 [プロファイル] をタップします。
2. 設定を表示するには、 をタップします。
3. 通知設定を更新するには、 [通知] をタップしてから、トグルを使用して、好みの種類のプッシュ通知を有効または無効にします。
4. オプションで、GitHub Mobile がモバイル デバイスにプッシュ通知を送信するタイミングをスケジュールするには、 Working Hours をタップし、 Custom working hours トグルを使用して、プッシュ通知を受信するタイミングを選択します。

GitHub for Android

で通知設定を管理する

1. 下部のメニューで、 [プロファイル] をタップします。
2. 設定を表示するには、 をタップします。
3. 通知設定を更新するには、 [通知の構成] をタップしてから、トグルを使用して、好みの種類のプッシュ通知を有効または無効にします。
4. オプションで、GitHub Mobile がモバイル デバイスにプッシュ通知を送信するタイミングをスケジュールするには、 Working Hours をタップし、 Custom working hours トグルを使用して、プッシュ通知を受信するタイミングを選択します。

GitHub Mobile を使用して個々のリポジトリの Watch 設定をする

リポジトリごとに Watch するどうかを選択できます。 また、新しいリリースのみを通知したり、個々のリポジトリを完全に無視したりすることもできます。

1. GitHub Mobile で、リポジトリのメイン ページに移動します。
2. [Watch] をタップします。
3. 通知を受け取るアクティビティを選択するには、目的の Watch 設定をタップします。 たとえば、参加しているか @mentioned の場合にのみ通知を受け取ること、または [カスタム] オプションを使って通知を受け取る特定のイベントを選ぶことができます。