カスタムコネクタを使ってMicrosoft Flowで自作APIを実行しよう！

Microsoft Flowは複数のサービスを繋ぐ非常に便利なサービスです。
自作のAPIが実行できれば更に活用の幅が広がりますね。

既存のHTTPアクションでも認証無しのAPIなら叩けるのですが、
認証有りのAPIだと難しくなります。
そんな時はカスタムコネクタの出番です。

など夢が広がりますね。
というわけでカスタムコネクタの作り方を紹介します。
API開発の部分は主軸でないので、今回はMicrosoft社の既存APIを使います。
Microsoft Graphを利用できるように設定していきましょう。

1．Azure ADへのアプリ登録

Azure管理ポータルにアクセスし、Azure Active Directory > アプリの登録 > 新しいアプリケーションの登録と進みます。

名前は任意で、種類はWeb アプリ/APIです。
サインオンURLはAPIのURLで、今回の例では https://manage.office.com/.default になります。

登録が終わったらアクセス許可を与えます。

今回はMicrosoft Graphの権限を追加しました。
次にキーを作ります。

値はこの画面を抜けると2度と分からないのでメモしておいてください。

Flowの画面からカスタムコネクタを作成します。
右上歯車 > カスタムコネクタ > カスタムコネクタの作成
とやります。

スキーマ / ホスト / ベース URLはAPIに合わせて入れます。他は任意です。
Graph API呼び出しの例だとこんな設定値になります。

セキュリティタブでは、APIへの認証方法を決めます。
今回はOAuth2 ( Azure Active Directory利用 )なので以下の設定値になりました。

Client id：Azure アプリケーション登録設定画面の「アプリケーション ID」

Client secret：先ほどメモしたキー値

Tenant ID：固定値 (設定変更不可)

Resource URL：APIのURL ( 今回はhttps://graph.microsoft.com )

スコープ：アクセス許可のスコープ ( Graph APIのアクセス許可はリファレンス参照 )

リダイレクトURL：カスタムコネクタを保存すると自動で決定される (設定変更不可)

新しいアクションやトリガーを追加していきます。
呼び出すAPIによりますので公式リファレンス等参照しながら設定してください。
以下はGraph APIの一例です。

ここまで終わったら「コネクタの更新」をクリックしていったん保存します。
すると「セキュリティ」タブでリダイレクト URLが表示されるようになります。
この値をコピーしておきます。

Azureの管理ポータルに戻って、コピーしたリダイレクト URLを
応答URLの設定に反映します。

Flowに戻ってテストタブを開きます。
テストが通ったら完成です。

以上、参考になれば幸いです。