Skip to main content

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2023-01-18. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの向上、新機能の向上を図るために、最新バージョンの GitHub Enterprise にアップグレードします。 アップグレードに関するヘルプについては、GitHub Enterprise サポートにお問い合わせく� さい

GitHub App を作成する

個人アカウントの下で、あるいは管理アクセス権を持っているOrganizationの下で、GitHub Appを作成し、登録できます。

  1. アカウント設定にアクセスしてく� さい。

    • 個人アカウントが所有する GitHub App の� �合、任意のページの右上でプロファイル写真をクリックしてから、 [設定] をクリックします。 ユーザバーの [Settings(設定)] アイコン
    • 組織が所有する GitHub App の� �合、任意のページの右上でプロファイル写真をクリックしてから、 [Your organizations](自分の組織) をクリックします。 次に、組織の右側にある [設定] をクリックします。 プロファイル メニューの [Your organizations](自分の組織) [設定] ボタン
  2. 左側のサイドバーで、 [開発者向け設定] をクリックします。 [開発者向け設定] 1. 左側のサイドバーで、 [GitHub アプリ] をクリックします。 [GitHub アプリ] セクション

  3. [新しい GitHub アプリ] をクリックします。 新しい GitHub アプリを作成するためのボタン

  4. [GitHub App name] に、アプリケーションの名前を入力します。 GitHub アプリの名前を入力するフィールド

    アプリケーションには簡潔で明快な名前を付けましょう。 アプリケーションの名前は、既存の GitHub アカウントと同じ名前にできません。た� し、その名前があなた自身のユーザ名や Organization 名である� �合は例外です。 インテグレーションが動作すると、ユーザインターフェース上にアプリケーション名のスラッグが表示されます。

  5. 必要に応じて、ユーザーに表示されるアプリケーションの説明を [Description] に入力します。 GitHub アプリの説明を入力するフィールド

  6. [Homepage URL] に、アプリケーションのウェブサイトの完全な URL を入力します。 GitHub アプリのホー� ページの URL を入力するフィールド

  7. [Callback URL] に、ユーザがインストールを認可した後にリダイレクトされる URL を完全な形で入力します。 この URL は、アプリケーションがユーザからサーバへのリクエストを識別して承認する必要がある� �合に使用されます。

    [コールバック URL の追� ] を使用して、最大 10 個のコールバック URL を追� できます。

    コールバック URL を追� するためのボタンとコールバック URL を入力するフィールド

  8. デフォルトでは、アプリケーションのセキュリティを高めるため、アプリケーションは期限付きのユーザ認可トークンを使用します。 期限付きのユーザトークンの使用をオプトアウトするには、[Expire user authorization tokens] の選択を解除する必要があります。 更新トークン フローの設定とユーザー トークンの期限設定の利点の詳細については、「ユーザーからサーバーへのアクセス トークンの更新」を参照してく� さい。 GitHub アプリのセットアップ時にユーザー トークンの期限設定をオプトインするためのオプション

  9. アプリが OAuth フローを使用してユーザーを認可する� �合は、 [インストール時にユーザーの認可 (OAuth) を要求する] を選択して、ユーザーがアプリをインストール時に認可するように設定できます。 このオプションを選択した� �合、[Setup URL] が利用できなくなり、アプリケーションのインストール後にユーザはあなたが設定した [User authorization callback URL] にリダイレクトされます。 詳細については、「インストール中のユーザーの認可」を参照してく� さい。 インストール時のユーザーの認可の要求

  10. インストール後に追� の設定が必要な� �合、[Setup URL] を追� して、アプリケーションをインストールした後にユーザをリダイレクトします。 GitHub アプリのセットアップ URL を入力するフィールド

    注: 前の手� �で [インストール時にユーザーの認可 (OAuth) を要求する] を選択した� �合は、このフィールドを使用できません。ユーザーはアプリのインストール後に [ユーザー認可のコールバック URL] にリダイレクトされます。

  11. [Webhook URL] に、イベントが POST する URL を入力します。 各アプリケーションは、アプリケーションがインストールまたは変更されたり、アプリケーションがサブスクライブしているその他のイベントが発生したりするたびに、アプリケーションで設定した webhook を受信します。 GitHub アプリの Webhook URL を入力するフィールド

  12. 必要に応じて、webhook を保護するための、オプションのシークレットトークンを [Webhook Secret] に入力します。 Webhook のシークレット トークンを追� するためのフィールド

    注: シークレット トークンを設定することを強くお勧めします。 詳細については、「webhook のセキュリティ保護」をご覧く� さい。

  13. [Permissions] で、アプリケーションが要求する権限を選択します。 アクセス許可の種類ごとに、ドロップダウン メニューを使用して [読み取り専用][読み取りおよび書き込み] 、または [アクセス権なし] をクリックします。 GitHub アプリのさまざまなアクセス許可

  14. [Subscribe to events] で、アプリケーションが受け取るイベントを選択します。

  15. アプリをインストールできる� �所を選択するには、 [このアカウントのみ] または [任意のアカウント] を選択します。 インストール オプションの詳細については、「GitHub アプリをパブリックまたはプライベートにする」を参照してく� さい。 GitHub アプリのインストール オプション

  16. [GitHub アプリの作成] をクリックします。 GitHub アプリを作成するためのボタン