GitHub Appsを作ってみたら色々詰まって苦労した。。。

開発合宿でGitHub Appsでアプリを初めて作ってみました
自分が詰まったところを中心に情報を残します

GitHub 連携

GitHubで何かしら連携をやろうと考えた場合以下が考えられます。
上3つは今でも使ったことがあるのですが、GitHub Appsは全く使ったことがありませんでした。
なので今回は GitHub Apps にトライしてみました。

特徴としては以下

要は、OAuthなど今まで個人に紐づいていたものが組織に紐づいて、且つ WebhookとAPIコールもくっついてくるすっごい便利なものだよと

とりあえず最初にAppsの登録をします。
ここで Webhookや権限などを設定しておきます。

APIをコールする為には、JWT認証を行いトークンを取得する必要があります。
ここでがっつり詰まってしまいました。

このURLに対して証明書と一緒にPOSTを送信するだけ！
すっごい簡単！
※ :installation_id は自身のものに修正する
https://api.github.com/installations/:installation_id/access_tokens

そもそも installation_id って何！

WebHookリクエストの一部としてくっついてきます。

  # 上省略
  "installation": {
    "id": XXXXXX
  }

これでPOSTが送信できる！

何をPOSTすればいいのか分からない！
以下をPOSTします。

- "iat": 現在日時タイムスタンプ,
- "exp": 発行するJWTの失効日時タイムスタンプ(最大10分), 
- "iss": GitHub App's identifier

GitHub App's identifier 何これ！
こいつが何かわかりませんでした。。。

作成したGitHub AppsのGeneralページにある AboutのID が GitHub App's identifier になります。
Private key も同じ場所にあります。

ヘッダーは以下を指定する

"Authorization": "Bearer 作成したJWT",
"Accept": "application/vnd.github.machine-man-preview+json"

GitHub + Amazon API Gateway + AWS Lambda *+ Python で GitHubラベル管理アプリを作りました。
ソースコードを整理できたら公開するかも。。。