Microsoft Graph API Client and OpenAPI

Transcript

1. Microsoft Graph API Client and OpenAPI FGN ΤϯδχΞ Meetup vol.3 ODA Hirohito
2. Fukuoka.rb ຖिਫ༵೔։࠵ https://fukuokarb.connpass.com/
3. Microsoft Graph
4. Microsoft Graph https://developer.microsoft.com/en-us/graph
5. Microsoft Graph • Ϣʔβʔ৘ใΛศརʹѻ͑ΔαʔϏε • Azure AD • Office 365 αʔϏε • OneDrive • ͳͲͳͲ • G Suite ͱΑ͘ൺֱ͞ΕΔ https://docs.microsoft.com/en-us/graph/?view=graph-rest-1.0
6. ༷ʑͳϓϥοτϑΥʔϜʹରԠ https://docs.microsoft.com/en-us/graph/?view=graph-rest-1.0#supported-platforms
7. ༷ʑͳϓϥοτϑΥʔϜʹରԠ https://docs.microsoft.com/en-us/graph/?view=graph-rest-1.0#supported-platforms
8. 2018/06/04 Microsoft ͕ GitHub Λങऩ https://news.microsoft.com/ja-jp/2018/06/05/microsoft-to-acquire-github-for-7-5-billion/
9. 2018/06/04 Microsoft ͕ GitHub Λങऩ https://news.microsoft.com/ja-jp/2018/06/05/microsoft-to-acquire-github-for-7-5-billion/ •ങऩ౰࣌ʹݴΘΕ͍ͯͨ͜ͱ •GitHub ͷΦʔϓϯιʔεจԽ͕ࣦΘΕͳ͍͔ʁ •GitHub ͷاۀจԽࣗମ͕େ͖͘มΘͬͯ͠·Θͳ͍͔ʁ
10. લධ൑Λ෷১ͯ͠ SDK Λ OSS ͱͯ͠ެ։͍ͯ͠Δ https://docs.microsoft.com/en-us/graph/?view=graph-rest-1.0#supported-platforms
11. લධ൑Λ෷১ͯ͠ SDK Λ OSS ͱͯ͠ެ։͍ͯ͠Δ https://docs.microsoft.com/en-us/graph/?view=graph-rest-1.0#supported-platforms Α͏ʹݟ͑Δ
12. ݱ࣮ͱͷ௚໘
13. ༷ʑͳϓϥοτϑΥʔϜʹରԠ https://docs.microsoft.com/en-us/graph/?view=graph-rest-1.0#supported-platforms
14. platform URL commits Android https://github.com/microsoftgraph/msgraph-sdk-android 259 Angular https://github.com/microsoftgraph/msgraph-sdk-javascript 469 ASP .NET https://www.nuget.org/packages/Microsoft.Graph — iOS https://github.com/microsoftgraph/msgraph-sdk-objc 110 Java https://github.com/microsoftgraph/msgraph-sdk-java 445 JavaScript https://github.com/microsoftgraph/msgraph-sdk-javascript 469 Node.js https://github.com/microsoftgraph/msgraph-sdk-javascript 469 PHP https://github.com/microsoftgraph/msgraph-sdk-php 227 Ruby https://github.com/microsoftgraph/msgraph-sdk-ruby 34 UWP https://www.nuget.org/packages/Microsoft.Graph — Xamarin https://www.nuget.org/packages/Microsoft.Graph — SDK ͷ։ൃঢ়گ
15. platform URL commits Android https://github.com/microsoftgraph/msgraph-sdk-android 259 Angular https://github.com/microsoftgraph/msgraph-sdk-javascript 469 ASP .NET https://www.nuget.org/packages/Microsoft.Graph — iOS https://github.com/microsoftgraph/msgraph-sdk-objc 110 Java https://github.com/microsoftgraph/msgraph-sdk-java 445 JavaScript https://github.com/microsoftgraph/msgraph-sdk-javascript 469 Node.js https://github.com/microsoftgraph/msgraph-sdk-javascript 469 PHP https://github.com/microsoftgraph/msgraph-sdk-php 227 Ruby https://github.com/microsoftgraph/msgraph-sdk-ruby 34 UWP https://www.nuget.org/packages/Microsoft.Graph — Xamarin https://www.nuget.org/packages/Microsoft.Graph — MS ϓϥοτϑΥʔϜ͸ NuGet ͔Βఏڙ
16. platform URL commits Android https://github.com/microsoftgraph/msgraph-sdk-android 259 Angular https://github.com/microsoftgraph/msgraph-sdk-javascript 469 ASP .NET https://www.nuget.org/packages/Microsoft.Graph — iOS https://github.com/microsoftgraph/msgraph-sdk-objc 110 Java https://github.com/microsoftgraph/msgraph-sdk-java 445 JavaScript https://github.com/microsoftgraph/msgraph-sdk-javascript 469 Node.js https://github.com/microsoftgraph/msgraph-sdk-javascript 469 PHP https://github.com/microsoftgraph/msgraph-sdk-php 227 Ruby https://github.com/microsoftgraph/msgraph-sdk-ruby 34 UWP https://www.nuget.org/packages/Microsoft.Graph — Xamarin https://www.nuget.org/packages/Microsoft.Graph — JS ܥ͸ඃ͍ͬͯΔ
17. platform URL commits Android https://github.com/microsoftgraph/msgraph-sdk-android 259 Angular https://github.com/microsoftgraph/msgraph-sdk-javascript 469 ASP .NET https://www.nuget.org/packages/Microsoft.Graph — iOS https://github.com/microsoftgraph/msgraph-sdk-objc 110 Java https://github.com/microsoftgraph/msgraph-sdk-java 445 JavaScript https://github.com/microsoftgraph/msgraph-sdk-javascript 469 Node.js https://github.com/microsoftgraph/msgraph-sdk-javascript 469 PHP https://github.com/microsoftgraph/msgraph-sdk-php 227 Ruby https://github.com/microsoftgraph/msgraph-sdk-ruby 34 UWP https://www.nuget.org/packages/Microsoft.Graph — Xamarin https://www.nuget.org/packages/Microsoft.Graph — Ͱ΋ຊ౰ʹண໨͢΂͖͸͜͜ʂ
18. ݱ࣮ • SDK ͸༷ʑϓϥοτϑΥʔϜͰରԠ͍ͯ͠Δࣄʹͳ͍ͬͯΔ͕ɺ
 ϓϥοτϑΥʔϜ͝ͱͷରԠͷ͕ܹ͍ࠩ͠ • Microsoft ؔ࿈ϓϥοτϑΥʔϜ͸ԿͰ΋ॆ࣮͍ͯ͠Δ • Ruby ͷରԠ͸͋·Γʹ΋஗͗͢Δ
19. Ruby ͷରԠঢ়گ
20. microsoft_graph https://rubygems.org/gems/microsoft_graph
21. Microsoft Graph Client Library for Ruby https://github.com/microsoftgraph/msgraph-sdk-ruby
22. ׆ൃͱ͸ݴ͍೉͍ gem ͷެ։։࢝͸ 2016/08/01
23. ࢀߟ·Ͱʹ… google-api-client https://rubygems.org/gems/google-api-client
24. ࢀߟ·Ͱʹ… • 2010/10/14 ʹ v. 0.1.0 ެ։ • ݱࡏ v. 0.31.0 • ৽ػೳͷ௥Ճ͸ͳ͘ɺॏେͳ όάͱηΩϡϦςΟύονͷ Έ https://rubygems.org/gems/google-api-client
25. Ұํ… microsoft_graph
26. https://github.com/microsoftgraph/msgraph-sdk-ruby#usage-example require 'adal' require 'microsoft_graph' # authenticate using ADAL username = 'admin@tenant.onmicrosoft.com' password = 'xxxxxxxxxxxx' client_id = 'xxxxx-xxxx-xxx-xxxxxx-xxxxxxx' client_secret = 'xxxXXXxxXXXxxxXXXxxXXXXXXXXxxxxxx=' tenant = 'tenant.onmicrosoft.com' user_cred = ADAL::UserCredential.new(username, password) client_cred = ADAL::ClientCredential.new(client_id, client_secret) context = ADAL::AuthenticationContext.new(ADAL::Authority::WORLD_WIDE_AUTHORITY, tenant) resource = "https://graph.microsoft.com" tokens = context.acquire_token_for_user(resource, client_cred, user_cred) # add the access token to the request header callback = Proc.new { |r| r.headers["Authorization"] = "Bearer #{tokens.access_token}" } graph = MicrosoftGraph.new(base_url: "https://graph.microsoft.com/v1.0", cached_metadata_file: File.join(MicrosoftGraph::CACHED_METADATA_DIRECTORY, "metadata_v1.0.xml"), api_version: '1.6', # Optional &callback ) me = graph.me # get the current user puts "Hello, I am #{me.display_name}." me.direct_reports.each do |person| puts "How's it going, #{person.display_name}?" end
27. https://github.com/microsoftgraph/msgraph-sdk-ruby#usage-example require 'adal' require 'microsoft_graph' # authenticate using ADAL username = 'admin@tenant.onmicrosoft.com' password = 'xxxxxxxxxxxx' client_id = 'xxxxx-xxxx-xxx-xxxxxx-xxxxxxx' client_secret = 'xxxXXXxxXXXxxxXXXxxXXXXXXXXxxxxxx=' tenant = 'tenant.onmicrosoft.com' user_cred = ADAL::UserCredential.new(username, password) client_cred = ADAL::ClientCredential.new(client_id, client_secret) context = ADAL::AuthenticationContext.new(ADAL::Authority::WORLD_WIDE_AUTHORITY, tenant) resource = "https://graph.microsoft.com" tokens = context.acquire_token_for_user(resource, client_cred, user_cred) # add the access token to the request header callback = Proc.new { |r| r.headers["Authorization"] = "Bearer #{tokens.access_token}" } graph = MicrosoftGraph.new(base_url: "https://graph.microsoft.com/v1.0", cached_metadata_file: File.join(MicrosoftGraph::CACHED_METADATA_DIRECTORY, "metadata_v1.0.xml"), api_version: '1.6', # Optional &callback ) me = graph.me # get the current user puts "Hello, I am #{me.display_name}." me.direct_reports.each do |person| puts "How's it going, #{person.display_name}?" end ͜ͷαϯϓϧΛಈ͔͢ͱ…
28. https://github.com/microsoftgraph/msgraph-sdk-ruby#usage-example require 'adal' require 'microsoft_graph' # authenticate using ADAL username = 'admin@tenant.onmicrosoft.com' password = 'xxxxxxxxxxxx' client_id = 'xxxxx-xxxx-xxx-xxxxxx-xxxxxxx' client_secret = 'xxxXXXxxXXXxxxXXXxxXXXXXXXXxxxxxx=' tenant = 'tenant.onmicrosoft.com' user_cred = ADAL::UserCredential.new(username, password) client_cred = ADAL::ClientCredential.new(client_id, client_secret) context = ADAL::AuthenticationContext.new(ADAL::Authority::WORLD_WIDE_AUTHORITY, tenant) resource = "https://graph.microsoft.com" tokens = context.acquire_token_for_user(resource, client_cred, user_cred) # add the access token to the request header callback = Proc.new { |r| r.headers["Authorization"] = "Bearer #{tokens.access_token}" } graph = MicrosoftGraph.new(base_url: "https://graph.microsoft.com/v1.0", cached_metadata_file: File.join(MicrosoftGraph::CACHED_METADATA_DIRECTORY, "metadata_v1.0.xml"), api_version: '1.6', # Optional &callback ) me = graph.me # get the current user puts "Hello, I am #{me.display_name}." me.direct_reports.each do |person| puts "How's it going, #{person.display_name}?" end <= ͜͜ͰίέΔ
29. Microsoft Graph SDK for Ruby ͷ໰୊఺ • ʮRuby ରԠʯͱᨳ͍ͬͯΔ͕ SDK ͸࣮͸ preview ൛ • ϝϯςφϯε͞Ε͍ͯΔͱ͸౸ఈࢥ͑ͳ͍ • GitHub Overview ʹهࡌ͞Ε͍ͯΔαϯϓϧͰ͑͞·ͱ΋ʹಈ͔ͳ͍ • υΩϡϝϯτ͕ͳ͍ͷͰ࢖͍ํ͕શ͘෼͔Βͳ͍
30. Ruby is Dead in Microsoft Graph https://youtu.be/zb8dXWYUX10
31. Issues #42 https://github.com/microsoftgraph/msgraph-sdk-ruby/issues/42
32. Issues #42 https://github.com/microsoftgraph/msgraph-sdk-ruby/issues/42 ࠓޙ΋։ൃ͕ܧଓ͞ΕΔ͔ෆ໌ྎ
33. Microsoft Graph SDK for Ruby ʹ ͲͷΑ͏ͳΞϓϩʔν͕Ͱ͖Δ͔ʁ
34. ͲͷΑ͏ͳΞϓϩʔν͕Ͱ͖Δ͔ʁ • microsoft_grapsh ͸ Microsoft ͷ΋ͷ • ϝϯςφϯεͯ͠΋Β͑Δ or Ͱ͖Δ Ruby ੡ SDK ͕ཉ͍͠ • ͳ͍ͳΒࣗ࡞ͪ͠Ό͏ʁ
35. ࣗ࡞ͷ೉ؔ • ΤϯυϙΠϯτ਺͕๲େ • طଘͷ࣮૷͕೉ղ • OData Protocol • Microsoft ͕ 2007 ೥ʹఏএʢݱࡏ ver. 4.01ʣ • RESTful API ΛΑΓ؆୯ʹѻ͑ΔΑ͏ʹߟ͑ΒΕͨ
 Φʔϓϯϓϩτίϧ • https://www.odata.org/documentation/
36. Microsoft Graph νϡʔτϦΞϧ https://docs.microsoft.com/en-us/graph/tutorials/ruby
37. Microsoft Graph νϡʔτϦΞϧ https://docs.microsoft.com/en-us/graph/tutorials/ruby microsoft_graph ͸
 ࢖ΘΕ͍ͯͳ͍…
38. ࣗ࡞ͷ೉ؔ • ΤϯυϙΠϯτ਺͕๲େ • طଘͷ࣮૷͕೉ղ • OData Protocol • Microsoft ͕ 2007 ೥ʹఏএʢݱࡏ ver. 4.01ʣ • RESTful API ΛΑΓ؆୯ʹѻ͑ΔΑ͏ʹߟ͑ΒΕͨ
 Φʔϓϯϓϩτίϧ • https://www.odata.org/documentation/
39. ࣗ࡞ͷ೉ؔ • ΤϯυϙΠϯτ਺͕๲େ • طଘΛ౿ऻ͢Δͷ͕ࠔ೉ • OData Protocol • Microsoft ͕ 2007 ೥ʹఏএʢݱࡏ ver. 4.01ʣ • RESTful API ΛΑΓ؆୯ʹѻ͑ΔΑ͏ʹߟ͑ΒΕͨ
 Φʔϓϯϓϩτίϧ • https://www.odata.org/documentation/ ΋ͬͱָʹࣗ࡞Ͱ͖Δ
 ํ๏͸ͳ͍ͩΖ͏͔ʁ
40. OpenAPI
41. OpenAPI • ϓϩάϥϛϯάݴޠʹґଘ͠ͳ͍ RESTful API ΠϯλϑΣʔεͷఆٛ • ࢓༷ͷݺশ͸ OpenAPI Specification • https://github.com/OAI/OpenAPI-Specification • ݱࡏ v. 3.0.2 • چ Swagger specification • ࢀߟɿ https://speakerdeck.com/akihito_nakano/gunmaweb34
42. OpenAPI Generator • OpenAPI Specification ʹଇͬͯ YAML/JSON ϑΝΠϧΛ࡞੒͢Ε͹
 ͦΕΛجʹ API Client Λੜ੒ͯ͘͠ΕΔπʔϧ • https://github.com/OpenAPITools/openapi-generator • ࢀߟɿ https://rubykaigi.org/2019/presentations/ota42y.html#apr18
43. OpenAPI Generator • ରԠ͍ͯ͠Δݴޠ͕๛෋ • ౰વ Ruby ΋͋Δ https://github.com/OpenAPITools/openapi-generator#overview
44. OpenAPI Generator • ରԠ͍ͯ͠Δݴޠ͕๛෋ • ౰વ Ruby ΋͋Δ https://github.com/OpenAPITools/openapi-generator#overview OpenAPI Schema ͕͋Ε͹ ΫϥΠΞϯτΛੜ੒Ͱ͖Δ
45. microsoft-graph-openapi https://github.com/microsoftgraph/microsoft-graph-openapi
46. OpenAPI Generator Λ࢖ͬͯΈͨ https://github.com/microsoftgraph/microsoft-graph-openapi
47. OpenAPI Generator Λ࢖ͬͯΈͨ https://github.com/microsoftgraph/microsoft-graph-openapi
48. OpenAPI Generator Λ࢖ͬͯΈͨ https://github.com/microsoftgraph/microsoft-graph-openapi
49. ؾʹͳΔ఺ • ϝιου໊͕৑௕ • e.g. get_pet_by_id(pet_id, opts = {})
50. ݱࡏͷᷤ౻ʢͦͷ̍ʣ • OpenAPI Generator Λར༻͢Δ • OpenAPI Schema ͑͞࡞Ε͹ͦͷϝϯς͚ͩͰࡁΉ • microsoft-graph-openapi ͸໿ 51 ສߦ͋Δ • ϝιου໊͕৑௕
51. ݱࡏͷᷤ౻ʢͦͷ̎ʣ • OpenAPI Generator Λར༻͠ͳ͍ • ஍ຯʹΤϯυϙΠϯτΛҰͭͻͱ࣮ͭ૷͢Δ • OpenAPI Generator ͷ࠶ൃ໌ • Ͱ΋࣌ؒ͸༗ݶ…
52. ·ͱΊ • Microsoft Graph • αʔϏεͱͯ͠͸ศར • υΩϡϝϯτ΍ SDK ΋׬උʢ˞ Ruby Λআ͘ʣ • OpenAPI • ϓϩάϥϛϯάݴޠʹґଘ͠ͳ͍ RESTful API ΠϯλϑΣʔεͷఆٛ • OpenAPI Generator Λ্ख͘׆༻Ͱ͖Ε͹ Microsoft Graph SDK Λ
 ࠶ൃ໌Ͱ͖ͦ͏ • ࣗ࡞͢Δಓ͸ͲͷಓΛબΜͰ΋Ἒͷಓ • Microsoft Graph SDK for Ruby ΛͪΌΜͱϝϯςφϯεͯ͘͠ΕΕ͹ສࣄղܾ͢Δ…
53. ͝੩ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠