1. 第5回 JDUC勉強会
Dynamics 365 Web APIとの接し方
@sugimomoto

2. 最近あったWeb APIに関する質問
認証ってOAuthでいいの？
オンプレなんだけど？
なんかRESTとSOAPとWeb API
ってあるんだけど？
Web APIって、なんでもデータが取
得できるんだよね？

3. しかも、最近のDynamics 365 は
Web APIの変革期

4. 今日のゴール
Dynamics 365 とデータ連携したいよー
それならWeb APIあるじゃん！？
でも、Web APIの種類はどれを使えばいいの？
でも、Web APIの認証ってどうすればいいの？
でも、Web APIでどんなことができるの？

5. Q1. Web APIの種類はどれを使えばいいの？

6. Dynamics 365 Web APIの種類
REST API SOAP API Web API
Microsoft 呼称
組織データサービス
REST エンドポイント
組織サービス
SOAP エンドポイント
Web API
OData v4 REST
プロトコル OData v2 SOAP OData v4
状況
既に廃止済み
Dynamics CRM 2015まで
Ver 9.Xで廃止予定
http://bit.ly/2vR33C1
★メインストリーム
Dynamics CRM 2015から
リファレンス
https://msdn.microsoft.com
/library/gg334279(v=crm.7)
.aspx
https://msdn.microsoft.com
/ja-
jp/library/mt608074.aspx
https://msdn.microsoft.com
/ja-
jp/library/mt593051.aspx

7. Dynamics 365 Web APIの種類
REST API SOAP API Web API
Microsoft 呼称
組織データサービス
REST エンドポイント
組織サービス
SOAP エンドポイント
Web API
OData v4 REST
プロトコル OData v2 SOAP OData v4
状況
既に廃止済み
Dynamics CRM 2015まで
Ver 9.Xで廃止予定
http://bit.ly/2vR33C1
★メインストリーム
Dynamics CRM 2015から
リファレンス
https://msdn.microsoft.com
/library/gg334279(v=crm.7)
.aspx
https://msdn.microsoft.com
/ja-
jp/library/mt608074.aspx
https://msdn.microsoft.com
/ja-
jp/library/mt593051.aspx
これを使え！

8. Q2. Web APIの認証ってどうすればいいの？

9. Web APIの認証はどうなってるの？
HTTP/S
NTLM認証
認証不要
Dynamics 365
Online
Dynamics 365
On-Premiss
Dynamics 365
Internal
IFD構成
なし
IFD構成
あり
OAuth 2.0 認証
Implicit Grant
Resource Owner
Password
Credential Grant
Client
Credential
Grant
認証方式
プラット
フォーム
アプローチ
Dynamics 365 OnlineであればOAuth 2.0による認証
Implicit GrantもしくはClient Credential Grantを利用しよう！

10. Client Credential Grant
データ連携におけるバッチ処理やインターフェースプログラム等
アクセスするユーザーのコンテキストに重要性が無い場合オススメ
Client IdとClient Secretの発行およびアプリケーション登録で可能になる認証アプローチ
（別名Server to Server 認証：S2S認証）
POST https://login.microsoftonline.com/{tenantId}/oauth2/token
Media/type application/x-www-form-urlencoded
Grant_type=client_credentials&client_id={clientId}&client_secret={clientSecret}&resour
ce={https://***.crm7.dynamics.com/}
参考：【Dynamics 365】【8.2新機能】サーバ間（S2S）認証を試してみた
http://bit.ly/2wfyKDf

11. Dynamics 365 Web APIの
認証を使用するための注意点
・必ず一意のユーザーを指定
リソースに誰がアクセスしたのか？ という情報が必ず必要
（だから最近までClient Credentialが使えなかったと思われる）
・連携プログラムの管理情報に注意
Password Credentialの場合はID・PWの管理が必要（Office365のパスワード変更の影響あり）
Client Credential GrantはClient Id / Client Secretを管理（Client Secretは期限付き）
・オンプレミスの場合、認証アプローチはケースバイケース
イントラネットワークの疎通可能なところにアプリケーションがいる場合は「NTLM認証」
イントラネットワーク外の場合は、ADFS/OAuth認証もしくは、VPN等で繋いでNTLM認証か

12. Q3. Web APIでどんなことができるの？

13. Dynamics 365 Web APIでできること
・レコードの作成（Create）
・レコードの更新（Update）
・レコードの取得（Retrieve）
・レコードの削除（Delete）
・レコードの作成 or 更新（Upsert）
Basic Operation
・関数の実行（Function）
・アクションの実行（Action）
Business Logic Operation
・バッチ操作（HTTP/Multipart）
・ユーザーの偽装
・条件付き演算（Optimistic Concurrency）
Utility
・メタデータの取得
・エンティティの作成・更新・削除
・フィールドの作成・更新・削除
Metadata Operation
1 2
3 4

14. ちなみに
Dynamics 365 のWeb APIは
ポイントさえ抑えれば怖くない！

15. 参照も編集もREST Fulな形式でサポート
レコードの取得 レコードの作成 レコードの更新 削除
GET https://***/api/data/v8.2/
accounts
Authorization: Bearer *token*
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0）
POST https://***/api/data/v8.2/
Accounts
Authorization: Bearer *token*
OData-Version: 4.0
OData-MaxVersion: 4.0
Content-Type: application/json
{
name:’Create Account',
}
PUTCH https://***/api/data/v8.2/
Accounts(guid)
Authorization: Bearer *token*
Odata-Version: 4.0
Odata-MaxVersion: 4.0
Content-Type: application/json
{
name:’Update Account',
}
DELETE https://***/api/data/v8.2/
Accounts(guid)
Authorization: Bearer *token*
OData-Version: 4.0
OData-MaxVersion: 4.0
REST Fulな形式でデータの操作をサポート
わかりやすい

16. HTTP Request/Response デモ

17. まとめ
でも、Web APIの種類はどれを使えばいいの？
→最新のWeb API Odata v4を使おう！
でも、Web APIの認証ってどうすればいいの？
→OnlineでバッチとかならOAuth2.0認証を使おう！
S2S認証（Client Credential）がオススメ！
でも、Web APIでどんなことができるの？
→Odataプロトコルに則って、データのCRUD操作が簡単にできるよ！
ただし、ビジネスロジック（Action・Function）も抑えよう！