次のチェックリストを使用して、Azure Active Directory (Azure AD) Graph から Microsoft Graph への移行を計画します。
手順 1: API の違いを確認する
多くの点で、Microsoft Graph は Azure AD Graph に似ています。 多くの場合、コード内のエンドポイント、バージョン、およびリソース名を更新するだけで、期待どおりに機能するはずです。
ただし、一部のリソース、プロパティ、メソッド、およびコア機能が変更されている点には違いがあります。
次の領域の違いを探します。
- 2 つのサービス間の呼び出し構文を要求します。
- ディレクトリ拡張機能、バッチ処理、差分クエリなどの機能の違い。
- エンティティ リソース名 とその型。
- 要求オブジェクトと応答オブジェクトのプロパティ。
- パラメーターと型を含むメソッド。
- アクセス許可。
手順 2: API の使用を調べる
アプリで使用されている API、必要なアクセス許可を調べ、既知の相違点の一覧と比較します。
運用環境では、アプリで必要な API が Microsoft Graph v1.0 で一般公開されていることを確認し、それらが Azure AD Graph と同じように機能するか、違いがあるかどうかを確認します。
テストでは、Graph エクスプローラー を使用して API 呼び出しを試し、新しいアプローチを開発します。 最適な結果を得るには、テスト テナント内のテスト ユーザーの資格情報を使用してサインインし、現実的な環境で API の動作を確認します。
手順 3: アプリの詳細を確認する
- アプリの登録 と同意の変更。
- トークンの取得と 認証ライブラリ。
- .NET アプリケーションの場合は、 クライアント ライブラリを使用します。
手順 4: アプリをデプロイ、テスト、拡張する
運用環境用にアプリを更新する前に、アプリを徹底的にテストし、顧客の対象ユーザーにロールアウトをステージングします。
Microsoft Graph に切り替えた後、 Microsoft Graph の主要なサービスと機能で定義されているデータセットと機能のロックを解除します。