GitHub App を登録する際に、セットアップ URL を指定できます。 ユーザーが GitHub App をインストールすると、セットアップ URL にリダイレクトされます。 インストール後に追加のセットアップが必要な場合は、この URL を使用して、次に行う手順をユーザーに伝えることができます。
セットアップ URL を指定する場合に、 [更新時にリダイレクト] を選択して、ユーザーがインストールを更新した後でセットアップ URL にリダイレクトされるよう指定することもできます。 更新には、インストール用のリポジトリへのアクセス権の追加または削除が含まれます。
Warning
GitHub は、ユーザーをセットアップ URL にリダイレクトするとき、installation_id クエリ パラメーターを含めます。 悪意のあるアクターは、なりすましの installation_id を使用してこの URL にアクセスできます。 したがって、installation_id パラメーターの有効性に依存しないでください。 代わりに、GitHub App をインストールしたユーザーのユーザー アクセス トークンを生成し、インストールがそのユーザーに関連付けられていることをチェックする必要があります。 詳しくは、「GitHub アプリのユーザー アクセス トークンの生成」をご覧ください。
GitHub App 登録時にセットアップ URL は省略可能ですが、GitHub Marketplace でユーザーがアプリを購入できるようにしたい場合は必須です。 詳しくは、「新しい購入や無料トライアルの処理」をご覧ください。
セットアップ URL は、コールバック URL とは異なります。 ユーザーがセットアップ URL にリダイレクトされるのは、GitHub App をインストールした後です。 ユーザーがコールバック URL にリダイレクトされるのは、Web アプリケーション フローで GitHub App を承認するときです。 詳しくは、「ユーザー承認コールバック URL について」をご覧ください。
GitHub App の登録の詳細については、「GitHub App の登録」を参照してください。 GitHub App 登録の変更の詳細については、「GitHub App 登録の変更」を参照してください。