Skip to main content
ドキュメントには� �繁に更新が� えられ、その都度公開されています。本ページの翻訳はま� 未完成な部分があることをご了承く� さい。最新の情� �については、英語のドキュメンテーションをご参照く� さい。本ページの翻訳に問題がある� �合はこちらまでご連絡く� さい。

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2022-06-03. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてく� さい。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してく� さい。

GitHub App を作成する

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

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

    • For a GitHub App owned by a personal account, in the upper-right corner of any page, click your profile photo, then click Settings. ユーザバーの [Settings(設定)] アイコン
    • Organizationが所有するGitHub Appの� �合、任意のページの右上でプロフィール写真をクリックしてから、Your organizations(自分のOrganization)をクリックしてく� さい。 そして、Organizationの右のSettings(設定)をクリックしてく� さい。 プロフィールメニューのあなたのOrganization 設定ボタン
  2. 左サイドバーで [Developer settings] をクリックします。 開発者設定

  3. 左のサイドバーでGitHub Appsをクリックしてく� さい。 GitHub Apps セクション

  4. [New GitHub App] をクリックします。 新しい GitHub App を作成するボタン

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

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

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

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

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

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

    [Add callback URL] のボタンと コールバック URL のフィールド

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

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

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

    注釈: 前のステップで [Request user authorization (OAuth) during installation] を選択した� �合、このフィールドは利用できなくなり、アプリケーションのインストール後にユーザは [User authorization callback URL] にリダイレクトされます。

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

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

    注釈: シークレットトークンは、設定することを強くお勧めします。 詳しい情� �については「webhookをセキュアにする」を参照してく� さい。

  14. [Permissions] で、アプリケーションが要求する権限を選択します。 権限の各タイプで、ドロップダウンメニューを使用して [Read-only]、[Read & write]、または[No access] をクリックします。 GitHub App のさまざまな権限

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

  16. アプリケーションをインストールする� �所を、[Only on this account]� (このアカウントのみ) と [Any account]� (すべてのアカウント) から選びます。 これらのオプションに関する詳しい情� �については、「GitHub App をパブリックまたはプライベートにする」を参照してく� さい。 GitHub App のインストールオプション

  17. [Create GitHub App] をクリックします。 GitHub App を作成するボタン