OAuth で複数ワークスペースにインストールできるようにする

[mashabow]

#46 で実装。

参考：

• Slack | Bolt for JavaScript | OAuth フローの実装
• Slack Bolt で簡単に複数ワークスペースにインストールできるアプリを開発しよう！（TypeScript, Lambda, Serverless Framework によるサンプルコード付き） - Qiita
• https://github.com/slackapi/bolt-js/blob/2f3f499f22089b73362f6073843bb9dfab393564/examples/oauth-express-receiver/app.js

org-wide app installation はまだ有効化していない。enterprise grid について自分がよくわかっていない。

[mashabow]

移行作業

Firebase Functions の config

Client ID と Client Secret を追加

$ firebase functions:config:set \
    slack.client_id="012345678.1234567..." \
    slack.client_secret="01234567890abcdef..."

適当な値の state secret を設定

$ firebase functions:config:set rota.state_secret="01234567890abcdef..."

bot token を Function の config から削除

$ firebase functions:config:unset slack.bot_token

再デプロイ

$ firebase deploy --only functions

[mashabow]

Firestore のマイグレーション

Rotation の新しいフィールド installationId に、ワークスペースの ID（例：T000000）を一律セットしたい。

今回は fireway を使ってみる（参考）。

$ yarn global add fireway

サービスアカウントとその鍵を作成して、ローカルの環境変数 GOOGLE_APPLICATION_CREDENTIALS に設定。

$ export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

マイグレーション処理を記述した migrations/v0.0.1__set-installationId.js を作成。

module.exports.migrate = async ({ firestore }) => {
  const rotationsRef = await firestore.collection("rotations").get();
  await Promise.all(
    rotationsRef.docs.map((doc) =>
      doc.ref.update({ installationId: "T000000" })
    )
  );
};

dryrun。

$ fireway migrate --dryrun
Found 1 migration files
Making firestore read-only
Executing 1 migration files
Running v0.0.1__set-installationId.js
Updating rotations/1596764607560 {"installationId":"T000000"}
Updating rotations/1597627527824 {"installationId":"T000000"}
Updating rotations/1598233875660 {"installationId":"T000000"}
（略）
Updating rotations/1632881658931 {"installationId":"T000000"}
Uploading the results for v0.0.1__set-installationId.js
Setting fireway/0-0.0.1-set-installationId {"installed_rank":0,"description":"set-installationId","version":"0.0.1","script":"v0.0.1__set-installationId.js","type":"js","checksum":"0e6ebd4d4ba744f97acae0647fc8fa0e","installed_by":"mashabow","installed_on":"2021-10-04T15:57:33.722Z","execution_time":80,"success":true}
Finished all firestore migrations
Files scanned:1 executed:1
Docs added:0 created:0 updated:28 set:0 deleted:0

よさそうだったので実際に実行。

$ fireway migrate
Found 1 migration files
Executing 1 migration files
Running v0.0.1__set-installationId.js
Updating rotations/1596764607560 {"installationId":"T000000"}
Updating rotations/1597627527824 {"installationId":"T000000"}
Updating rotations/1598233875660 {"installationId":"T000000"}
（略）
Updating rotations/1632881658931 {"installationId":"T000000"}
Uploading the results for v0.0.1__set-installationId.js
Setting fireway/0-0.0.1-set-installationId {"installed_rank":0,"description":"set-installationId","version":"0.0.1","script":"v0.0.1__set-installationId.js","type":"js","checksum":"ac7633f1604ca3fc92a2f65b7987efe9","installed_by":"mashabow","installed_on":"2021-10-04T16:02:43.287Z","execution_time":247,"success":true}
Finished all firestore migrations
Files scanned:1 executed:1
Docs added:0 created:0 updated:28 set:0 deleted:0

[mashabow]

Slack App の設定

OAuth & Permissions

Redirect URLs を追加。画像では切れているが、パスは /slack/oauth_redirect。

Manage Distribution

Share Your App with Other Workspaces > Remove Hard Coded Information にチェックを入れ、[Activate Public Distribution] をクリック

[mashabow]

ワークスペースへインストール

Untitled.mov

ちなみに、インストール直後はアプリのホーム画面が開く。

Firestore に installation が保存され、bot token が入っていることを確認 ✅

追記：bot token は暗号化して保存するようにした。#48 参照。