make 基本操作編 機能紹介:Connections

ばるす

ばるす

この記事は「make Advent Calendar 2024」5日目の記事です。

このアドベントカレンダーについて

このアドベントカレンダーは25日間でIPaaS製品の「make」について使い方や、実践を学べる連続ブログ企画です。

おかしん」「ばるす」「たにあん」の3名がリレー形式でお届けします。

25日間のスケジュールは以下の通りです。

日付内容担当
12/1話題のIPaaS製品「make」とはおかしん
12/2makeで作ってみたScenario紹介ばるす
12/3make 基本操作編 機能紹介:Organizationたにあん
12/4make 基本操作編 機能紹介:Scenario、Templateおかしん
12/5make 基本操作編 機能紹介:Connectionsばるす
12/6make 基本操作編 機能紹介:Webhooksたにあん
12/7make 基本操作編 機能紹介:DataStores、DataStructuresおかしん
12/8make 基本操作編 機能紹介:Devicesばるす
12/9make 基本操作編 機能紹介:Functionsたにあん
12/10make 基本操作編 機能紹介:CustomAppsおかしん
12/11make 基本操作編 機能紹介:Flow Control,Tools,Text parserばるす
12/12make ドキュメント動線の話:ResourceHubたにあん
12/13make 検証:Make Bridgeおかしん
12/14make 検証:Make REST APIばるす
12/15make 検証:AI Searchたにあん
12/16make Community Hub:Overviewおかしん
12/17make Community Hub:Academy Courses,Blog Articlesばるす
12/18make Community Hub:Showcase,CustomAppsたにあん
12/19makeの管理運用の話:Github連携おかしん
12/20makeの管理運用の話:実行ログと再実行と停止中リクエスト滞留ばるす
12/21makeの管理運用の話:Connection権限管理たにあん
12/22makeで作ってみた事例:(未定)おかしん
12/23makeで作ってみた事例:(未定)ばるす
12/24makeで作ってみた事例:(未定)たにあん
12/25makeの総論を語るばるす

どうもbarusuです。

今日はmakeでScenarioを作る時に必須な、各モジュールに設定するConnectionについて説明していきます。

1. Connectionsとは何か

Makeでの自動化に必要な「Connection」の役割

Connectionとは、Makeと外部サービス(GoogleやSlackなど)を安全に接続するための設定です。

例えば、「Slackでメッセージを受け取って、Gmailでメールを送信する」という自動化を作る場合、SlackとGmailそれぞれのConnectionが必要になります。

どんなときにConnectionが必要になるか

だいたいほとんどのケースで必要です。

  • 他のサービスのデータを取得するとき
  • 他のサービスにデータを送信するとき
  • 定期的に他のサービスの情報を確認するとき
  • 複数のサービス間でデータをやり取りするとき

Connectionの2つの主要なタイプ

Makeでは、主に以下の2種類の方法でサービスと接続します。

  1. ログインして接続(OAuth認証)Google、Slack、Notionなどの一般的なサービス
  2. 「〇〇でログイン」のような画面が表示される
  3. サービスのログイン画面で認証する
  4. 必要な権限を確認して「許可」をクリック
  5. 例: Googleサービス(Gmail、Drive、カレンダーなど)
  6. Slack
  7. Microsoft 365
  8. Dropbox
  9. APIキーで接続サービス側で発行した「APIキー」を入力する
  10. 開発者向けの設定画面でキーを取得する必要がある
  11. キーをコピーしてMakeに貼り付ける
  12. 例: ChatGPT
  13. AWS
  14. カスタムAPIとの連携

どちらの方法で接続するかは、選択したサービスによって自動的に決まります。

まあ基本的にMakeの画面の指示に従えば適切な方法で設定できますよ。

2. Connection設定の基本的な流れ

シナリオでのConnection設定

通常、Connectionの設定は以下の流れで行います。

  1. シナリオでModuleを追加する
  2. サービス(Google、Slackなど)を選択する
  3. 「Create a connection」という画面が表示される
  4. 接続方式に応じた設定画面に進む

接続方式別の設定手順

  1. ログイン方式の場合Connection名を入力
  2. 「Continue with [サービス名]」をクリック
  3. サービスのログイン画面で認証
  4. 権限の確認と許可
  5. APIキー方式の場合Connection名を入力
  6. サービス側で必要なAPIキーを取得
  7. APIキーをMakeの設定画面に入力
  8. 必要に応じて追加設定を行う

3. Connection設定手順例

ログイン方式のサービス例

Google系サービス

1.「Google」を検索して適当にアクションを選択

「Add」をクリック後、適当にConnection nameを入力して「Sign in with Google」をクリック

Googleアカウントにログイン

「次へ」をクリック

必要な権限を確認して「許可」をクリック

認証に問題がなければ完了

APIキー方式のサービス例

ChatGPT

「OpenAI」を検索して適当にアクションを選択

「Create connection」をクリック

Connection名を適当に入力後、APIKeyを入力し「Save」をクリック

接続テストが自動で実行され、問題なければ完了

4. Connection設定でよくあるトラブル

接続タイプ別のよくあるエラー

  1. ログイン方式の場合権限の許可が不十分
  2. ログイン情報の期限切れ
  3. 組織のセキュリティ設定による制限
  4. APIキー方式の場合キーのコピー&ペースト時の余分な空白
  5. キーの期限切れ
  6. 使用制限(利用回数など)の超過
  7. キーの権限設定が不十分

5. Connectionsの管理画面について

Connectionsメニューでできること

Makeの基本画面左側にある「Connections」メニューでは、作成済みのすべてのConnectionを管理できます。

主な機能:

  • 作成済みのConnectionを一覧表示
  • 既存のConnectionの設定確認と編集
  • Connectionの接続状態確認とテスト実行
  • 不要なConnectionの削除
  • 新しいConnectionの作成(主にトラブルシューティング時に使用)

画面の見方

①:検索欄 ②:名称を変更できます ③:使う認証やAPIKeyを変更できます ④:このConnectionの認証が正常に通るか否かを確認できます ⑤:削除します

💡 この管理画面で、ConnectionをどこのScenarioで使っているかが確認できないのはだいぶイケてないので改善要望挙げてます。

Connectionsメニューの使い分け

Connectionsの画面は、主に管理用として使うのが良いですね。

  • 日常的な利用:シナリオ作成時に自動的に設定
  • 管理・メンテナンス:Connectionsメニューを使用
  • トラブルシューティング:Connectionsメニューで状態確認

Tips:管理画面の活用方法

  1. 定期的なメンテナンス使用していないConnectionの整理
  2. 接続状態の確認
  3. エラーの早期発見と対応
  4. トラブルシューティングエラーが発生しているConnectionの特定
  5. 再認証が必要なConnectionの確認
  6. テスト実行による動作確認
  7. 整理と管理わかりやすい命名規則の統一
  8. 用途別のConnection整理
  9. 定期的な不要Connection削除

Tips:トラブル解決の基本手順

  1. エラーメッセージを確認する
  2. 接続方式に応じたチェックポイントを確認 ログイン方式:権限設定、ログイン状態
  3. APIキー方式:キーの有効性、入力ミス
  4. サービス側の設定を確認
  5. 必要に応じて再認証や再設定を行う

💡トラブル防止のポイント

  1. Connection名は用途がわかるように具体的につける
  2. 同じサービスでも用途が異なる場合は別のConnectionを作成
  3. エラーメッセージはスクリーンショットを残しておく
  4. APIキーは安全な場所にバックアップを保存

まとめ

  • Connectionは「ログイン方式」と「APIキー方式」の2種類
  • 通常はシナリオ作成時に自然な流れでConnection設定を行う
  • Connectionsメニューで一元管理が可能だけど、関連Scenarioは確認できない

以上です。本日はConnectionの管理方法などについて解説しました。

Connectionの権限管理や、応用的な使い方はまた後日別の記事にてご紹介予定です!

さて明日はたにあん氏の「make 基本操作編 機能紹介:Webhooks」です! 書くこと多過ぎだろ…って頭抱えてましたが、まあ彼なら良い感じにまとめてくれると思います!

ほなまた3日後の記事にて!

この記事をシェア