Azure Event HubsでGraph変更通知を受け取る

Azure Event HubsでGraph変更通知を受け取る
2020.10 .NETラボ

誰？
@DevTakas
Angular / Azure / .NET Core / Azure DevOps / Microsoft Graph
Microsoft MVP OfficeDevelopment

誰？
ブログやってます
http://takasdev.hatenablog.com/
「はまったりひらめいたり…とか…」

Global Microsoft 365 Developer Bootcamp 2020 TOKYO開催
2020/11/9・10 の2夜連続開催
Connpassで参加者募集中です

おしながき
1. Graph変更通知の新機能について
2. 何が嬉しいのか
3. 実装してみよう
4. まとめ

(おさらい)Microsoft Graphとは
• Microsoftが提供するサービス・データに
アクセスできるエンドポイント
• TeamsのチャットやOutlookのイベント、Excelデータ等々…
• 単一エンドポイントhttps://graph.microsoft.comからアクセス

(おさらい)Microsoft Graph 変更通知とは
• Graphデータに変更が発生した時に任意のWebAPIを実行可能
• データがWebAPIに対して送られる
• 大抵は参照先の情報(ユーザーのIDなど)
• 昔の発表資料とか見てね！
• .NETラボ2020年4月
• https://dotnetlab.connpass.com/event/172038/

-Event Hubsで変更通知を受け取れるように
• 「さまざまな方法で変更通知を受け取る」
• 上記のタイトルでプレビュー公開された
• 2020年10月現在の状態の情報です
• Azure Event Hubsを使用した変更通知が受け取れるようになった

-webhookと何が違う？
• 通知URLの検証が必要なくなった
• 検証トークンの返却機能の実装が不要
• Azure Event Hubsを使用することになる
• Azure Key Vaultも必要となる

-やりとりされるデータの形
• Graphの変更通知と同じ形式のJSONがやりとりされます
• なのでデータの形式は各リソースのドキュメントを参照に

-今までの変更通知の問題点
• よくあるユースケース
• 更新が頻繁に発生するデータの変更を追跡したい
Microsoft
Graph
サービス
変更
変更
変更
変更
変更
変更
変更
変更
変更

-今までの変更通知の問題点
• 大量の変更が発生するリソースの取り扱いはしんどい
• 大量の通信が発生する
• 大量の通信をさばける構成を作る必要がある
• 大量の通信をさばける実装が必要になる
Microsoft
Graph 共通通知先秒間超ﾄﾗﾝｻﾞｸｼｮﾝ
■必要要件
大量の通信さばけます
大量の送信さばけます
エラー時の復帰できます…etc

-どうなる
• 改めてEvent Hubsを見てみる
Azure Event Hubs は、ビッグデータのストリーミングプラットフォームとなるイベントインジェストサービスです。
1 秒間に何百万ものイベントを受信して処理することができます。
イベントハブに送信されたデータは、任意のリアルタイム分析プロバイダーやバッチ処理/ストレージアダプターを使用して、
変換および保存できます。
https://docs.microsoft.com/ja-jp/azure/event-hubs/event-hubs-about から引用

-どうなる
• 大量のトラフィックをさばけるエントリポイントに直
• 大量トラフィック専門のPaaS
• 少なくともWebAppsやFunctionsを大量通信さばけるようにする必要
はなさそう
• 多くのデータを扱うことにはなるのでEventHubsから接続するサービ
スについてはデータの取扱に留意する必要はありそうだけど

-構成図
Azure AD User変更
変更通知
コンソール
Capture
Topic
• 更新あったらいろんなサービスに反映したい！って構成
• ローカルでも変更を引っ掛ける
• GraphのSubscription先がWebAPIの場合でもよく使う構成になると思います
Subscribe

-設定周り
• 作成するリソース
• Azure Event Hubs
• Azure Key Vault
• Azure Functions
• Azure Service Bus（Topicが使いたいのでStandard）
• Azure AD Application

-設定周り(Azure Event Hubs)
• Sendのアクセスポリシーの接続文字列を使用する

-設定周り(Azure Key Vault)
• SecretにEvent Hubsの接続文字列を格納する

• アクセスポリシーでGraph変更通知から
シークレットを参照できるようにする

• Graph変更通知がない場合は自分で
0bf30f3b-4a52-48df-9a82-234910c4a086 を追加する必要がある
• Microsoft Graph の変更追跡アプリケーションがない場合はどうなりますか?
• 0bf30…はGraph変更通知のアプリケーション識別子

-設定周り(Azure AD アプリケーション)
• SubscriptionにアクセスするためのAD アプリケーションの作成
• 今回はUserの変更をトリガーにするのでUser.Read.Allスコープを設定

-通信
• POST https://graph.microsoft.com/beta/subscriptions
• Body
{
"changeType": "updated",
"notificationUrl": "EventHub:https://<KeyVault>/secrets/<Secret>?tenantId=<Domain>",
"resource": "users",
”expirationDateTime”:“<3日以内>"
}

-通信
• 通信が成功したらテストのValueがEvent Hubs登録される
{
"value": [
{
"subscriptionId": "NA",
"subscriptionExpirationDateTime": "NA",
"clientState": "NA",
"changeType": "Validation: Testing client application …",
"resource": "NA",
"resourceData": {
"@odata.type": "NA",
"@odata.id": "NA",
"id": "NA"
}
}
],
"EventProcessedUtcTime": "2020-10-10T08:49:17.8804676Z",
"PartitionId": 0,
"EventEnqueuedUtcTime": "2020-10-10T05:49:40.5400000Z"
}

-デモ

4.まとめ
• 大量のデータが発生しやすい変更通知はEventHubsに流す
• EventHub: <接続文字列>な構成なので
他のリソースにもアクセスできるようになるかも？
• ドキュメントも「さまざまな」とつくくらいだし・・・
• EventGridとかQueueStorageとかつなげたいよね・・・
• 適当なPrefix試したけどやっぱだめだった

参考ページ
• さまざまな方法で変更通知を受け取る (プレビュー)
• https://docs.microsoft.com/ja-jp/graph/change-notifications-delivery
• サブスクリプションリソースの種類
• https://docs.microsoft.com/ja-jp/graph/api/resources/subscription?view=graph-rest-beta
• Azure Event Hubs - ビッグデータのストリーミングプラットフォームとなるイベントインジェストサービス
• https://docs.microsoft.com/ja-jp/azure/event-hubs/event-hubs-about
• Azure/azure-sdk-for-net
• https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/eventhub/Azure.Messaging.EventHubs/samples
• チュートリアル: Azure Portal とトピック/サブスクリプションを使用して在庫を更新する
• https://docs.microsoft.com/ja-jp/azure/service-bus-messaging/service-bus-tutorial-topics-subscriptions-portal

Azure Event HubsでGraph変更通知を受け取る

More Related Content

What's hot (12)

Similar to Azure Event HubsでGraph変更通知を受け取る (20)

More from DevTakas (11)

Azure Event HubsでGraph変更通知を受け取る