GitHubのリソースを利用するための認証はGitHub Appsで生成するトークンを利用した方が良いらしい

通常、GitHub Apps が OAuth apps より優先されます。 GitHub Apps では、きめ細かいアクセス許可が使われ、アプリでアクセスできるリポジトリをより細かく制御でき、有効期間の短いトークンが使われます。これらの特徴により、アプリの資格情報が漏洩した場合に発生する可能性のある損害を制限することで、アプリのセキュリティを強化できます。

https://docs.github.com/ja/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps

⇧ なるほど。

ネット上の情報を漁った感じでは、

zenn.dev

また GitHub Apps は、パーソナルアクセストークン（personal access token）と異なり、個人アカウントに紐づかないので会社組織等で使う際の管理に向いています。

GitHub Apps のトークンを使ってプライベートリポジトリにアクセスする

⇧ という感じで、個人アカウントへの依存を排除できる模様。

ちなみに、

docs.github.com

GitHub のトークンフォーマット

GitHub は、トークンの種別を示すプレフィックスで始まるトークンを発行します。

https://docs.github.com/ja/authentication/keeping-your-account-and-data-secure/about-authentication-to-github

⇧ GitHubでは「トークン」は、6つの種類が用意されているらしい。

GitHub Appsの仕組み

公式のドキュメントによると、

docs.github.com

GitHub Appsについて

GitHub Apps は、GitHub の機能を拡張するツールです。 GitHub Apps を使うと、GitHub で、issue を開く、pull request にコメントする、プロジェクトを管理する、といったことを行うことができます。また、GitHub で発生するイベントに基づいて、GitHub の外部で何かを行うこともできます。たとえば、GitHub で issue が開かれたときに、GitHub App で Slack に投稿できます。

https://docs.github.com/ja/apps/using-github-apps/about-using-github-apps

GitHub Appsを使用する

GitHub App を使うには、ユーザーまたは Organization のアカウントにアプリをインストールする必要があります。

https://docs.github.com/ja/apps/using-github-apps/about-using-github-apps

アプリをインストールするときに、リポジトリと Organization のデータの読み取りまたは変更を行うためのアクセス許可を、アプリに付与します。具体的なアクセス許可はアプリによって異なり、アプリで要求されているアクセス許可は、アプリをインストールする前に GitHub によって示されます。アプリをインストールするときに、アプリがアクセスできるリポジトリも指定します。アプリで追加の構成が必要な場合は、その構成を行うようアプリで指示されます。詳しくは、「個人向けアカウント用に GitHub Marketplace から GitHub アプリをインストールする」、「Organization の GitHub Marketplace から GitHub アプリをインストールする」、「サードパーティからの GitHub App のインストール」および「独自の GitHub App のインストール」を参照してください。

https://docs.github.com/ja/apps/using-github-apps/about-using-github-apps

⇧ とあるのだけど、上記で言っている「アプリ」が何なのかがよく分からない...

公式のドキュメントでは、見当たらないのですが、

zenn.dev

GitHub Appとは？作りながら仕組みを理解する

⇧ 上記サイト様によりますと、上図のような仕組みになる模様。

GitHub Appsによる認証方法は3つあるらしい

で、公式のドキュメントを見た感じでは、

docs.github.com

GitHub アプリでの認証について

GitHub App を使うと、アプリ自体またはアプリのインストールとしてアプリを認証するか、ユーザーの代わりにアプリを認証することができます。

https://docs.github.com/ja/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app

⇧ とあり、

アプリとして認証する
インストールとして認証する
ユーザーに代わって認証する

の3つの認証方法が用意されているらしい。

docs.github.com

⇧ 英語版のドキュメントを参考にすると、

アプリとして認証する
Authentication as a GitHub App
インストールとして認証する
Authentication as an app installation
ユーザーに代わって認証する
Authentication on behalf of a user

となりますと。

英語版のドキュメントの説明を読んだ感じでは、

Authentication as a GitHub App

To authenticate as itself, your app will use a JSON Web Token (JWT). Your app should authenticate as itself when it needs to generate an installation access token. An installation access token is required to authenticate as an app installation. Your app should also authenticate as itself when it needs to make API requests to manage resources related to the app.

https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app

⇧「installation access token（GitHub App インストールアクセストークン）」を生成するには、「1. アプリとして認証する」必要があるっぽいので、「2. インストールとして認証する」は、「1. アプリとして認証する」に依存しているってことなんかね？

説明が分かり辛いんだわ...

何となく、

zenn.dev

toripiyo.hatenablog.com

⇧「GitHub App インストールアクセストークン」を利用する感じの情報が多いので、「2. インストールして認証する」方法で実現していく感じになるんかね？

何と言うか、公式のドキュメントで、