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

GitHub App を作成する

You can create and register a GitHub App under your personal account or under any organization you have administrative access to.

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

OR, learn how to contribute.

事前設定された GitHub App を作成できる GitHub App Manifest の使い方については、「マニフェストから GitHub App を作成する」を参照してください。

ノート: A user or organization can own up to 100 GitHub Apps.

  1. 任意のページの右上で、プロフィール画像をクリックし、続いてSettings(設定)をクリックしてください。

    ユーザバーの [Settings(設定)] アイコン

  2. 左サイドバーで [Developer settings] をクリックします。

    Developer settings(開発者設定)セクション

  3. In the left sidebar, click GitHub Apps.

    GitHub Apps セクション

  4. [New GitHub App] をクリックします。

    新しい GitHub App を作成するボタン

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

    GitHub App の名前フィールド

    Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action.

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

    GitHub App の説明フィールド

  7. [Homepage URL] に、アプリケーションのウェブサイトの完全な URL を入力します。

    GitHub App のホームページ URL フィールド

  8. [User authorization callback URL] に、ユーザーがインストールを認可した後にリダイレクトされる URL を完全な形で入力します。 This URL is used if your app needs to identify and authorize user-to-server requests.

    GitHub App のユーザ認可コールバック URL フィールド

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

    GitHub App のセットアップ中に期限付きユーザトークンをオプトインするオプション

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

    インストール時にユーザの認可を要求する

  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] で、アプリケーションが [Label]、[Public]、 [Repository]、[Watch] イベントにサブスクライブするかどうかを選択します。

    GitHub App のイベントオプションにサブスクライブする

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

    GitHub App のインストールオプション

  17. [Create GitHub App] をクリックします。

    GitHub App を作成するボタン

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

OR, learn how to contribute.