├── CONTRIBUTING.md ├── Microsoft Graph REST ASPNET Connect ├── Microsoft Graph REST ASPNET Connect │ ├── Views │ │ ├── _ViewStart.cshtml │ │ ├── Home │ │ │ ├── About.cshtml │ │ │ └── Graph.cshtml │ │ ├── Shared │ │ │ ├── Error.cshtml │ │ │ ├── _LoginPartial.cshtml │ │ │ └── _Layout.cshtml │ │ └── Web.config │ ├── Global.asax │ ├── favicon.ico │ ├── Content │ │ ├── test.jpg │ │ └── Site.css │ ├── Scripts │ │ └── _references.js │ ├── fonts │ │ ├── glyphicons-halflings-regular.eot │ │ ├── glyphicons-halflings-regular.ttf │ │ ├── glyphicons-halflings-regular.woff │ │ └── glyphicons-halflings-regular.woff2 │ ├── App_Start │ │ ├── FilterConfig.cs │ │ ├── BundleConfig.cs │ │ ├── RouteConfig.cs │ │ └── Startup.Auth.cs │ ├── Helpers │ │ ├── IAuthProvider.cs │ │ └── SampleAuthProvider.cs │ ├── Startup.cs │ ├── Controllers │ │ ├── ErrorController.cs │ │ ├── AccountController.cs │ │ └── HomeController.cs │ ├── Global.asax.cs │ ├── Web.Debug.config │ ├── Web.Release.config │ ├── Properties │ │ └── AssemblyInfo.cs │ ├── Models │ │ ├── GraphResources.cs │ │ └── GraphService.cs │ ├── packages.config │ ├── TokenStorage │ │ └── SessionTokenCache.cs │ ├── Web.config │ ├── App_GlobalResources │ │ ├── Resource.Designer.cs │ │ └── Resource.resx │ └── Microsoft Graph REST ASPNET Connect.csproj ├── Nuget.config └── Microsoft Graph REST ASPNET Connect.sln ├── aspnet-connect-rest-sample.yml ├── LICENSE ├── README-Localized ├── README-zh-tw.md ├── README-zh-cn.md ├── README-ja-jp.md ├── README-pt-br.md ├── README-ru-ru.md ├── README-es-es.md ├── README-fr-fr.md └── README-de-de.md ├── .gitignore └── README.md /CONTRIBUTING.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/microsoftgraph/aspnet-connect-rest-sample/master/CONTRIBUTING.md -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Views/_ViewStart.cshtml: -------------------------------------------------------------------------------- 1 | @{ 2 | Layout = "~/Views/Shared/_Layout.cshtml"; 3 | } 4 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Global.asax: -------------------------------------------------------------------------------- 1 | <%@ Application Codebehind="Global.asax.cs" Inherits="Microsoft_Graph_REST_ASPNET_Connect.MvcApplication" Language="C#" %> 2 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/microsoftgraph/aspnet-connect-rest-sample/master/Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/favicon.ico -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Content/test.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/microsoftgraph/aspnet-connect-rest-sample/master/Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Content/test.jpg -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Scripts/_references.js: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/microsoftgraph/aspnet-connect-rest-sample/master/Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Scripts/_references.js -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/fonts/glyphicons-halflings-regular.eot: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/microsoftgraph/aspnet-connect-rest-sample/master/Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/fonts/glyphicons-halflings-regular.eot -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/fonts/glyphicons-halflings-regular.ttf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/microsoftgraph/aspnet-connect-rest-sample/master/Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/fonts/glyphicons-halflings-regular.ttf -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/fonts/glyphicons-halflings-regular.woff: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/microsoftgraph/aspnet-connect-rest-sample/master/Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/fonts/glyphicons-halflings-regular.woff -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/fonts/glyphicons-halflings-regular.woff2: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/microsoftgraph/aspnet-connect-rest-sample/master/Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/fonts/glyphicons-halflings-regular.woff2 -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Views/Home/About.cshtml: -------------------------------------------------------------------------------- 1 | 3 | 4 | @using Resources 5 | 6 | @{ 7 | ViewBag.Title = Resource.About; 8 | } 9 |

@ViewBag.Title

10 | 11 |

@Resource.About_Description

-------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/App_Start/FilterConfig.cs: -------------------------------------------------------------------------------- 1 | using System.Web; 2 | using System.Web.Mvc; 3 | 4 | namespace Microsoft_Graph_REST_ASPNET_Connect 5 | { 6 | public class FilterConfig 7 | { 8 | public static void RegisterGlobalFilters(GlobalFilterCollection filters) 9 | { 10 | filters.Add(new HandleErrorAttribute()); 11 | } 12 | } 13 | } 14 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Views/Shared/Error.cshtml: -------------------------------------------------------------------------------- 1 | 3 | 4 | @using Resources 5 | 6 | @{ 7 | ViewBag.Title = Resource.App_Name; 8 | } 9 | 10 |

@ViewBag.Title

11 |

@Resource.Error_Introduction

12 | 13 |
@ViewBag.Message
-------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Helpers/IAuthProvider.cs: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. 3 | * See LICENSE in the source repository root for complete license information. 4 | */ 5 | 6 | using System.Threading.Tasks; 7 | 8 | namespace Microsoft_Graph_REST_ASPNET_Connect.Helpers 9 | { 10 | public interface IAuthProvider 11 | { 12 | Task GetUserAccessTokenAsync(); 13 | } 14 | } -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Content/Site.css: -------------------------------------------------------------------------------- 1 | body { 2 | padding-top: 50px; 3 | padding-bottom: 20px; 4 | } 5 | 6 | /* Set padding to keep content from hitting the edges */ 7 | .body-content { 8 | padding-left: 15px; 9 | padding-right: 15px; 10 | } 11 | 12 | /* Override the default bootstrap behavior where horizontal description lists 13 | will truncate terms that are too long to fit in the left column 14 | */ 15 | .dl-horizontal dt { 16 | white-space: normal; 17 | } 18 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/App_Start/BundleConfig.cs: -------------------------------------------------------------------------------- 1 | using System.Web; 2 | using System.Web.Optimization; 3 | 4 | namespace Microsoft_Graph_REST_ASPNET_Connect 5 | { 6 | public class BundleConfig 7 | { 8 | // For more information on bundling, visit http://go.microsoft.com/fwlink/?LinkId=301862 9 | public static void RegisterBundles(BundleCollection bundles) 10 | { 11 | bundles.Add(new StyleBundle("~/Content/css").Include( 12 | "~/Content/site.css")); 13 | } 14 | } 15 | } 16 | -------------------------------------------------------------------------------- /aspnet-connect-rest-sample.yml: -------------------------------------------------------------------------------- 1 | ### YamlMime:Sample 2 | sample: 3 | - name: Microsoft Graph Connect Sample for ASP.NET 4.6 (REST) 4 | path: '' 5 | description: This ASP.NET MVC sample shows how to connect to Microsoft Graph and use the API to send an email. 6 | readme: '' 7 | generateZip: FALSE 8 | isLive: TRUE 9 | technologies: 10 | - Microsoft Graph 11 | - Azure AD 12 | azureDeploy: '' 13 | author: jamescro 14 | platforms: [] 15 | languages: 16 | - C# 17 | extensions: 18 | products: 19 | - OneDrive 20 | - Office 365 21 | scenarios: [] 22 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Nuget.config: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Startup.cs: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. 3 | * See LICENSE in the source repository root for complete license information. 4 | */ 5 | 6 | using Owin; 7 | using Microsoft.Owin; 8 | 9 | [assembly: OwinStartup(typeof(Microsoft_Graph_REST_ASPNET_Connect.Startup))] 10 | 11 | namespace Microsoft_Graph_REST_ASPNET_Connect 12 | { 13 | public partial class Startup 14 | { 15 | public void Configuration(IAppBuilder app) 16 | { 17 | ConfigureAuth(app); 18 | } 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Controllers/ErrorController.cs: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. 3 | * See LICENSE in the source repository root for complete license information. 4 | */ 5 | 6 | using System.Web.Mvc; 7 | 8 | namespace Microsoft_Graph_REST_ASPNET_Connect.Controllers 9 | { 10 | public class ErrorController : Controller 11 | { 12 | // GET: Error 13 | public ActionResult Index(string message) 14 | { 15 | ViewBag.Message = message; 16 | return View("Error"); 17 | } 18 | } 19 | } -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Global.asax.cs: -------------------------------------------------------------------------------- 1 | using System; 2 | using System.Collections.Generic; 3 | using System.Linq; 4 | using System.Web; 5 | using System.Web.Mvc; 6 | using System.Web.Optimization; 7 | using System.Web.Routing; 8 | 9 | namespace Microsoft_Graph_REST_ASPNET_Connect 10 | { 11 | public class MvcApplication : System.Web.HttpApplication 12 | { 13 | protected void Application_Start() 14 | { 15 | AreaRegistration.RegisterAllAreas(); 16 | FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters); 17 | RouteConfig.RegisterRoutes(RouteTable.Routes); 18 | BundleConfig.RegisterBundles(BundleTable.Bundles); 19 | } 20 | } 21 | } 22 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/App_Start/RouteConfig.cs: -------------------------------------------------------------------------------- 1 | using System; 2 | using System.Collections.Generic; 3 | using System.Linq; 4 | using System.Web; 5 | using System.Web.Mvc; 6 | using System.Web.Routing; 7 | 8 | namespace Microsoft_Graph_REST_ASPNET_Connect 9 | { 10 | public class RouteConfig 11 | { 12 | public static void RegisterRoutes(RouteCollection routes) 13 | { 14 | routes.IgnoreRoute("{resource}.axd/{*pathInfo}"); 15 | 16 | routes.MapRoute( 17 | name: "Default", 18 | url: "{controller}/{action}/{id}", 19 | defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional } 20 | ); 21 | } 22 | } 23 | } 24 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | The MIT License (MIT) 2 | 3 | Copyright (c) 2016 Microsoft Corporation 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect.sln: -------------------------------------------------------------------------------- 1 | 2 | Microsoft Visual Studio Solution File, Format Version 12.00 3 | # Visual Studio 15 4 | VisualStudioVersion = 15.0.26730.16 5 | MinimumVisualStudioVersion = 10.0.40219.1 6 | Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Microsoft Graph REST ASPNET Connect", "Microsoft Graph REST ASPNET Connect\Microsoft Graph REST ASPNET Connect.csproj", "{374EF207-F626-4609-98B6-0BBBF939C59C}" 7 | EndProject 8 | Global 9 | GlobalSection(SolutionConfigurationPlatforms) = preSolution 10 | Debug|Any CPU = Debug|Any CPU 11 | Release|Any CPU = Release|Any CPU 12 | EndGlobalSection 13 | GlobalSection(ProjectConfigurationPlatforms) = postSolution 14 | {374EF207-F626-4609-98B6-0BBBF939C59C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU 15 | {374EF207-F626-4609-98B6-0BBBF939C59C}.Debug|Any CPU.Build.0 = Debug|Any CPU 16 | {374EF207-F626-4609-98B6-0BBBF939C59C}.Release|Any CPU.ActiveCfg = Release|Any CPU 17 | {374EF207-F626-4609-98B6-0BBBF939C59C}.Release|Any CPU.Build.0 = Release|Any CPU 18 | EndGlobalSection 19 | GlobalSection(SolutionProperties) = preSolution 20 | HideSolutionNode = FALSE 21 | EndGlobalSection 22 | GlobalSection(ExtensibilityGlobals) = postSolution 23 | SolutionGuid = {28166CBB-A65A-4C0D-BEF4-ED84792E5101} 24 | EndGlobalSection 25 | EndGlobal 26 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Web.Debug.config: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 17 | 18 | 29 | 30 | 31 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Web.Release.config: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 17 | 18 | 19 | 30 | 31 | 32 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Properties/AssemblyInfo.cs: -------------------------------------------------------------------------------- 1 | using System.Reflection; 2 | using System.Runtime.CompilerServices; 3 | using System.Runtime.InteropServices; 4 | 5 | // General Information about an assembly is controlled through the following 6 | // set of attributes. Change these attribute values to modify the information 7 | // associated with an assembly. 8 | [assembly: AssemblyTitle("Microsoft_Graph_REST_ASPNET_Connect")] 9 | [assembly: AssemblyDescription("")] 10 | [assembly: AssemblyConfiguration("")] 11 | [assembly: AssemblyCompany("")] 12 | [assembly: AssemblyProduct("Microsoft_Graph_REST_ASPNET_Connect")] 13 | [assembly: AssemblyCopyright("Copyright © 2016")] 14 | [assembly: AssemblyTrademark("")] 15 | [assembly: AssemblyCulture("")] 16 | 17 | // Setting ComVisible to false makes the types in this assembly not visible 18 | // to COM components. If you need to access a type in this assembly from 19 | // COM, set the ComVisible attribute to true on that type. 20 | [assembly: ComVisible(false)] 21 | 22 | // The following GUID is for the ID of the typelib if this project is exposed to COM 23 | [assembly: Guid("e0acf779-6715-46c4-a159-31a4cde3c9c1")] 24 | 25 | // Version information for an assembly consists of the following four values: 26 | // 27 | // Major Version 28 | // Minor Version 29 | // Build Number 30 | // Revision 31 | // 32 | // You can specify all the values or you can default the Revision and Build Numbers 33 | // by using the '*' as shown below: 34 | [assembly: AssemblyVersion("1.0.0.0")] 35 | [assembly: AssemblyFileVersion("1.0.0.0")] 36 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Views/Shared/_LoginPartial.cshtml: -------------------------------------------------------------------------------- 1 | 3 | 4 | @using Resources 5 | 6 | @if (Request.IsAuthenticated) 7 | { 8 | 9 | 18 | 19 | } 20 | else 21 | { 22 | 40 | 41 | 48 | } 49 | 50 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Models/GraphResources.cs: -------------------------------------------------------------------------------- 1 | using Newtonsoft.Json; 2 | using System; 3 | using System.Collections.Generic; 4 | using System.IO; 5 | 6 | namespace Microsoft_Graph_REST_ASPNET_Connect.Models 7 | { 8 | public class UserInfo 9 | { 10 | public string Address { get; set; } 11 | } 12 | 13 | public class FileInfo 14 | { 15 | public string Id { get; set; } 16 | public string Name { get; set; } 17 | public string SharingLink { get; set; } 18 | } 19 | 20 | public class Message 21 | { 22 | public string Subject { get; set; } 23 | public ItemBody Body { get; set; } 24 | public List ToRecipients { get; set; } 25 | public List Attachments { get; set; } 26 | } 27 | 28 | public class Recipient 29 | { 30 | public UserInfo EmailAddress { get; set; } 31 | } 32 | 33 | public class ItemBody 34 | { 35 | public string ContentType { get; set; } 36 | public string Content { get; set; } 37 | } 38 | 39 | public class MessageRequest 40 | { 41 | public Message Message { get; set; } 42 | public bool SaveToSentItems { get; set; } 43 | } 44 | 45 | public class Attachment 46 | { 47 | [JsonProperty(PropertyName = "@odata.type")] 48 | public string ODataType { get; set; } 49 | public byte[] ContentBytes { get; set; } 50 | public string Name { get; set; } 51 | } 52 | 53 | public class PermissionInfo 54 | { 55 | public SharingLinkInfo Link { get; set; } 56 | } 57 | 58 | public class SharingLinkInfo 59 | { 60 | public SharingLinkInfo(string type) 61 | { 62 | Type = type; 63 | } 64 | 65 | public string Type { get; set; } 66 | public string WebUrl { get; set; } 67 | } 68 | } -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Views/Web.config: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 |
7 |
8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/packages.config: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Controllers/AccountController.cs: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. 3 | * See LICENSE in the source repository root for complete license information. 4 | */ 5 | 6 | using System.Web; 7 | using System.Web.Mvc; 8 | using Microsoft.Owin.Security; 9 | using Microsoft.Owin.Security.Cookies; 10 | using Microsoft.Owin.Security.OpenIdConnect; 11 | using Microsoft_Graph_REST_ASPNET_Connect.TokenStorage; 12 | using Microsoft_Graph_REST_ASPNET_Connect.Helpers; 13 | using System.Security.Claims; 14 | 15 | namespace Microsoft_Graph_REST_ASPNET_Connect.Controllers 16 | { 17 | public class AccountController : Controller 18 | { 19 | public void SignIn() 20 | { 21 | if (!Request.IsAuthenticated) 22 | { 23 | // Signal OWIN to send an authorization request to Azure. 24 | HttpContext.GetOwinContext().Authentication.Challenge( 25 | new AuthenticationProperties { RedirectUri = "/" }, 26 | OpenIdConnectAuthenticationDefaults.AuthenticationType); 27 | } 28 | } 29 | 30 | // Here we just clear the token cache, sign out the GraphServiceClient, and end the session with the web app. 31 | public void SignOut() 32 | { 33 | if (Request.IsAuthenticated) 34 | { 35 | // Get the user's token cache and clear it. 36 | string userObjectId = ClaimsPrincipal.Current.FindFirst(ClaimTypes.NameIdentifier).Value; 37 | 38 | SessionTokenCache tokenCache = new SessionTokenCache(userObjectId, HttpContext); 39 | HttpContext.GetOwinContext().Authentication.SignOut(OpenIdConnectAuthenticationDefaults.AuthenticationType, CookieAuthenticationDefaults.AuthenticationType); 40 | } 41 | 42 | 43 | // Send an OpenID Connect sign-out request. 44 | HttpContext.GetOwinContext().Authentication.SignOut( 45 | CookieAuthenticationDefaults.AuthenticationType); 46 | Response.Redirect("/"); 47 | } 48 | } 49 | } -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Views/Home/Graph.cshtml: -------------------------------------------------------------------------------- 1 | 3 | 4 | @using Resources 5 | 6 | @{ 7 | ViewBag.Title = Resource.App_Name; 8 | } 9 | 10 |

@ViewBag.Title

11 |

@Resource.Graph_GetEmailAddress_Heading

12 |

@Html.Raw(Resource.Graph_GetEmailAddress_Instruction)

13 | @using (Html.BeginForm("GetMyEmailAddress", "Home")) 14 | { 15 |
16 |
17 | 18 |
19 |
20 | } 21 |
22 | 23 | 
@ViewBag.Email
24 |
25 | 26 |

@Resource.Graph_SendMail_Heading

27 |

@Html.Raw(Resource.Graph_SendMail_Instruction)

28 | @using (Html.BeginForm("SendEmail", "Home")) 29 | { 30 |
31 |
32 | 33 | 34 |
35 |
36 | 37 | 38 |
39 |
40 | 41 | 42 |
43 |
44 | } 45 |
46 |

@Html.Raw(ViewBag.Message)

47 |
48 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Views/Shared/_Layout.cshtml: -------------------------------------------------------------------------------- 1 | 3 | 4 | @using Resources 5 | 6 | 7 | 8 | 9 | 10 | 11 | @ViewBag.Title 12 | @Styles.Render("~/Content/css") 13 | @Styles.Render("https://ajax.aspnetcdn.com/ajax/bootstrap/3.3.6/css/bootstrap.min.css") 14 | @Styles.Render("https://ajax.aspnetcdn.com/ajax/bootstrap/3.3.6/css/bootstrap-theme.min.css") 15 | @Scripts.Render("https://ajax.aspnetcdn.com/ajax/modernizr/modernizr-2.6.2.js") 16 | 17 | 18 |
19 |
20 |
21 | 26 | @Html.ActionLink(Resource.App_Name_Short, "Index", "Home", null, new { @class = "navbar-brand" }) 27 |
28 |
29 |
    30 |
  • @Html.ActionLink(Resource.Home, "Index", "Home")
    • 31 |
  • @Html.ActionLink(Resource.About, "About", "Home")
    • 32 |
33 | @Html.Partial("_LoginPartial") 34 |
35 |
36 |
37 |
38 | @RenderBody() 39 |
40 |
41 |

© @DateTime.Now.Year - @ViewBag.Title

42 |
43 |
44 | @Scripts.Render("https://ajax.aspnetcdn.com/ajax/jQuery/jquery-2.2.3.min.js") 45 | @Scripts.Render("https://ajax.aspnetcdn.com/ajax/bootstrap/3.3.6/bootstrap.min.js") 46 | @RenderSection("scripts", required: false) 47 | 48 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Helpers/SampleAuthProvider.cs: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. 3 | * See LICENSE in the source repository root for complete license information. 4 | */ 5 | 6 | using Microsoft.Identity.Client; 7 | using Microsoft.Owin.Security; 8 | using Microsoft.Owin.Security.OpenIdConnect; 9 | using Microsoft_Graph_REST_ASPNET_Connect.TokenStorage; 10 | using System.Collections.Generic; 11 | using System.Configuration; 12 | using System.Linq; 13 | using System.Security.Claims; 14 | using System.Threading.Tasks; 15 | using System.Web; 16 | using Resources; 17 | using System; 18 | 19 | namespace Microsoft_Graph_REST_ASPNET_Connect.Helpers 20 | { 21 | public sealed class SampleAuthProvider : IAuthProvider 22 | { 23 | 24 | // Properties used to get and manage an access token. 25 | private string redirectUri = ConfigurationManager.AppSettings["ida:RedirectUri"]; 26 | private string appId = ConfigurationManager.AppSettings["ida:AppId"]; 27 | private string appSecret = ConfigurationManager.AppSettings["ida:AppSecret"]; 28 | private string scopes = ConfigurationManager.AppSettings["ida:GraphScopes"]; 29 | private SessionTokenCache tokenCache { get; set; } 30 | 31 | private static readonly SampleAuthProvider instance = new SampleAuthProvider(); 32 | private SampleAuthProvider() { } 33 | 34 | public static SampleAuthProvider Instance 35 | { 36 | get 37 | { 38 | return instance; 39 | } 40 | } 41 | 42 | // Gets an access token. First tries to get the token from the token cache. 43 | public async Task GetUserAccessTokenAsync() 44 | { 45 | string signedInUserID = ClaimsPrincipal.Current.FindFirst(ClaimTypes.NameIdentifier).Value; 46 | HttpContextWrapper httpContext = new HttpContextWrapper(HttpContext.Current); 47 | TokenCache userTokenCache = new SessionTokenCache(signedInUserID, httpContext).GetMsalCacheInstance(); 48 | //var cachedItems = tokenCache.ReadItems(appId); // see what's in the cache 49 | 50 | ConfidentialClientApplication cca = new ConfidentialClientApplication( 51 | appId, 52 | redirectUri, 53 | new ClientCredential(appSecret), 54 | userTokenCache, 55 | null); 56 | 57 | try 58 | { 59 | AuthenticationResult result = await cca.AcquireTokenSilentAsync(scopes.Split(new char[] { ' ' }), cca.Users.First()); 60 | return result.AccessToken; 61 | } 62 | 63 | // Unable to retrieve the access token silently. 64 | catch (Exception) 65 | { 66 | HttpContext.Current.Request.GetOwinContext().Authentication.Challenge( 67 | new AuthenticationProperties() { RedirectUri = "/" }, 68 | OpenIdConnectAuthenticationDefaults.AuthenticationType); 69 | 70 | throw new Exception(Resource.Error_AuthChallengeNeeded); 71 | } 72 | } 73 | } 74 | } -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/TokenStorage/SessionTokenCache.cs: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. 3 | * See LICENSE in the source repository root for complete license information. 4 | */ 5 | 6 | using Microsoft.Identity.Client; 7 | using System; 8 | using System.Collections.Generic; 9 | using System.Linq; 10 | using System.Threading; 11 | using System.Web; 12 | 13 | namespace Microsoft_Graph_REST_ASPNET_Connect.TokenStorage 14 | { 15 | 16 | // Store the user's token information. 17 | public class SessionTokenCache 18 | { 19 | private static ReaderWriterLockSlim SessionLock = new ReaderWriterLockSlim(LockRecursionPolicy.NoRecursion); 20 | string UserId = string.Empty; 21 | string CacheId = string.Empty; 22 | HttpContextBase httpContext = null; 23 | 24 | TokenCache cache = new TokenCache(); 25 | 26 | public SessionTokenCache(string userId, HttpContextBase httpcontext) 27 | { 28 | // not object, we want the SUB 29 | UserId = userId; 30 | CacheId = UserId + "_TokenCache"; 31 | httpContext = httpcontext; 32 | Load(); 33 | } 34 | 35 | public TokenCache GetMsalCacheInstance() 36 | { 37 | cache.SetBeforeAccess(BeforeAccessNotification); 38 | cache.SetAfterAccess(AfterAccessNotification); 39 | Load(); 40 | return cache; 41 | } 42 | 43 | public void SaveUserStateValue(string state) 44 | { 45 | SessionLock.EnterWriteLock(); 46 | httpContext.Session[CacheId + "_state"] = state; 47 | SessionLock.ExitWriteLock(); 48 | } 49 | public string ReadUserStateValue() 50 | { 51 | string state = string.Empty; 52 | SessionLock.EnterReadLock(); 53 | state = (string)httpContext.Session[CacheId + "_state"]; 54 | SessionLock.ExitReadLock(); 55 | return state; 56 | } 57 | public void Load() 58 | { 59 | SessionLock.EnterReadLock(); 60 | cache.Deserialize((byte[])httpContext.Session[CacheId]); 61 | SessionLock.ExitReadLock(); 62 | } 63 | 64 | public void Persist() 65 | { 66 | SessionLock.EnterWriteLock(); 67 | 68 | // Optimistically set HasStateChanged to false. We need to do it early to avoid losing changes made by a concurrent thread. 69 | cache.HasStateChanged = false; 70 | 71 | // Reflect changes in the persistent store 72 | httpContext.Session[CacheId] = cache.Serialize(); 73 | SessionLock.ExitWriteLock(); 74 | } 75 | 76 | // Triggered right before MSAL needs to access the cache. 77 | // Reload the cache from the persistent store in case it changed since the last access. 78 | void BeforeAccessNotification(TokenCacheNotificationArgs args) 79 | { 80 | Load(); 81 | } 82 | 83 | // Triggered right after MSAL accessed the cache. 84 | void AfterAccessNotification(TokenCacheNotificationArgs args) 85 | { 86 | // if the access operation resulted in a cache update 87 | if (cache.HasStateChanged) 88 | { 89 | Persist(); 90 | } 91 | } 92 | 93 | } 94 | } -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Controllers/HomeController.cs: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. 3 | * See LICENSE in the source repository root for complete license information. 4 | */ 5 | 6 | using System.Threading.Tasks; 7 | using System.Web.Mvc; 8 | using Microsoft_Graph_REST_ASPNET_Connect.Helpers; 9 | using Microsoft_Graph_REST_ASPNET_Connect.Models; 10 | using Resources; 11 | using System; 12 | using System.IO; 13 | 14 | namespace Microsoft_Graph_REST_ASPNET_Connect.Controllers 15 | { 16 | public class HomeController : Controller 17 | { 18 | GraphService graphService = new GraphService(); 19 | 20 | public ActionResult Index() 21 | { 22 | return View("Graph"); 23 | } 24 | 25 | [Authorize] 26 | // Get the current user's email address from their profile. 27 | public async Task GetMyEmailAddress() 28 | { 29 | try 30 | { 31 | 32 | // Get an access token. 33 | string accessToken = await SampleAuthProvider.Instance.GetUserAccessTokenAsync(); 34 | 35 | // Get the current user's email address. 36 | ViewBag.Email = await graphService.GetMyEmailAddress(accessToken); 37 | return View("Graph"); 38 | } 39 | catch (Exception e) 40 | { 41 | if (e.Message == Resource.Error_AuthChallengeNeeded) return new EmptyResult(); 42 | return RedirectToAction("Index", "Error", new { message = Resource.Error_Message + Request.RawUrl + ": " + e.Message }); 43 | } 44 | } 45 | 46 | [Authorize] 47 | // Send mail on behalf of the current user. 48 | public async Task SendEmail() 49 | { 50 | if (string.IsNullOrEmpty(Request.Form["email-address"])) 51 | { 52 | ViewBag.Message = Resource.Graph_SendMail_Message_GetEmailFirst; 53 | return View("Graph"); 54 | } 55 | 56 | try 57 | { 58 | 59 | // Get an access token. 60 | string accessToken = await SampleAuthProvider.Instance.GetUserAccessTokenAsync(); 61 | 62 | // Build the email message. 63 | // The message contains a file attachment and embeds a sharing link to the file in the message body. 64 | MessageRequest email = await graphService.BuildEmailMessage(accessToken, 65 | Request.Form["recipients"], Request.Form["subject"]); 66 | 67 | // Send the email. 68 | ViewBag.Message = await graphService.SendEmail(accessToken, email); 69 | 70 | // Reset the current user's email address and the status to display when the page reloads. 71 | ViewBag.Email = Request.Form["email-address"]; 72 | return View("Graph"); 73 | } 74 | catch (Exception e) 75 | { 76 | if (e.Message == Resource.Error_AuthChallengeNeeded) return new EmptyResult(); 77 | return RedirectToAction("Index", "Error", new { message = Resource.Error_Message + Request.RawUrl + ": " + e.Message }); 78 | } 79 | } 80 | 81 | public ActionResult About() 82 | { 83 | return View(); 84 | } 85 | } 86 | } -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Web.config: -------------------------------------------------------------------------------- 1 | 2 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | -------------------------------------------------------------------------------- /README-Localized/README-zh-tw.md: -------------------------------------------------------------------------------- 1 | # Microsoft Graph Connect 範例 (適用於 ASP.NET 4.6) 2 | 3 | ## 目錄 4 | 5 | * [必要條件](#必要條件) 6 | * [註冊應用程式](#註冊應用程式) 7 | * [建置及執行範例](#建置及執行範例) 8 | * [附註的程式碼](#附註的程式碼) 9 | * [問題和建議](#問題和建議) 10 | * [參與](#參與) 11 | * [其他資源](#其他資源) 12 | 13 | 這個範例示範如何使用 Microsoft Graph API 將 ASP.NET 4.6 MVC Web 應用程式連線至 Microsoft 工作或學校 (Azure Active Directory) 或個人 (Microsoft) 帳戶，以傳送郵件。 它會使用 [Microsoft Graph.NET 用戶端程式庫](https://github.com/microsoftgraph/msgraph-sdk-dotnet)，使用 Microsoft Graph 所傳回的資料。 14 | 15 | 此外，範例會使用 [Microsoft 驗證程式庫 (MSAL)](https://www.nuget.org/packages/Microsoft.Identity.Client/) 進行驗證。 MSAL SDK 提供功能以使用 [v2 驗證端點](https://azure.microsoft.com/en-us/documentation/articles/active-directory-appmodel-v2-overview)，可讓開發人員撰寫單一程式碼流程，控制工作或學校 (Azure Active Directory) 和個人 (Microsoft) 帳戶的驗證。 16 | 17 | > **附註** MSAL SDK 目前是發行前版本，因此不應該用於實際執行程式碼。 在這裡僅供說明目的使用。 18 | 19 | ## 必要條件 20 | 21 | 此範例需要下列項目： 22 | 23 | * [Visual Studio 2015](https://www.visualstudio.com/en-us/downloads) 24 | * [Microsoft 帳戶](https://www.outlook.com)或[商務用 Office 365 帳戶](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account)。 您可以註冊 [Office 365 開發人員訂用帳戶](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account)，其中包含開始建置 Office 365 應用程式所需的資源。 25 | 26 | ## 註冊應用程式 27 | 28 | 1. 使用您的個人或工作或學校帳戶登入[應用程式註冊入口網站](https://apps.dev.microsoft.com/)。 29 | 30 | 2. 選擇 [新增應用程式]。 31 | 32 | 3. 為應用程式輸入名稱，然後選擇 [建立應用程式]。 33 | 34 | [註冊] 頁面隨即顯示，列出您的應用程式的屬性。 35 | 36 | 4. 複製應用程式 ID。 這是您的應用程式的唯一識別碼。 37 | 38 | 5. 在 [應用程式密碼] 底下，選擇 [產生新密碼] 從 [產生的新密碼] 對話方塊中複製密碼。 39 | 40 | 使用應用程式 ID 和密碼，在下一個區段中設定範例應用程式。 41 | 42 | 6. 在 [平台] 底下，選擇 [新增平台]。 43 | 44 | 7. 選擇 [Web]。 45 | 46 | 8. 請確定已選取 [允許隱含的流程] 核取方塊，然後輸入 *https://localhost:44300/* 做為重新導向 URI。 47 | 48 | [允許隱含的流程] 選項會啟用混合式流程。 在驗證期間，這可讓應用程式收到登入資訊 (id_token) 和成品 (在這種情況下，是授權程式碼)，應用程式可以用來取得存取權杖。 49 | 50 | 9. 選擇 [儲存]。 51 | 52 | ## 建置及執行範例 53 | 54 | 1. 下載或複製 Microsoft Graph Connect 範例 (適用於 ASP.NET 4.6)。 55 | 56 | 2. 在 Visual Studio 中開啟範例解決方案。 57 | 58 | 3. 在根目錄的 Web.config 檔案中，將 **ida:AppId** 和 **ida:AppSecret** 預留位置值取代為您在應用程式註冊期間複製的應用程式 ID 與密碼。 59 | 60 | 4. 按 F5 以建置及執行範例。 這樣會還原 NuGet 封裝相依性，並開啟應用程式。 61 | 62 | >如果您在安裝封裝時看到任何錯誤，請確定您放置解決方案的本機路徑不會太長/太深。 將解決方案移靠近您的磁碟機根目錄可解決這個問題。 63 | 64 | 5. 登入您的個人或工作或學校帳戶，並授與要求的權限。 65 | 66 | 6. 選擇 [取得電子郵件地址] 按鈕。 當作業完成時，登入使用者的電子郵件地址會顯示在頁面中。 67 | 68 | 7. 選擇性編輯收件者清單和電子郵件主旨，然後選擇 [傳送郵件] 按鈕。 當郵件傳送時，成功的訊息會顯示在按鈕下方。 69 | 70 | ## 附註的程式碼 71 | 72 | - [Startup.Auth.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/App_Start/Startup.Auth.cs). 驗證目前使用者，並初始化範例的權杖快取。 73 | 74 | - [SessionTokenCache.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/TokenStorage/SessionTokenCache.cs). 儲存使用者的權杖資訊。 您可以將這個項目取代為您自己的自訂權杖快取。 在[多租用戶應用程式中的快取存取權杖](https://azure.microsoft.com/en-us/documentation/articles/guidance-multitenant-identity-token-cache/)中深入了解。 75 | 76 | - [SampleAuthProvider.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SampleAuthProvider.cs). 實作本機 IAuthProvider 介面，並取得存取權杖，方法是使用 MSAL **AcquireTokenSilentAsync** 方法。 您可以將這個項目取代為您自己的驗證提供者。 77 | 78 | - [SDKHelper.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SDKHelper.cs). 從 [Microsoft Graph.NET 用戶端程式庫](https://github.com/microsoftgraph/msgraph-sdk-dotnet)初始化 **GraphServiceClient**用來與 Microsoft Graph 互動。 79 | 80 | - [HomeController.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Controllers/HomeController.cs). 包含方法，該方法使用 **GraphServiceClient** 以建置並傳送呼叫至 Microsoft Graph 服務，並且處理回應。 81 | - **GetMyEmailAddress** 動作會從 **mail** 或 **userPrincipalName** 屬性，取得目前使用者的電子郵件地址。 82 | - **SendMail** 動作會代表目前的使用者傳送電子郵件。 83 | 84 | - [Graph.cshtml](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Views/Home/Graph.cshtml). 包含範例的 UI。 85 | 86 | ## 問題和建議 87 | 88 | 我們很樂於收到您對於此範例的意見反應。 您可以在此儲存機制的[問題](https://github.com/microsoftgraph/aspnet-connect-sample/issues)區段中，將您的問題及建議傳送給我們。 89 | 90 | 我們很重視您的意見。 請透過 [Stack Overflow](http://stackoverflow.com/questions/tagged/microsoftgraph) 與我們連絡。 以 [MicrosoftGraph] 標記您的問題。 91 | 92 | ## 參與 ## 93 | 94 | 如果您想要參與這個範例，請參閱 [CONTRIBUTING.md](CONTRIBUTING.md)。 95 | 96 | 此專案已採用 [Microsoft 開放原始碼執行](https://opensource.microsoft.com/codeofconduct/)。如需詳細資訊，請參閱[程式碼執行常見問題集](https://opensource.microsoft.com/codeofconduct/faq/)，如果有其他問題或意見，請連絡 [opencode@microsoft.com](mailto:opencode@microsoft.com)。 97 | 98 | ## 其他資源 99 | 100 | - [其他 Microsoft Graph connect 範例](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect) 101 | - [Microsoft Graph 概觀](http://graph.microsoft.io) 102 | - [Office 開發人員程式碼範例](http://dev.office.com/code-samples) 103 | - [Office 開發中心](http://dev.office.com/) 104 | 105 | ## 著作權 106 | Copyright (c) 2016 Microsoft.著作權所有，並保留一切權利。 107 | 108 | 109 | -------------------------------------------------------------------------------- /README-Localized/README-zh-cn.md: -------------------------------------------------------------------------------- 1 | # ASP.NET 4.6 的 Microsoft Graph Connect 示例 2 | 3 | ## 目录 4 | 5 | * [先决条件](#先决条件) 6 | * [注册应用程序](#注册应用程序) 7 | * [生成和运行示例](#生成和运行示例) 8 | * [注释代码](#注释代码) 9 | * [问题和意见](#问题和意见) 10 | * [参与](#参与) 11 | * [其他资源](#其他资源) 12 | 13 | 此示例演示如何通过使用 Microsoft Graph API 发送电子邮件来将 ASP.NET 4.6 MVC Web 应用连接到 Microsoft 工作或学校 (Azure Active Directory) 或个人 (Microsoft) 帐户。 它使用 [Microsoft Graph .NET 客户端库](https://github.com/microsoftgraph/msgraph-sdk-dotnet) 来处理 Microsoft Graph 返回的数据。 14 | 15 | 此外，此示例使用 [Microsoft 身份验证库 (MSAL)](https://www.nuget.org/packages/Microsoft.Identity.Client/) 进行身份验证。 MSAL SDK 提供可使用 [v2 身份验证终结点](https://azure.microsoft.com/en-us/documentation/articles/active-directory-appmodel-v2-overview) 的功能，借助该终结点，开发人员可以编写单个代码流来处理对工作或学校 (Azure Active Directory) 帐户或个人 (Microsoft) 帐户的身份验证。 16 | 17 | > **注意** MSAL SDK 目前处于预发布状态，因此，不应该在生产代码中使用。 在此处仅用于说明目的。 18 | 19 | ## 先决条件 20 | 21 | 此示例需要以下各项： 22 | 23 | * [Visual Studio 2015](https://www.visualstudio.com/en-us/downloads) 24 | * [Microsoft 帐户](https://www.outlook.com) 或 [Office 365 商业版帐户](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account)。 你可以注册 [Office 365 开发人员订阅](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account)，其中包含开始构建 Office 365 应用所需的资源。 25 | 26 | ## 注册应用程序 27 | 28 | 1. 使用个人或工作或学校帐户登录到 [应用注册门户](https://apps.dev.microsoft.com/)。 29 | 30 | 2. 选择“**添加应用**”。 31 | 32 | 3. 输入应用的名称，并选择“**创建应用程序**”。 33 | 34 | 将显示注册页，其中列出应用的属性。 35 | 36 | 4. 复制应用程序 ID。 这是应用的唯一标识符。 37 | 38 | 5. 在“**应用程序密码**”下，选择“**生成新密码**”。 从“**生成的新密码**”对话框复制密码。 39 | 40 | 使用应用程序 ID 和密码来在下一部分中配置示例应用。 41 | 42 | 6. 在“**平台**”下，选择“**添加平台**”。 43 | 44 | 7. 选择“**Web**”。 45 | 46 | 8. 请确保已选中“**允许隐式流**”复选框，输入 *https://localhost:44300/* 作为重定向 URI。 47 | 48 | “**允许隐式流**”选项启用混合流。 在身份验证过程中，这可使应用同时接收登录信息 (id_token) 以及应用可用来获取访问令牌的项目（在这种情况下，项目为授权代码）。 49 | 50 | 9. 选择“**保存**”。 51 | 52 | ## 生成和运行示例 53 | 54 | 1. 下载或克隆适用于 ASP.NET 4.6 的 Microsoft Graph Connect 示例。 55 | 56 | 2. 在 Visual Studio 中打开示例解决方案。 57 | 58 | 3. 在根目录的 Web.config 文件中，使用你在应用注册过程中复制的应用程序 ID 和密码来替换 **ida:AppId** 和 **ida:AppSecret** 占位符值。 59 | 60 | 4. 按 F5 生成和运行此示例。 这将还原 NuGet 包依赖项并打开该应用。 61 | 62 | >如果在安装包时出现任何错误，请确保你放置该解决方案的本地路径并未太长/太深。 将解决方案移动到更接近驱动器根目录的位置可以解决此问题。 63 | 64 | 5. 使用你的个人帐户、工作或学校帐户登录，并授予所请求的权限。 65 | 66 | 6. 选择“**获取电子邮件地址**”按钮。 在操作完成后，已登录用户的电子邮件地址会在此页上显示。 67 | 68 | 7. 还可以编辑收件人列表和电子邮件主题，然后选择“**发送电子邮件**”按钮。 在邮件发送后，按钮下方将显示成功消息。 69 | 70 | ## 注释代码 71 | 72 | - [Startup.Auth.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/App_Start/Startup.Auth.cs). 对当前用户进行身份验证并初始化该示例的令牌缓存。 73 | 74 | - [SessionTokenCache.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/TokenStorage/SessionTokenCache.cs). 存储用户的令牌信息。 可以使用你自己的自定义令牌缓存来替换此信息。 在 [在多租户应用程序中缓存访问令牌](https://azure.microsoft.com/en-us/documentation/articles/guidance-multitenant-identity-token-cache/) 中了解详细信息。 75 | 76 | - [SampleAuthProvider.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SampleAuthProvider.cs). 实现本地 IAuthProvider 接口，并通过使用 MSAL **AcquireTokenSilentAsync** 方法获取一个访问令牌。 可以使用你自己的身份验证提供程序来替换此方法。 77 | 78 | - [SDKHelper.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SDKHelper.cs). 初始化来自用于与 Microsoft Graph 交互的 [Microsoft Graph .NET 客户端库](https://github.com/microsoftgraph/msgraph-sdk-dotnet) 的 **GraphServiceClient**。 79 | 80 | - [HomeController.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Controllers/HomeController.cs). 包含使用 **GraphServiceClient** 生成并发送到 Microsoft Graph 服务的调用并处理响应的方法。 81 | - **GetMyEmailAddress** 操作从 **mail** 或 **userPrincipalName** 属性获取当前用户的电子邮件地址。 82 | - **SendMail** 操作将代表当前用户发送一封电子邮件。 83 | 84 | - [Graph.cshtml](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Views/Home/Graph.cshtml). 包含该示例的 UI。 85 | 86 | ## 问题和意见 87 | 88 | 我们乐意倾听你有关此示例的反馈。 你可以在该存储库中的[问题](https://github.com/microsoftgraph/aspnet-connect-sample/issues) 部分将问题和建议发送给我们。 89 | 90 | 你的反馈对我们意义重大。 请在 [Stack Overflow](http://stackoverflow.com/questions/tagged/microsoftgraph) 上与我们联系。 使用 [MicrosoftGraph] 标记出你的问题。 91 | 92 | ## 参与 ## 93 | 94 | 如果想要参与本示例，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。 95 | 96 | 此项目采用 [Microsoft 开源行为准则](https://opensource.microsoft.com/codeofconduct/)。有关详细信息，请参阅 [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)（行为准则常见问题解答），有任何其他问题或意见，也可联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。 97 | 98 | ## 其他资源 99 | 100 | - [其他 Microsoft Graph Connect 示例](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect) 101 | - [Microsoft Graph 概述](http://graph.microsoft.io) 102 | - [Office 开发人员代码示例](http://dev.office.com/code-samples) 103 | - [Office 开发人员中心](http://dev.office.com/) 104 | 105 | ## 版权 106 | 版权所有 (c) 2016 Microsoft。保留所有权利。 107 | 108 | 109 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | ## Ignore Visual Studio temporary files, build results, and 2 | ## files generated by popular Visual Studio add-ons. 3 | 4 | # User-specific files 5 | *.suo 6 | *.user 7 | *.userosscache 8 | *.sln.docstates 9 | 10 | # User-specific files (MonoDevelop/Xamarin Studio) 11 | *.userprefs 12 | 13 | # Build results 14 | [Dd]ebug/ 15 | [Dd]ebugPublic/ 16 | [Rr]elease/ 17 | [Rr]eleases/ 18 | x64/ 19 | x86/ 20 | bld/ 21 | [Bb]in/ 22 | [Oo]bj/ 23 | 24 | # Visual Studio 2015 cache/options directory 25 | .vs/ 26 | # Uncomment if you have tasks that create the project's static files in wwwroot 27 | #wwwroot/ 28 | 29 | # MSTest test Results 30 | [Tt]est[Rr]esult*/ 31 | [Bb]uild[Ll]og.* 32 | 33 | # NUNIT 34 | *.VisualState.xml 35 | TestResult.xml 36 | 37 | # Build Results of an ATL Project 38 | [Dd]ebugPS/ 39 | [Rr]eleasePS/ 40 | dlldata.c 41 | 42 | # DNX 43 | project.lock.json 44 | artifacts/ 45 | 46 | *_i.c 47 | *_p.c 48 | *_i.h 49 | *.ilk 50 | *.meta 51 | *.obj 52 | *.pch 53 | *.pdb 54 | *.pgc 55 | *.pgd 56 | *.rsp 57 | *.sbr 58 | *.tlb 59 | *.tli 60 | *.tlh 61 | *.tmp 62 | *.tmp_proj 63 | *.log 64 | *.vspscc 65 | *.vssscc 66 | .builds 67 | *.pidb 68 | *.svclog 69 | *.scc 70 | 71 | # Chutzpah Test files 72 | _Chutzpah* 73 | 74 | # Visual C++ cache files 75 | ipch/ 76 | *.aps 77 | *.ncb 78 | *.opendb 79 | *.opensdf 80 | *.sdf 81 | *.cachefile 82 | 83 | # Visual Studio profiler 84 | *.psess 85 | *.vsp 86 | *.vspx 87 | *.sap 88 | 89 | # TFS 2012 Local Workspace 90 | $tf/ 91 | 92 | # Guidance Automation Toolkit 93 | *.gpState 94 | 95 | # ReSharper is a .NET coding add-in 96 | _ReSharper*/ 97 | *.[Rr]e[Ss]harper 98 | *.DotSettings.user 99 | 100 | # JustCode is a .NET coding add-in 101 | .JustCode 102 | 103 | # TeamCity is a build add-in 104 | _TeamCity* 105 | 106 | # DotCover is a Code Coverage Tool 107 | *.dotCover 108 | 109 | # NCrunch 110 | _NCrunch_* 111 | .*crunch*.local.xml 112 | nCrunchTemp_* 113 | 114 | # MightyMoose 115 | *.mm.* 116 | AutoTest.Net/ 117 | 118 | # Web workbench (sass) 119 | .sass-cache/ 120 | 121 | # Installshield output folder 122 | [Ee]xpress/ 123 | 124 | # DocProject is a documentation generator add-in 125 | DocProject/buildhelp/ 126 | DocProject/Help/*.HxT 127 | DocProject/Help/*.HxC 128 | DocProject/Help/*.hhc 129 | DocProject/Help/*.hhk 130 | DocProject/Help/*.hhp 131 | DocProject/Help/Html2 132 | DocProject/Help/html 133 | 134 | # Click-Once directory 135 | publish/ 136 | 137 | # Publish Web Output 138 | *.[Pp]ublish.xml 139 | *.azurePubxml 140 | # TODO: Comment the next line if you want to checkin your web deploy settings 141 | # but database connection strings (with potential passwords) will be unencrypted 142 | *.pubxml 143 | *.publishproj 144 | 145 | # NuGet Packages 146 | *.nupkg 147 | # The packages folder can be ignored because of Package Restore 148 | **/packages/* 149 | # except build/, which is used as an MSBuild target. 150 | !**/packages/build/ 151 | # Uncomment if necessary however generally it will be regenerated when needed 152 | #!**/packages/repositories.config 153 | # NuGet v3's project.json files produces more ignoreable files 154 | *.nuget.props 155 | *.nuget.targets 156 | 157 | # Microsoft Azure Build Output 158 | csx/ 159 | *.build.csdef 160 | 161 | # Microsoft Azure Emulator 162 | ecf/ 163 | rcf/ 164 | 165 | # Microsoft Azure ApplicationInsights config file 166 | ApplicationInsights.config 167 | 168 | # Windows Store app package directory 169 | AppPackages/ 170 | BundleArtifacts/ 171 | 172 | # Visual Studio cache files 173 | # files ending in .cache can be ignored 174 | *.[Cc]ache 175 | # but keep track of directories ending in .cache 176 | !*.[Cc]ache/ 177 | 178 | # Others 179 | ClientBin/ 180 | ~$* 181 | *~ 182 | *.dbmdl 183 | *.dbproj.schemaview 184 | *.pfx 185 | *.publishsettings 186 | node_modules/ 187 | orleans.codegen.cs 188 | 189 | # RIA/Silverlight projects 190 | Generated_Code/ 191 | 192 | # Backup & report files from converting an old project file 193 | # to a newer Visual Studio version. Backup files are not needed, 194 | # because we have git ;-) 195 | _UpgradeReport_Files/ 196 | Backup*/ 197 | UpgradeLog*.XML 198 | UpgradeLog*.htm 199 | 200 | # SQL Server files 201 | *.mdf 202 | *.ldf 203 | 204 | # Business Intelligence projects 205 | *.rdl.data 206 | *.bim.layout 207 | *.bim_*.settings 208 | 209 | # Microsoft Fakes 210 | FakesAssemblies/ 211 | 212 | # GhostDoc plugin setting file 213 | *.GhostDoc.xml 214 | 215 | # Node.js Tools for Visual Studio 216 | .ntvs_analysis.dat 217 | 218 | # Visual Studio 6 build log 219 | *.plg 220 | 221 | # Visual Studio 6 workspace options file 222 | *.opt 223 | 224 | # Visual Studio LightSwitch build output 225 | **/*.HTMLClient/GeneratedArtifacts 226 | **/*.DesktopClient/GeneratedArtifacts 227 | **/*.DesktopClient/ModelManifest.xml 228 | **/*.Server/GeneratedArtifacts 229 | **/*.Server/ModelManifest.xml 230 | _Pvt_Extensions 231 | 232 | # Paket dependency manager 233 | .paket/paket.exe 234 | 235 | # FAKE - F# Make 236 | .fake/ 237 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/App_Start/Startup.Auth.cs: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. 3 | * See LICENSE in the source repository root for complete license information. 4 | */ 5 | 6 | using System.Web; 7 | using Owin; 8 | using Microsoft.Owin.Security; 9 | using Microsoft.Owin.Security.Cookies; 10 | using Microsoft.Owin.Security.OpenIdConnect; 11 | using System.Configuration; 12 | using System.Threading.Tasks; 13 | using Microsoft_Graph_REST_ASPNET_Connect.TokenStorage; 14 | using System.IdentityModel.Tokens; 15 | using System.IdentityModel.Claims; 16 | using Microsoft.Identity.Client; 17 | 18 | namespace Microsoft_Graph_REST_ASPNET_Connect 19 | { 20 | public partial class Startup 21 | { 22 | 23 | // The appId is used by the application to uniquely identify itself to Azure AD. 24 | // The appSecret is the application's password. 25 | // The redirectUri is where users are redirected after sign in and consent. 26 | // The graphScopes are the Microsoft Graph permission scopes that are used by this sample: User.Read Mail.Send 27 | private static string appId = ConfigurationManager.AppSettings["ida:AppId"]; 28 | private static string appSecret = ConfigurationManager.AppSettings["ida:AppSecret"]; 29 | private static string redirectUri = ConfigurationManager.AppSettings["ida:RedirectUri"]; 30 | private static string graphScopes = ConfigurationManager.AppSettings["ida:GraphScopes"]; 31 | 32 | public void ConfigureAuth(IAppBuilder app) 33 | { 34 | app.SetDefaultSignInAsAuthenticationType(CookieAuthenticationDefaults.AuthenticationType); 35 | 36 | app.UseCookieAuthentication(new CookieAuthenticationOptions()); 37 | 38 | app.UseOpenIdConnectAuthentication( 39 | new OpenIdConnectAuthenticationOptions 40 | { 41 | 42 | // The `Authority` represents the Microsoft v2.0 authentication and authorization service. 43 | // The `Scope` describes the permissions that your app will need. See https://azure.microsoft.com/documentation/articles/active-directory-v2-scopes/ 44 | ClientId = appId, 45 | Authority = "https://login.microsoftonline.com/common/v2.0", 46 | PostLogoutRedirectUri = redirectUri, 47 | RedirectUri = redirectUri, 48 | Scope = "openid email profile offline_access " + graphScopes, 49 | TokenValidationParameters = new TokenValidationParameters 50 | { 51 | ValidateIssuer = false, 52 | // In a real application you would use IssuerValidator for additional checks, 53 | // like making sure the user's organization has signed up for your app. 54 | // IssuerValidator = (issuer, token, tvp) => 55 | // { 56 | // if (MyCustomTenantValidation(issuer)) 57 | // return issuer; 58 | // else 59 | // throw new SecurityTokenInvalidIssuerException("Invalid issuer"); 60 | // }, 61 | }, 62 | Notifications = new OpenIdConnectAuthenticationNotifications 63 | { 64 | AuthorizationCodeReceived = async (context) => 65 | { 66 | var code = context.Code; 67 | string signedInUserID = context.AuthenticationTicket.Identity.FindFirst(ClaimTypes.NameIdentifier).Value; 68 | 69 | TokenCache userTokenCache = new SessionTokenCache(signedInUserID, 70 | context.OwinContext.Environment["System.Web.HttpContextBase"] as HttpContextBase).GetMsalCacheInstance(); 71 | ConfidentialClientApplication cca = new ConfidentialClientApplication( 72 | appId, 73 | redirectUri, 74 | new ClientCredential(appSecret), 75 | userTokenCache, 76 | null); 77 | string[] scopes = graphScopes.Split(new char[] { ' ' }); 78 | 79 | AuthenticationResult result = await cca.AcquireTokenByAuthorizationCodeAsync(code, scopes); 80 | }, 81 | AuthenticationFailed = (context) => 82 | { 83 | context.HandleResponse(); 84 | context.Response.Redirect("/Error?message=" + context.Exception.Message); 85 | return Task.FromResult(0); 86 | } 87 | } 88 | }); 89 | } 90 | } 91 | } -------------------------------------------------------------------------------- /README-Localized/README-ja-jp.md: -------------------------------------------------------------------------------- 1 | # ASP.NET 4.6 用 Microsoft Graph Connect のサンプル 2 | 3 | ## 目次 4 | 5 | * [前提条件](#前提条件) 6 | * [アプリケーションの登録](#アプリケーションの登録) 7 | * [サンプルの構築と実行](#サンプルの構築と実行) 8 | * [ノートのコード](#ノートのコード) 9 | * [質問とコメント](#質問とコメント) 10 | * [投稿](#投稿) 11 | * [その他のリソース](#その他のリソース) 12 | 13 | このサンプルは、メールを送信するための Microsoft Graph API を使用して、Microsoft の職場または学校 (Azure Active Directory) アカウント、あるいは個人用 (Microsoft) アカウントに ASP.NET 4.6 MVC のWeb アプリを接続する方法を示します。 [Microsoft Graph .NET クライアント ライブラリ](https://github.com/microsoftgraph/msgraph-sdk-dotnet) を使用して、Microsoft Graph が返すデータを操作します。 14 | 15 | また、サンプルでは認証に [Microsoft 認証ライブラリ (MSAL)](https://www.nuget.org/packages/Microsoft.Identity.Client/) を使用します。 MSAL SDK には、[v2 認証エンドポイント](https://azure.microsoft.com/en-us/documentation/articles/active-directory-appmodel-v2-overview)を操作するための機能が用意されており、開発者は職場または学校 (Azure Active Directory) アカウント、および個人用 (Microsoft) アカウントの両方に対する認証を処理する 1 つのコード フローを記述することができます。 16 | 17 | > **注** 現在、MSAL SDK はプレリリース段階であるため、運用コードでは使用できません。 ここでは、例示目的のみに使用されています 18 | 19 | ## 前提条件 20 | 21 | このサンプルを実行するには次のものが必要です: 22 | 23 | * [Visual Studio 2015](https://www.visualstudio.com/en-us/downloads) 24 | * [Microsoft アカウント](https://www.outlook.com)または [Office 365 for Business アカウント](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account)。 Office 365 アプリのビルドを開始するために必要なリソースを含む、[Office 365 Developer サブスクリプション](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account)にサインアップできます。 25 | 26 | ## アプリケーションの登録 27 | 28 | 1. 個人用アカウント、あるいは職場または学校アカウントのいずれかを使用して、[アプリ登録ポータル](https://apps.dev.microsoft.com/)にサインインします。 29 | 30 | 2. **[アプリの追加]** を選択します。 31 | 32 | 3. アプリの名前を入力して、**[アプリケーションの作成]** を選択します。 33 | 34 | 登録ページが表示され、アプリのプロパティが一覧表示されます。 35 | 36 | 4. アプリケーション ID をコピーします。 これは、アプリの一意識別子です。 37 | 38 | 5. **[アプリケーション シークレット]** で、**[新しいパスワードを生成する]** を選択します。 **[新しいパスワードを生成する]** ダイアログからパスワードをコピーします。 39 | 40 | 次のセクションで、アプリケーションの ID とパスワードを使用してサンプル アプリを構成します。 41 | 42 | 6. **[プラットフォーム]** で、**[プラットフォームの追加]** を選択します。 43 | 44 | 7. **[Web]** を選択します。 45 | 46 | 8. **[暗黙的フローを許可する]** のチェック ボックスが選択されていることを確認して、リダイレクト URI として *https://localhost:44300/* を入力します。 47 | 48 | **[暗黙的フローを許可する]** オプションにより、ハイブリッド フローが有効になります。 認証時に、アクセス トークンを取得するためにアプリが使用できるサインイン情報 (id_token) と成果物 (この場合は、認証コード) の両方をアプリで受信できるようになります。 49 | 50 | 9. **[保存]** を選択します。 51 | 52 | ## サンプルの構築と実行 53 | 54 | 1. ASP.NET 4.6 用 Microsoft Graph Connect のサンプルをダウンロードするか、クローンを作成します。 55 | 56 | 2. Visual Studio でサンプル ソリューションを開きます。 57 | 58 | 3. ルート ディレクトリの Web.config ファイルで、**ida:AppId** と **ida:AppSecret** のプレースホルダ―の値をアプリの登録時にコピーしたアプリケーションの ID とパスワードと置き換えます。 59 | 60 | 4. F5 キーを押して、サンプルを構築して実行します。 これにより、NuGet パッケージの依存関係が復元され、アプリが開きます。 61 | 62 | >パッケージのインストール中にエラーが発生した場合は、ソリューションを保存したローカル パスが長すぎたり深すぎたりしていないかご確認ください。 ドライブのルート近くにソリューションを移動すると問題が解決します。 63 | 64 | 5. 個人用あるいは職場または学校アカウントでサインインし、要求されたアクセス許可を付与します。 65 | 66 | 6. **[メール アドレスの取得]** ボタンを選択します。 操作が完了すると、サインインしているユーザーのメール アドレスがページに表示されます。 67 | 68 | 7. 必要に応じて、受信者一覧とメールの件名を編集し、**[メールの送信]** ボタンを選択します。 メールが送信されると、ボタンの下に成功メッセージが表示されます。 69 | 70 | ## ノートのコード 71 | 72 | - [Startup.Auth.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/App_Start/Startup.Auth.cs). 現在のユーザーを認証して、サンプルのトークン キャッシュを初期化します。 73 | 74 | - [SessionTokenCache.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/TokenStorage/SessionTokenCache.cs). ユーザーのトークン情報を保存します。 これを独自のカスタム トークン キャッシュと置き換えることができます。 詳細については、「[マルチテナント アプリケーションのアクセス トークンのキャッシュ](https://azure.microsoft.com/en-us/documentation/articles/guidance-multitenant-identity-token-cache/)」を参照してください。 75 | 76 | - [SampleAuthProvider.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SampleAuthProvider.cs). ローカルの IAuthProvider インターフェイスを実装して、MSAL **AcquireTokenSilentAsync** メソッドを使用してアクセス トークンを取得します。 これを独自の認証プロバイダーと置き換えることができます。 77 | 78 | - [SDKHelper.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SDKHelper.cs). Microsoft Graph との対話に使用される [Microsoft Graph .NET クライアント ライブラリ](https://github.com/microsoftgraph/msgraph-sdk-dotnet)の **GraphServiceClient** を初期化します。 79 | 80 | - [HomeController.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Controllers/HomeController.cs). 呼び出しを構築して Microsoft Graph サービスに送信し、その応答を処理するために **GraphServiceClient** を使用するメソッドが含まれています。 81 | - **GetMyEmailAddress** アクションは、**mail** プロパティまたは **userPrincipalName** プロパティから現在のユーザーのメール アドレスを取得します。 82 | - **SendMail** アクションは、現在のユーザーに代わってメールを送信します。 83 | 84 | - [Graph.cshtml](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Views/Home/Graph.cshtml). サンプルの UI が含まれています。 85 | 86 | ## 質問とコメント 87 | 88 | このサンプルに関するフィードバックをお寄せください。 質問や提案につきましては、このリポジトリの「[問題](https://github.com/microsoftgraph/aspnet-connect-sample/issues)」セクションで送信できます。 89 | 90 | お客様からのフィードバックを重視しています。 [スタック オーバーフロー](http://stackoverflow.com/questions/tagged/microsoftgraph)でご連絡いただけます。 ご質問には [MicrosoftGraph] のタグを付けてください。 91 | 92 | ## 投稿 ## 93 | 94 | このサンプルに投稿する場合は、[CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。 95 | 96 | このプロジェクトでは、[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) が採用されています。詳細については、「[規範に関する FAQ](https://opensource.microsoft.com/codeofconduct/faq/)」を参照してください。または、その他の質問やコメントがあれば、[opencode@microsoft.com](mailto:opencode@microsoft.com) までにお問い合わせください。 97 | 98 | ## その他のリソース 99 | 100 | - [その他の Microsoft Graph Connect サンプル](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect) 101 | - [Microsoft Graph の概要](http://graph.microsoft.io) 102 | - [Office 開発者向けコード サンプル](http://dev.office.com/code-samples) 103 | - [Office デベロッパー センター](http://dev.office.com/) 104 | 105 | ## 著作権 106 | Copyright (c) 2016 Microsoft. All rights reserved. 107 | 108 | 109 | -------------------------------------------------------------------------------- /README-Localized/README-pt-br.md: -------------------------------------------------------------------------------- 1 | # Exemplo de conexão com o Microsoft Graph para ASP.NET 4.6 2 | 3 | ## Sumário 4 | 5 | * [Pré-requisitos](#pré-requisitos) 6 | * [Registrar o aplicativo](#registrar-o-aplicativo) 7 | * [Criar e executar o exemplo](#criar-e-executar-o-exemplo) 8 | * [Código da observação](#código-da-observação) 9 | * [Perguntas e comentários](#perguntas-e-comentários) 10 | * [Colaboração](#colaboração) 11 | * [Recursos adicionais](#recursos-adicionais) 12 | 13 | Este exemplo mostra como se conectar a um aplicativo Web do ASP.NET 4.6 MVC a uma conta comercial ou escolar (Azure Active Directory) da Microsoft ou uma conta pessoal (Microsoft) usando a API do Microsoft Graph API para enviar emails. O exemplo usa as [Biblioteca de Cliente do Microsoft Graph .NET](https://github.com/microsoftgraph/msgraph-sdk-dotnet) para trabalhar com dados retornados pelo Microsoft Graph. 14 | 15 | Além disso, o exemplo usa a [Biblioteca de Autenticação da Microsoft (MSAL)](https://www.nuget.org/packages/Microsoft.Identity.Client/) para autenticação. O SDK da MSAL fornece recursos para trabalhar com o [ponto de extremidade de autenticação v2](https://azure.microsoft.com/en-us/documentation/articles/active-directory-appmodel-v2-overview) que permite que os desenvolvedores gravem um único fluxo de código para tratar da autenticação de contas comerciais ou escolares (Azure Active Directory) e de contas pessoais (Microsoft). 16 | 17 | > **Observação** No momento, o SDK da MSAL encontra-se em pré-lançamento e como tal não deve ser usado no código de produção. Isso é usado apenas para fins ilustrativos 18 | 19 | ## Pré-requisitos 20 | 21 | Este exemplo requer o seguinte: 22 | 23 | * [Visual Studio 2015](https://www.visualstudio.com/en-us/downloads) 24 | * A [conta da Microsoft](https://www.outlook.com) ou a [conta do Office 365 para empresas](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account). Inscreva-se em uma [Assinatura do Office 365 para Desenvolvedor](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account) que inclua os recursos necessários para começar a criar aplicativos do Office 365. 25 | 26 | ## Registrar o aplicativo 27 | 28 | 1. Entre no [Portal de Registro do Aplicativo](https://apps.dev.microsoft.com/) usando sua conta pessoal ou sua conta comercial ou escolar. 29 | 30 | 2. Escolha **Adicionar um aplicativo**. 31 | 32 | 3. Insira um nome para o aplicativo e escolha **Criar aplicativo**. 33 | 34 | A página de registro é exibida, listando as propriedades do seu aplicativo. 35 | 36 | 4. Copie a ID do Aplicativo. Esse é o identificador exclusivo do aplicativo. 37 | 38 | 5. Em **Segredos do Aplicativo**, escolha **Gerar Nova Senha**. Copie a senha da caixa de diálogo **Nova senha gerada**. 39 | 40 | Você usará a ID do aplicativo e a senha para configurar o aplicativo de exemplo na próxima seção. 41 | 42 | 6. Em **Plataformas**, escolha **Adicionar plataforma**. 43 | 44 | 7. Escolha **Web**. 45 | 46 | 8. Verifique se a caixa de diálogo **Permitir Fluxo Implícito** está marcada e insira *https://localhost:44300/* como o URI de redirecionamento. 47 | 48 | A opção **Permitir Fluxo Implícito** habilita o fluxo híbrido. Durante a autenticação, isso permite que o aplicativo receba informações de entrada (o id_token) e artefatos (neste caso, um código de autorização) que o aplicativo pode usar para obter um token de acesso. 49 | 50 | 9. Escolha **Salvar**. 51 | 52 | ## Criar e executar o exemplo 53 | 54 | 1. Baixe ou clone o Exemplo de Conexão com o Microsoft Graph para ASP.NET 4.6. 55 | 56 | 2. Abra a solução de exemplo no Visual Studio. 57 | 58 | 3. No arquivo Web.config no diretório raiz, substitua os valores dos espaços reservados **ida:AppId** e **ida:AppSecret** pela ID de aplicativo e senha copiadas durante o registro do aplicativo. 59 | 60 | 4. Pressione F5 para criar e executar o exemplo. Isso restaurará dependências do pacote NuGet e abrirá o aplicativo. 61 | 62 | >Caso receba mensagens de erro durante a instalação de pacotes, verifique se o caminho para o local onde você colocou a solução não é muito longo ou extenso. Para resolver esse problema, coloque a solução junto à raiz da unidade. 63 | 64 | 5. Entre com sua conta pessoal ou sua conta comercial ou escolar e conceda as permissões solicitadas. 65 | 66 | 6. Escolha o botão **Obter endereço de email**. Quando a operação for concluída, o endereço de email do usuário conectado será exibido na página. 67 | 68 | 7. Como alternativa, edite a lista de destinatários e o assunto do email e, em seguida, escolha o botão **Enviar email**. Quando o email for enviado, será exibida uma mensagem de sucesso abaixo do botão. 69 | 70 | ## Código da observação 71 | 72 | - [Startup.Auth.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/App_Start/Startup.Auth.cs). Autentica o usuário atual e inicializa o cache de token do exemplo. 73 | 74 | - [SessionTokenCache.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/TokenStorage/SessionTokenCache.cs). Armazena as informações de token do usuário. Você pode substituir pelo seu próprio cache de token personalizado. Saiba mais em [Armazenamento de tokens de acesso em cache em um aplicativo de vários locatários](https://azure.microsoft.com/en-us/documentation/articles/guidance-multitenant-identity-token-cache/). 75 | 76 | - [SampleAuthProvider.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SampleAuthProvider.cs). Implementa a interface IAuthProvider local e obtém acesso a um token usando o método **AcquireTokenSilentAsync** da MSAL. Isso pode ser substituído pelo seu próprio provedor de autenticação. 77 | 78 | - [SDKHelper.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SDKHelper.cs). Inicializa o **GraphServiceClient** na [Biblioteca de Cliente do Microsoft Graph .NET](https://github.com/microsoftgraph/msgraph-sdk-dotnet) usada para interagir com o Microsoft Graph. 79 | 80 | - [HomeController.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Controllers/HomeController.cs). Contêm métodos que usam o **GraphServiceClient** para criar e enviar chamadas para o serviço do Microsoft Graph e processar a resposta. 81 | - A ação **GetMyEmailAddress** obtém o endereço de email do usuário atual das propriedade **mail** ou **userPrincipalName**. 82 | - A ação **SendMail** envia um email em nome do usuário atual. 83 | 84 | - [Graph.cshtml](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Views/Home/Graph.cshtml). Contém a interface de usuário do exemplo. 85 | 86 | ## Perguntas e comentários 87 | 88 | Gostaríamos de saber sua opinião sobre este exemplo. Você pode nos enviar suas perguntas e sugestões por meio da seção [Issues](https://github.com/microsoftgraph/aspnet-connect-sample/issues) deste repositório. 89 | 90 | Seus comentários são importantes para nós. Junte-se a nós na página [Stack Overflow](http://stackoverflow.com/questions/tagged/microsoftgraph). Marque suas perguntas com [MicrosoftGraph]. 91 | 92 | ## Colaboração ## 93 | 94 | Se quiser contribuir para esse exemplo, confira [CONTRIBUTING.md](CONTRIBUTING.md). 95 | 96 | Este projeto adotou o [Código de Conduta do Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/). Para saber mais, confira as [Perguntas frequentes do Código de Conduta](https://opensource.microsoft.com/codeofconduct/faq/) ou contate [opencode@microsoft.com](mailto:opencode@microsoft.com) se tiver outras dúvidas ou comentários. 97 | 98 | ## Recursos adicionais 99 | 100 | - [Outros exemplos de conexão usando o Microsoft Graph](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect) 101 | - [Visão geral do Microsoft Graph](http://graph.microsoft.io) 102 | - [Exemplos de código para desenvolvedores do Office](http://dev.office.com/code-samples) 103 | - [Centro de desenvolvimento do Office](http://dev.office.com/) 104 | 105 | ## Direitos autorais 106 | Copyright © 2016 Microsoft. Todos os direitos reservados. 107 | 108 | 109 | -------------------------------------------------------------------------------- /README-Localized/README-ru-ru.md: -------------------------------------------------------------------------------- 1 | # Пример приложения, подключающегося с использованием Microsoft Graph, для ASP.NET 4.6 2 | 3 | ## Содержание 4 | 5 | * [Необходимые компоненты](#Необходимые-компоненты) 6 | * [Регистрация приложения](#Регистрация-приложения) 7 | * [Сборка и запуск примера](#Сборка-и-запуск-примера) 8 | * [Полезный код](#Полезный-код) 9 | * [Вопросы и комментарии](#Вопросы-и-комментарии) 10 | * [Участие](#Участие) 11 | * [Дополнительные ресурсы](#Дополнительные-ресурсы) 12 | 13 | В этом примере показано, как подключить веб-приложение ASP.NET 4.6 MVC к рабочей или учебной (Azure Active Directory) либо личной учетной записи Майкрософт с помощью API Microsoft Graph для отправки электронной почты. Для работы с данными, возвращаемыми Microsoft Graph, используется [клиентская библиотека Microsoft Graph .NET](https://github.com/microsoftgraph/msgraph-sdk-dotnet). 14 | 15 | Кроме того, для проверки подлинности в этом примере используется [Microsoft Authentication Library (MSAL)](https://www.nuget.org/packages/Microsoft.Identity.Client/). Пакет SDK MSAL предоставляет функции для работы с [конечной точкой проверки подлинности версии 2](https://azure.microsoft.com/en-us/documentation/articles/active-directory-appmodel-v2-overview), которая позволяет разработчикам создать один блок кода для проверки подлинности как рабочих или учебных (Azure Active Directory), так и личных учетных записей (Майкрософт). 16 | 17 | > **Примечание**. Сейчас доступна предварительная версия пакета SDK MSAL, поэтому его не следует использовать в рабочем коде. Он используется здесь только в демонстрационных целях. 18 | 19 | ## Необходимые компоненты 20 | 21 | Для этого примера требуются следующие компоненты: 22 | 23 | * [Visual Studio 2015;](https://www.visualstudio.com/en-us/downloads) 24 | * [учетная запись Майкрософт](https://www.outlook.com) или [учетная запись Office 365 для бизнеса](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account). Вы можете [подписаться на план Office 365 для разработчиков](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account), который включает ресурсы, необходимые для создания приложений Office 365. 25 | 26 | ## Регистрация приложения 27 | 28 | 1. Войдите на [портал регистрации приложений](https://apps.dev.microsoft.com/) с помощью личной, рабочей или учебной учетной записи. 29 | 30 | 2. Нажмите кнопку **Добавить приложение**. 31 | 32 | 3. Введите имя приложения и нажмите кнопку **Создать приложение**. 33 | 34 | Откроется страница регистрации со свойствами приложения. 35 | 36 | 4. Скопируйте идентификатор приложения. Это уникальный идентификатор приложения. 37 | 38 | 5. В разделе **Секреты приложения** нажмите кнопку **Создать новый пароль**. Скопируйте пароль из диалогового окна **Новый пароль создан**. 39 | 40 | Идентификатор приложения и пароль будут использованы для настройки примера приложения в следующем разделе. 41 | 42 | 6. В разделе **Платформы** выберите элемент **Добавление платформы**. 43 | 44 | 7. Выберите пункт **Веб**. 45 | 46 | 8. Убедитесь, что установлен флажок **Разрешить неявный поток**, и введите универсальный код ресурса (URI) перенаправления *https://localhost:44300/*. 47 | 48 | Параметр **Разрешить неявный поток** включает гибридный поток. Благодаря этому при проверке подлинности приложение может получить данные для входа (id_token) и артефакты (в данном случае — код авторизации), которые оно может использовать, чтобы получить маркер доступа. 49 | 50 | 9. Нажмите кнопку **Сохранить**. 51 | 52 | ## Сборка и запуск примера 53 | 54 | 1. Скачайте или клонируйте пример приложения, подключающегося с использованием Microsoft Graph, для ASP.NET 4.6. 55 | 56 | 2. Откройте пример решения в Visual Studio. 57 | 58 | 3. В корневом каталоге в файле Web.config замените заполнители **ida:AppId** и **ida:AppSecret** на идентификатор приложения и пароль, которые вы скопировали при регистрации приложения. 59 | 60 | 4. Нажмите клавишу F5 для сборки и запуска примера. При этом будут восстановлены зависимости пакета NuGet и откроется приложение. 61 | 62 | >Если при установке пакетов возникают ошибки, убедитесь, что локальный путь к решению не слишком длинный. Чтобы устранить эту проблему, переместите решение ближе к корню диска. 63 | 64 | 5. Войдите с помощью личной, рабочей или учебной учетной записи и предоставьте необходимые разрешения. 65 | 66 | 6. Нажмите кнопку **Получить адрес электронной почты**. После завершения операции на странице отобразится адрес электронной почты пользователя, который вошел в систему. 67 | 68 | 7. При необходимости измените список получателей и тему сообщения электронной почты, а затем нажмите кнопку **Отправить сообщение**. Под кнопкой отобразится сообщение об успешной отправке почты. 69 | 70 | ## Полезный код 71 | 72 | - [Startup.Auth.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/App_Start/Startup.Auth.cs). Проверяет подлинность текущего пользователя и инициализирует кэш маркеров примера. 73 | 74 | - [SessionTokenCache.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/TokenStorage/SessionTokenCache.cs). Хранит информацию о маркере пользователя. Вы можете заменить его на собственный кэш маркеров. Дополнительные сведения см. в статье [Кэширование маркеров доступа в мультитенантном приложении](https://azure.microsoft.com/en-us/documentation/articles/guidance-multitenant-identity-token-cache/). 75 | 76 | - [SampleAuthProvider.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SampleAuthProvider.cs). Реализует локальный интерфейс IAuthProvider и получает маркер доступа с помощью метода MSAL **AcquireTokenSilentAsync**. Вы можете заменить его на собственного поставщика проверки подлинности. 77 | 78 | - [SDKHelper.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SDKHelper.cs). Инициализирует класс **GraphServiceClient** из [клиентской библиотеки .NET Microsoft Graph](https://github.com/microsoftgraph/msgraph-sdk-dotnet), используемой для взаимодействия с Microsoft Graph. 79 | 80 | - [HomeController.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Controllers/HomeController.cs). Содержит методы, которые используют класс **GraphServiceClient** для создания и отправки вызовов в службу Microsoft Graph и обработки ответа. 81 | - Действие **GetMyEmailAddress** позволяет получить адрес электронной почты текущего пользователя из свойства **mail** или **userPrincipalName**. 82 | - Действие **SendMail** позволяет отправить сообщение электронной почты от имени текущего пользователя. 83 | 84 | - [Graph.cshtml](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Views/Home/Graph.cshtml). Содержит пользовательский интерфейс образца. 85 | 86 | ## Вопросы и комментарии 87 | 88 | Мы будем рады узнать ваше мнение об этом примере. Вы можете отправлять нам свои вопросы и предложения на вкладке [Issues](https://github.com/microsoftgraph/aspnet-connect-sample/issues) (Проблемы) этого репозитория. 89 | 90 | Ваше мнение важно для нас. Для связи с нами используйте сайт [Stack Overflow](http://stackoverflow.com/questions/tagged/microsoftgraph). Помечайте свои вопросы тегом [MicrosoftGraph]. 91 | 92 | ## Участие ## 93 | 94 | Если вы хотите добавить код в этот пример, просмотрите статью [CONTRIBUTING.md](CONTRIBUTING.md). 95 | 96 | Этот проект соответствует [правилам поведения Майкрософт, касающимся обращения с открытым кодом](https://opensource.microsoft.com/codeofconduct/). Читайте дополнительные сведения в [разделе вопросов и ответов по правилам поведения](https://opensource.microsoft.com/codeofconduct/faq/) или отправляйте новые вопросы и замечания по адресу [opencode@microsoft.com](mailto:opencode@microsoft.com). 97 | 98 | ## Дополнительные ресурсы 99 | 100 | - [Другие примеры приложений, подключающихся с использованием Microsoft Graph](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect) 101 | - [Общие сведения о Microsoft Graph](http://graph.microsoft.io) 102 | - [Примеры кода решений для Office](http://dev.office.com/code-samples) 103 | - [Центр разработки для Office](http://dev.office.com/) 104 | 105 | ## Авторское право 106 | (c) Корпорация Майкрософт (Microsoft Corporation), 2016. Все права защищены. 107 | 108 | 109 | -------------------------------------------------------------------------------- /README-Localized/README-es-es.md: -------------------------------------------------------------------------------- 1 | # Ejemplo Connect de Microsoft Graph para ASP.NET 4.6 2 | 3 | ## Tabla de contenido 4 | 5 | * [Requisitos previos](#requisitos-previos) 6 | * [Registrar la aplicación](#registrar-la-aplicación) 7 | * [Compilar y ejecutar el ejemplo](#compilar-y-ejecutar-el-ejemplo) 8 | * [Código de nota](#código-de-nota) 9 | * [Preguntas y comentarios](#preguntas-y-comentarios) 10 | * [Colaboradores](#colaboradores) 11 | * [Recursos adicionales](#recursos-adicionales) 12 | 13 | Este ejemplo muestra cómo conectar una aplicación web ASP.NET 4.6 MVC a una cuenta profesional o educativa de Microsoft (Azure Active Directory) o a una cuenta personal (Microsoft) usando la API de Microsoft Graph para enviar un correo electrónico. Usa la [biblioteca del cliente de Microsoft Graph .NET](https://github.com/microsoftgraph/msgraph-sdk-dotnet) para trabajar con los datos devueltos por Microsoft Graph. 14 | 15 | Además, el ejemplo usa la [biblioteca de autenticación de Microsoft (MSAL)](https://www.nuget.org/packages/Microsoft.Identity.Client/) para la autenticación. El SDK de MSAL ofrece características para trabajar con el [punto de conexión de autenticación v2.0](https://azure.microsoft.com/en-us/documentation/articles/active-directory-appmodel-v2-overview), lo que permite a los desarrolladores escribir un flujo de código único que controla la autenticación para las cuentas profesionales, educativas (Azure Active Directory) o las cuentas personales (Microsoft). 16 | 17 | > **Nota** El SDK de MSAL está actualmente en versión preliminar y, por tanto, no debe usarse en código de producción. Se usa aquí únicamente con fines ilustrativos. 18 | 19 | ## Requisitos previos 20 | 21 | Este ejemplo necesita lo siguiente: 22 | 23 | * [Visual Studio 2015](https://www.visualstudio.com/en-us/downloads) 24 | * Ya sea una [cuenta de Microsoft](https://www.outlook.com) u [Office 365 para una cuenta empresarial](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account) Puede registrarse para [una suscripción a Office 365 Developer](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account), que incluye los recursos que necesita para comenzar a crear aplicaciones de Office 365. 25 | 26 | ## Registrar la aplicación 27 | 28 | 1. Inicie sesión en el [Portal de registro de la aplicación](https://apps.dev.microsoft.com/) mediante su cuenta personal, profesional o educativa. 29 | 30 | 2. Seleccione **Agregar una aplicación**. 31 | 32 | 3. Escriba un nombre para la aplicación y seleccione **Crear aplicación**. 33 | 34 | Se muestra la página de registro, indicando las propiedades de la aplicación. 35 | 36 | 4. Copie el Id. de aplicación. Se trata del identificador único para su aplicación. 37 | 38 | 5. En **Secretos de aplicación**, seleccione **Generar nueva contraseña**. Copie la contraseña del cuadro de diálogo de **Nueva contraseña generada**. 39 | 40 | Usará el Id. de la aplicación y la contraseña para configurar la aplicación de ejemplo en la sección siguiente. 41 | 42 | 6. En **Plataformas**, seleccione **Agregar plataforma**. 43 | 44 | 7. Seleccione **Web**. 45 | 46 | 8. Asegúrese de que la casilla **Permitir flujo implícita** está activada e introduzca *https://localhost:44300 /* como el URI de redirección. 47 | 48 | La opción **Permitir flujo implícito** permite el flujo híbrido. Durante la autenticación, esto permite que la aplicación reciba la información de inicio de sesión (id_token) y artefactos (en este caso, un código de autorización) que la aplicación puede usar para obtener un token de acceso. 49 | 50 | 9. Seleccione **Guardar**. 51 | 52 | ## Compilar y ejecutar el ejemplo 53 | 54 | 1. Descargue o clone el ejemplo de Microsoft Graph Connect para ASP.NET 4.6 55 | 56 | 2. Abra la solución del ejemplo en Visual Studio. 57 | 58 | 3. En el archivo Web.config en el directorio raíz, reemplace los valores de los marcadores de posición **ida:AppId** e **ida:AppSecret** por los valores que ha copiado durante el registro de la aplicación. 59 | 60 | 4. Pulse F5 para compilar y ejecutar el ejemplo. Esto restaurará las dependencias de paquetes de NuGet y abrirá la aplicación. 61 | 62 | >Si observa algún error durante la instalación de los paquetes, asegúrese de que la ruta de acceso local donde colocó la solución no es demasiado larga o profunda. Para resolver este problema, mueva la solución más cerca de la raíz de la unidad. 63 | 64 | 5. Inicie sesión con su cuenta personal, profesional o educativa y conceda los permisos solicitados. 65 | 66 | 6. Seleccione el botón **Obtener la dirección de correo electrónico**. Cuando finaliza la operación, la dirección de correo electrónico del usuario con sesión iniciada se muestra en la página. 67 | 68 | 7. De forma opcional, modifique la lista de destinatarios y el asunto del correo electrónico y, después, seleccione el botón **Enviar correo electrónico**. Cuando se envía el correo, se muestra un mensaje de Operación correcta debajo del botón. 69 | 70 | ## Código de nota 71 | 72 | - [Startup.Auth.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/App_Start/Startup.Auth.cs). Autentica al usuario actual e inicializa la memoria caché de token del ejemplo. 73 | 74 | - [SessionTokenCache.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/TokenStorage/SessionTokenCache.cs). Almacena información de token del usuario. Se puede reemplazar por su memoria caché de token personalizada. Más información en [Almacenamiento en la memoria caché de los tokens de acceso en una aplicación de varios inquilinos](https://azure.microsoft.com/en-us/documentation/articles/guidance-multitenant-identity-token-cache/). 75 | 76 | - [SampleAuthProvider.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SampleAuthProvider.cs). Implementa la interfaz local de IAuthProvider, y obtiene un token de acceso usando el método **AcquireTokenSilentAsync** de MSAL. Se puede reemplazar por su propio proveedor de autenticación. 77 | 78 | - [SDKHelper.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SDKHelper.cs). Inicializa **GraphServiceClient** de la [biblioteca de cliente de Microsoft Graph .NET](https://github.com/microsoftgraph/msgraph-sdk-dotnet) que se usa para interactuar con Microsoft Graph. 79 | 80 | - [HomeController.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Controllers/HomeController.cs). Contiene métodos que usan **GraphServiceClient** para crear y enviar llamadas al servicio Microsoft Graph y procesar la respuesta. 81 | - La acción **GetMyEmailAddress** obtiene la dirección de correo electrónico del usuario actual de la propiedad **mail** o **userPrincipalName**. 82 | - La acción **SendMail** envía un correo electrónico en nombre del usuario actual. 83 | 84 | - [Graph.cshtml](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Views/Home/Graph.cshtml). Contiene la interfaz de usuario de ejemplo. 85 | 86 | ## Preguntas y comentarios 87 | 88 | Nos encantaría recibir sus comentarios acerca de este ejemplo. Puede enviarnos sus preguntas y sugerencias a través de la sección [Problemas](https://github.com/microsoftgraph/aspnet-connect-sample/issues) de este repositorio. 89 | 90 | Sus comentarios son importantes para nosotros. Conecte con nosotros en [Desbordamiento de pila](http://stackoverflow.com/questions/tagged/microsoftgraph). Etiquete sus preguntas con [MicrosoftGraph]. 91 | 92 | ## Colaboradores ## 93 | 94 | Si le gustaría contribuir a este ejemplo, consulte [CONTRIBUTING.md](CONTRIBUTING.md). 95 | 96 | Este proyecto ha adoptado el [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) (Código de conducta de código abierto de Microsoft). Para obtener más información, consulte las [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) (Preguntas más frecuentes del código de conducta) o póngase en contacto con [opencode@microsoft.com](mailto:opencode@microsoft.com) con otras preguntas o comentarios. 97 | 98 | ## Recursos adicionales 99 | 100 | - [Otros ejemplos de Connect de Microsoft Graph](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect) 101 | - [Información general de Microsoft Graph](http://graph.microsoft.io) 102 | - [Ejemplos de código de Office Developer](http://dev.office.com/code-samples) 103 | - [Centro para desarrolladores de Office](http://dev.office.com/) 104 | 105 | ## Copyright 106 | Copyright (c) 2016 Microsoft. Todos los derechos reservados. 107 | 108 | 109 | -------------------------------------------------------------------------------- /README-Localized/README-fr-fr.md: -------------------------------------------------------------------------------- 1 | # Exemple de connexion de Microsoft Graph pour ASP.NET 4.6 2 | 3 | ## Sommaire 4 | 5 | * [Conditions préalables](#conditions-préalables) 6 | * [Inscription de l’application](#inscription-de-lapplication) 7 | * [Création et exécution de l’exemple](#création-et-exécution-de-lexemple) 8 | * [Code de note](#code-de-note) 9 | * [Questions et commentaires](#questions-et-commentaires) 10 | * [Contribution](#contribution) 11 | * [Ressources supplémentaires](#ressources-supplémentaires) 12 | 13 | Cet exemple montre comment connecter une application web ASP.NET 4.6 MVC à un compte professionnel ou scolaire (Azure Active Directory) ou personnel (Microsoft) à l’aide de l’API Microsoft Graph pour envoyer un e-mail. Il utilise la [bibliothèque Microsoft Graph .NET](https://github.com/microsoftgraph/msgraph-sdk-dotnet) pour exploiter les données renvoyées par Microsoft Graph. 14 | 15 | En outre, l’exemple utilise la [bibliothèque d’authentification Microsoft (MSAL)](https://www.nuget.org/packages/Microsoft.Identity.Client/) pour l’authentification. Le kit de développement logiciel MSAL offre des fonctionnalités permettant d’utiliser le [point de terminaison d’authentification v2](https://azure.microsoft.com/en-us/documentation/articles/active-directory-appmodel-v2-overview), qui permet aux développeurs d’écrire un flux de code unique qui gère l’authentification des comptes professionnels ou scolaires (Azure Active Directory) et personnels (Microsoft). 16 | 17 | > **Remarque** Le kit de développement logiciel MSAL se trouve actuellement dans la version préliminaire et en tant que tel il ne doit pas être utilisé dans le code de production. Il est utilisé ici à titre indicatif uniquement. 18 | 19 | ## Conditions préalables 20 | 21 | Cet exemple nécessite les éléments suivants : 22 | 23 | * [Visual Studio 2015](https://www.visualstudio.com/en-us/downloads) 24 | * Soit un [compte Microsoft](https://www.outlook.com), soit un [compte Office 365 pour entreprise](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account). Vous pouvez vous inscrire à [Office 365 Developer](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account) pour accéder aux ressources dont vous avez besoin pour commencer à créer des applications Office 365. 25 | 26 | ## Inscription de l’application 27 | 28 | 1. Connectez-vous au [portail d’inscription des applications](https://apps.dev.microsoft.com/) en utilisant votre compte personnel, professionnel ou scolaire. 29 | 30 | 2. Choisissez **Ajouter une application**. 31 | 32 | 3. Entrez un nom pour l’application, puis choisissez **Créer une application**. 33 | 34 | La page d’inscription s’affiche, répertoriant les propriétés de votre application. 35 | 36 | 4. Copiez l’ID de l’application. Il s’agit de l’identificateur unique de votre application. 37 | 38 | 5. Sous **Secrets de l'application**, choisissez **Générer un nouveau mot de passe**. Copiez le mot de passe à partir de la boîte de dialogue **Nouveau mot de passe créé**. 39 | 40 | Vous utiliserez l’ID de l’application et le mot de passe pour configurer l’exemple d’application dans la section suivante. 41 | 42 | 6. Sous **Plateformes**, choisissez **Ajouter une plateforme**. 43 | 44 | 7. Choisissez **Web**. 45 | 46 | 8. Assurez-vous que la case à cocher **Autoriser un flux implicite** est activée, puis entrez *https://localhost:44300/* comme URI de redirection. 47 | 48 | L’option **Autoriser le flux implicite** active le flux hybride. Lors de l’authentification, cela permet à l’application de recevoir les informations de connexion (id_token) et les artefacts (dans ce cas, un code d’autorisation) qui servent à obtenir un jeton d’accès. 49 | 50 | 9. Cliquez sur **Enregistrer**. 51 | 52 | ## Création et exécution de l’exemple 53 | 54 | 1. Téléchargez ou clonez l’exemple de connexion Microsoft Graph pour ASP.NET 4.6. 55 | 56 | 2. Ouvrez l’exemple de solution dans Visual Studio. 57 | 58 | 3. Dans le fichier Web.config dans le répertoire racine, remplacez les valeurs d’espace réservé **ida:AppId** et **ida:AppSecret** par l’ID de l’application et le mot de passe que vous avez copiés lors de l’inscription de l’application. 59 | 60 | 4. Appuyez sur F5 pour créer et exécuter l’exemple. Cela entraîne la restauration des dépendances du package NuGet et l’ouverture de l’application. 61 | 62 | >Si vous constatez des erreurs pendant l’installation des packages, vérifiez que le chemin d’accès local où vous avez sauvegardé la solution n’est pas trop long/profond. Pour résoudre ce problème, il vous suffit de déplacer la solution dans un dossier plus près du répertoire racine de votre lecteur. 63 | 64 | 5. Connectez-vous à votre compte personnel, professionnel ou scolaire et accordez les autorisations demandées. 65 | 66 | 6. Choisissez le bouton **Obtenir l’adresse de messagerie**. Une fois l’opération terminée, l’adresse de messagerie de l’utilisateur connecté s’affiche dans la page. 67 | 68 | 7. Vous pouvez également modifier la liste des destinataires et l’objet de l’e-mail, puis cliquer sur le bouton **Envoyer un message électronique**. Lorsque le message est envoyé, un message de réussite s’affiche sous le bouton. 69 | 70 | ## Code de note 71 | 72 | - [Startup.Auth.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/App_Start/Startup.Auth.cs). Authentifie l’utilisateur actuel et initialise le cache de jetons de l’exemple. 73 | 74 | - [SessionTokenCache.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/TokenStorage/SessionTokenCache.cs). Stocke les informations du jeton de l’utilisateur. Vous pouvez le remplacer par votre propre cache de jetons personnalisé. Pour plus d’informations, voir [Mise en cache des jetons d’accès dans une application mutualisée](https://azure.microsoft.com/en-us/documentation/articles/guidance-multitenant-identity-token-cache/). 75 | 76 | - [SampleAuthProvider.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SampleAuthProvider.cs). Implémente l’interface IAuthProvider locale et obtient un jeton d’accès à l’aide de la méthode MSAL **AcquireTokenSilentAsync**. Vous pouvez utiliser, à la place, votre propre fournisseur d’authentification. 77 | 78 | - [SDKHelper.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SDKHelper.cs). Initialise **GraphServiceClient** à partir de la [bibliothèque client Microsoft Graph .NET](https://github.com/microsoftgraph/msgraph-sdk-dotnet) qui sert à interagir avec Microsoft Graph. 79 | 80 | - [HomeController.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Controllers/HomeController.cs). Contient des méthodes qui utilisent **GraphServiceClient** pour créer et envoyer les appels au service Microsoft Graph et traiter la réponse. 81 | - L’action **GetMyEmailAddress** permet d’obtenir l’adresse de messagerie de l’utilisateur actuel à partir de la propriété **mail** ou **userPrincipalName**. 82 | - L’action **SendMail** envoie un message électronique au nom de l’utilisateur actuel. 83 | 84 | - [Graph.cshtml](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Views/Home/Graph.cshtml). Contient l’interface utilisateur de l’exemple. 85 | 86 | ## Questions et commentaires 87 | 88 | Nous serions ravis de connaître votre opinion sur cet exemple. Vous pouvez nous faire part de vos questions et suggestions dans la rubrique [Problèmes](https://github.com/microsoftgraph/aspnet-connect-sample/issues) de ce référentiel. 89 | 90 | Votre avis compte beaucoup pour nous. Communiquez avec nous sur [Stack Overflow](http://stackoverflow.com/questions/tagged/microsoftgraph). Posez vos questions avec la balise [MicrosoftGraph]. 91 | 92 | ## Contribution ## 93 | 94 | Si vous souhaitez contribuer à cet exemple, voir [CONTRIBUTING.MD](CONTRIBUTING.md). 95 | 96 | Ce projet a adopté le [code de conduite Microsoft Open Source](https://opensource.microsoft.com/codeofconduct/). Pour plus d’informations, reportez-vous à la [FAQ relative au code de conduite](https://opensource.microsoft.com/codeofconduct/faq/) ou contactez [opencode@microsoft.com](mailto:opencode@microsoft.com) pour toute question ou tout commentaire. 97 | 98 | ## Ressources supplémentaires 99 | 100 | - [Autres exemples de connexion avec Microsoft Graph](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect) 101 | - [Présentation de Microsoft Graph](http://graph.microsoft.io) 102 | - [Exemples de code du développeur Office](http://dev.office.com/code-samples) 103 | - [Centre de développement Office](http://dev.office.com/) 104 | 105 | ## Copyright 106 | Copyright (c) 2016 Microsoft. Tous droits réservés. 107 | 108 | 109 | -------------------------------------------------------------------------------- /README-Localized/README-de-de.md: -------------------------------------------------------------------------------- 1 | # Microsoft Graph Connect-Beispiel für ASP.NET 4.6 2 | 3 | ## Inhalt 4 | 5 | * [Anforderungen](#anforderungen) 6 | * [Registrieren der App](#registrieren-der-app) 7 | * [Erstellen und Ausführen des Beispiels](#erstellen-und-ausführen-des-beispiels) 8 | * [Relevanter Code](#relevanter-code) 9 | * [Fragen und Kommentare](#fragen-und-kommentare) 10 | * [Mitwirkung](#mitwirkung) 11 | * [Weitere Ressourcen](#weitere-ressourcen) 12 | 13 | In diesem Beispiel wird gezeigt, wie eine 4.6 ASP.NET-MVC-Web-App mit einem Microsoft-Geschäfts- oder Schulkonto (Azure Active Directory) oder mit einem persönlichen Konto (Microsoft) mithilfe der Microsoft Graph-API zum Senden einer E-Mail verbunden wird. Es verwendet die [Microsoft Graph .NET-Clientbibliothek](https://github.com/microsoftgraph/msgraph-sdk-dotnet), um mit Daten zu arbeiten, die von Microsoft Graph zurückgegeben werden. 14 | 15 | Das Beispiel verwendet außerdem die [Microsoft-Authentifizierungsbibliothek (MSAL)](https://www.nuget.org/packages/Microsoft.Identity.Client/) für die Authentifizierung. Das MSAL-SDK bietet Features für die Arbeit mit dem [v2-Authentifizierungsendpunkt](https://azure.microsoft.com/en-us/documentation/articles/active-directory-appmodel-v2-overview), der es Entwicklern ermöglicht, einen einzelnen Codefluss zu schreiben, der die Authentifizierung sowohl für Geschäfts- oder Schulkonten (Azure Active Directory) als auch für persönliche Konten (Microsoft) verarbeitet. 16 | 17 | > **Hinweis** Das MSAL-SDK befindet sich derzeit in der Vorabversion und sollte daher nicht in Produktionscode verwendet werden. Es dient hier nur zur Veranschaulichung 18 | 19 | ## Anforderungen 20 | 21 | Für dieses Beispiel ist Folgendes erforderlich: 22 | 23 | * [Visual Studio 2015](https://www.visualstudio.com/en-us/downloads) 24 | * Entweder ein [Microsoft-Konto](https://www.outlook.com) oder ein [Office 365 for Business-Konto](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account). Sie können sich für ein [Office 365-Entwicklerabonnement](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_Office365Account) registrieren. Dieses umfasst die Ressourcen, die Sie zum Erstellen von Office 365-Apps benötigen. 25 | 26 | ## Registrieren der App 27 | 28 | 1. Melden Sie sich beim [App-Registrierungsportal](https://apps.dev.microsoft.com/) entweder mit Ihrem persönlichen oder geschäftlichen Konto oder mit Ihrem Schulkonto an. 29 | 30 | 2. Klicken Sie auf **App hinzufügen**. 31 | 32 | 3. Geben Sie einen Namen für die App ein, und wählen Sie **Anwendung erstellen** aus. 33 | 34 | Die Registrierungsseite wird angezeigt wird, und die Eigenschaften der App werden aufgeführt. 35 | 36 | 4. Kopieren Sie die Anwendungs-ID: Dies ist der eindeutige Bezeichner für Ihre App. 37 | 38 | 5. Wählen Sie unter **Anwendungsgeheimnisse** die Option **Neues Kennwort generieren** aus. Kopieren Sie das Kennwort aus dem Dialogfeld **Neues Kennwort wurde generiert**. 39 | 40 | Verwenden Sie die Anwendungs-ID und das Kennwort zur Konfiguration der Beispiel-App im nächsten Abschnitt. 41 | 42 | 6. Wählen Sie unter **Plattformen** die Option **Plattform hinzufügen** aus. 43 | 44 | 7. Wählen Sie **Web** aus. 45 | 46 | 8. Stellen Sie sicher, dass das Kontrollkästchen ** Impliziten Fluss zulassen** aktiviert ist, und geben Sie *https://localhost:44300 /* als Umleitungs-URI ein. 47 | 48 | Die Option **Impliziten Fluss zulassen** ermöglicht den Hybridfluss. Während der Authentifizierung ermöglicht dies der App, sowohl Anmeldeinformationen (das id_token) als auch Artefakte (in diesem Fall ein Autorisierungscode) abzurufen, den die App zum Abrufen eines Zugriffstokens verwenden kann. 49 | 50 | 9. Wählen Sie **Speichern** aus. 51 | 52 | ## Erstellen und Ausführen des Beispiels 53 | 54 | 1. Laden Sie das Microsoft Graph Connect-Beispiel für ASP.NET 4.6 herunter. 55 | 56 | 2. Öffnen Sie die Projektmappe in Visual Studio. 57 | 58 | 3. Ersetzen Sie in der Datei „Web.config“ im Stammverzeichnis die Platzhalterwerte **ida: AppId** und **ida: AppSecret** durch die Anwendungs-ID und das Kennwort, die bzw. das Sie während der App-Registrierung kopiert haben. 59 | 60 | 4. Drücken Sie zum Erstellen und Ausführen des Beispiels F5. Dadurch werden NuGet-Paketabhängigkeiten wiederhergestellt, und die App wird geöffnet. 61 | 62 | >Wenn beim Installieren der Pakete Fehler angezeigt werden, müssen Sie sicherstellen, dass der lokale Pfad, unter dem Sie die Projektmappe abgelegt haben, weder zu lang noch zu tief ist. Dieses Problem lässt sich beheben, indem Sie den Pfad auf Ihrem Laufwerk verkürzen. 63 | 64 | 5. Melden Sie sich mit Ihrem persönlichen Konto oder mit Ihrem Geschäfts- oder Schulkonto an, und gewähren Sie die erforderlichen Berechtigungen. 65 | 66 | 6. Klicken Sie auf die Schaltfläche **E-Mail-Adresse abrufen**. Wenn der Vorgang abgeschlossen ist, wird die E-Mail-Adresse des angemeldeten Benutzers auf der Seite angezeigt. 67 | 68 | 7. Optional können Sie die Empfängerliste und den Betreff der E-Mail bearbeiten. Klicken Sie dann auf die Schaltfläche **E-Mail senden**. Nachdem die E-Mail gesendet wurde, wird unter der Schaltfläche eine Erfolgsmeldung angezeigt. 69 | 70 | ## Relevanter Code 71 | 72 | - [Startup.Auth.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/App_Start/Startup.Auth.cs). Authentifiziert den aktuellen Benutzer und initialisiert den Tokencache des Beispiels. 73 | 74 | - [SessionTokenCache.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/TokenStorage/SessionTokenCache.cs). Speichert die Tokeninformationen des Benutzers. Sie können dies durch Ihren eigenen benutzerdefinierten Tokencache ersetzen. Weitere Informationen finden Sie unter [Zwischenspeichern von Zugriffstoken in einer Anwendung für mehrere Mandanten](https://azure.microsoft.com/en-us/documentation/articles/guidance-multitenant-identity-token-cache/). 75 | 76 | - [SampleAuthProvider.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SampleAuthProvider.cs). Implementiert die lokale IAuthProvider-Schnittstelle und ruft ein Zugriffstoken mithilfe der MSAL-Methode **AcquireTokenSilentAsync** ab. Sie können dies durch Ihren eigenen Authentifizierungsanbieter ersetzen. 77 | 78 | - [SDKHelper.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Helpers/SDKHelper.cs). Initialisiert den **GraphServiceClient** aus der [Microsoft Graph .NET-Clientbibliothek](https://github.com/microsoftgraph/msgraph-sdk-dotnet), die für die Interaktion mit dem Microsoft Graph verwendet wird. 79 | 80 | - [HomeController.cs](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Controllers/HomeController.cs). Enthält Methoden, die den **GraphServiceClient** zum Erstellen und Senden von Aufrufen des Microsoft Graph-Diensts und zum Verarbeiten der Antwort verwendet. 81 | - Die **GetMyEmailAddress**-Aktion ruft die E-Mail-Adresse des aktuellen Benutzers aus der **Mail**- oder der **userPrincipalName**-Eigenschaft ab. 82 | - Die **SendMail**-Aktion sendet eine E-Mail im Auftrag des aktuellen Benutzers. 83 | 84 | - [Graph.cshtml](/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Microsoft%20Graph%20SDK%20ASPNET%20Connect/Views/Home/Graph.cshtml). Enthält die Benutzeroberfläche des Beispiels. 85 | 86 | ## Fragen und Kommentare 87 | 88 | Wir schätzen Ihr Feedback hinsichtlich dieses Beispiels. Sie können uns Ihre Fragen und Vorschläge über den Abschnitt [Probleme](https://github.com/microsoftgraph/aspnet-connect-sample/issues) dieses Repositorys senden. 89 | 90 | Ihr Feedback ist uns wichtig. Nehmen Sie unter [Stack Overflow](http://stackoverflow.com/questions/tagged/microsoftgraph) Kontakt mit uns auf. Taggen Sie Ihre Fragen mit [MicrosoftGraph]. 91 | 92 | ## Mitwirkung ## 93 | 94 | Wenn Sie einen Beitrag zu diesem Beispiel leisten möchten, finden Sie unter [CONTRIBUTING.md](CONTRIBUTING.md) weitere Informationen. 95 | 96 | In diesem Projekt wurden die [Microsoft Open Source-Verhaltensregeln](https://opensource.microsoft.com/codeofconduct/) übernommen. Weitere Informationen finden Sie unter [Häufig gestellte Fragen zu Verhaltensregeln](https://opensource.microsoft.com/codeofconduct/faq/), oder richten Sie Ihre Fragen oder Kommentare an [opencode@microsoft.com](mailto:opencode@microsoft.com). 97 | 98 | ## Weitere Ressourcen 99 | 100 | - [Weitere Microsoft Graph Connect-Beispiele](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect) 101 | - [Microsoft Graph-Übersicht](http://graph.microsoft.io) 102 | - [Office-Entwicklercodebeispiele](http://dev.office.com/code-samples) 103 | - [Office Dev Center](http://dev.office.com/) 104 | 105 | ## Copyright 106 | Copyright (c) 2016 Microsoft. Alle Rechte vorbehalten. 107 | 108 | 109 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # [ARCHIVED] Microsoft Graph Connect Sample for ASP.NET 4.6 (REST) 2 | 3 | ## IMPORTANT 4 | 5 | **This project is being archived and replaced with the [Build MVC apps with the Microsoft Graph .NET SDK training](https://github.com/microsoftgraph/msgraph-training-aspnetmvcapp). As part of the archival process, we're closing all open issues and pull requests.** 6 | 7 | **You can continue to use this sample "as-is", but it won't be maintained moving forward. We apologize for any inconvenience.** 8 | 9 | ## Table of contents 10 | 11 | * [Introduction](#introduction) 12 | * [Prerequisites](#prerequisites) 13 | * [Register the application](#register-the-application) 14 | * [Build and run the sample](#build-and-run-the-sample) 15 | * [Deploy the sample to Azure](#deploy-the-sample-to-azure) 16 | * [Code of note](#code-of-note) 17 | * [Questions and comments](#questions-and-comments) 18 | * [Contributing](#contributing) 19 | * [Additional resources](#additional-resources) 20 | 21 | ## Introduction 22 | 23 | This sample shows how to connect an ASP.NET 4.6 MVC web app to a Microsoft work or school (Azure Active Directory) or personal (Microsoft) account using the Microsoft Graph API to retrieve a user's profile picture, upload the picture to OneDrive, and send an email that contains the photo as an attachment and the sharing link in its text. It uses REST calls to interact with the Microsoft Graph API. 24 | 25 | In addition, the sample uses the [Microsoft Authentication Library (MSAL)](https://www.nuget.org/packages/Microsoft.Identity.Client/) for authentication. The MSAL SDK provides features for working with the [Azure AD v2.0 endpoint](https://azure.microsoft.com/en-us/documentation/articles/active-directory-appmodel-v2-overview), which enables developers to write a single code flow that handles authentication for both work or school (Azure Active Directory) and personal (Microsoft) accounts. 26 | 27 | ## Important Note about the MSAL Preview 28 | 29 | This library is suitable for use in a production environment. We provide the same production level support for this library as we do our current production libraries. During the preview we may make changes to the API, internal cache format, and other mechanisms of this library, which you will be required to take along with bug fixes or feature improvements. This may impact your application. For instance, a change to the cache format may impact your users, such as requiring them to sign in again. An API change may require you to update your code. When we provide the General Availability release we will require you to update to the General Availability version within six months, as applications written using a preview version of library may no longer work. 30 | 31 | ## Prerequisites 32 | 33 | This sample requires the following: 34 | 35 | * [Visual Studio 2015](https://www.visualstudio.com/en-us/downloads) 36 | * Either a [Microsoft account](https://www.outlook.com) or [work or school account](https://dev.office.com/devprogram) 37 | 38 | ## Register the application 39 | 40 | 1. Sign into the [Application Registration Portal](https://apps.dev.microsoft.com/) using either your personal or work or school account. 41 | 42 | 2. Choose **Add an app**. 43 | 44 | 3. Enter a name for the app, and choose **Create application**. 45 | 46 | The registration page displays, listing the properties of your app. 47 | 48 | 4. Copy the Application Id. This is the unique identifier for your app. 49 | 50 | 5. Under **Application Secrets**, choose **Generate New Password**. Copy the password from the **New password generated** dialog. 51 | 52 | You'll use the application ID and password (secret) to configure the sample app in the next section. 53 | 54 | 6. Under **Platforms**, choose **Add Platform**. 55 | 56 | 7. Choose **Web**. 57 | 58 | 8. Make sure the **Allow Implicit Flow** check box is selected, and enter *http://localhost:55065/* as the Redirect URI. 59 | 60 | The **Allow Implicit Flow** option enables the hybrid flow. During authentication, this enables the app to receive both sign-in info (the id_token) and artifacts (in this case, an authorization code) that the app can use to obtain an access token. 61 | 62 | 9. Choose **Save**. 63 | 64 | ## Build and run the sample 65 | 66 | 1. Download or clone the Microsoft Graph Connect Sample for ASP.NET 4.6. 67 | 68 | 2. Open the sample solution in Visual Studio. 69 | 70 | 3. In the Web.config file in the root directory, replace the **ida:AppId** and **ida:AppSecret** placeholder values with the application ID and password that you copied during app registration. 71 | 72 | 4. Press F5 to build and run the sample. This will restore NuGet package dependencies and open the app. 73 | 74 | >If you see any errors while installing packages, make sure the local path where you placed the solution is not too long/deep. Moving the solution closer to the root of your drive resolves this issue. 75 | 76 | 5. Sign in with your personal or work or school account and grant the requested permissions. 77 | 78 | 6. Choose the **Get email address** button. When the operation completes, the email address of the signed-in user is displayed on the page. 79 | 80 | 7. Optionally edit the recipient list and email subject, and then choose the **Send email** button. When the mail is sent, a Success message is displayed below the button. 81 | 82 | 8. Next steps: Check out the [Microsoft Graph Snippets Sample for ASP.NET 4.6](https://github.com/microsoftgraph/aspnet-snippets-sample) to see examples of common Microsoft Graph operations. 83 | 84 | ## Deploy the sample to Azure 85 | 86 | If you have an Azure subscription, you can publish the sample app to an Azure website. These instructions assume you've already [registered the sample app](#register-the-application) in the Application Registration Portal. 87 | 88 | ### Create a web app (website) in the Azure Portal 89 | 90 | 1. Sign into the [Azure Portal](https://portal.azure.com) with your Azure credentials. 91 | 92 | 2. Choose **New > Web + Mobile > Web App**. 93 | 94 | 3. Give the website a unique name. Choose a resource group, and click **Create**. 95 | 96 | 4. Select the new web app in your list of resources. 97 | 98 | 5. Choose **Overview** in the left-hand pane, and then choose **Get publish profile** (or **More > Get publish profile**) from the menu above the web app's Essentials pane. 99 | 100 | 6. Save the profile locally. 101 | 102 | ### Publish the sample app from Visual Studio 103 | 104 | 1. In Visual Studio, open the sample app. Right-click the **Microsoft Graph REST ASPNET Connect** project node and choose **Publish**. 105 | 106 | 2. In the Publish dialog, choose **Import**, and choose the publish profile file you just downloaded. 107 | 108 | 3. On the Connection tab of the Publish dialog, change the *http* protocol to *https* in the Destination URL of your new web app. 109 | 110 | 4. Copy the Destination URL, and and then click **Publish**. Close the browser window that opens. 111 | 112 | 5. In the Web.config file, replace the **ida:RedirectUri** value to the Destination URL that you just copied. 113 | 114 | 6. Choose **View > Other Windows > Web Publish Activity**. 115 | 116 | 7. In the Web Publish Activity window, click the **Publish Web** button (looks like a globe) on the toolbar. This is how you can update the published project after you make changes. 117 | 118 | ### Update the redirect URI in the Application Registration Portal 119 | 120 | 1. In the [Application Registration Portal](https://apps.dev.microsoft.com), open the application that you registered for the sample (as described in [Register the application](#register-the-application)). 121 | 122 | 2. In the Web platform section, replace the *http://localhost:55065/* Redirect URI with the Destination URL of your new web app. (Alternatively, you can click **Add Url** and add the Destination URL.) 123 | 124 | 3. Click **Save**. 125 | 126 | The new Azure web app should now be ready to use. 127 | 128 | ## Code of note 129 | 130 | - [Startup.Auth.cs](/Microsoft%20Graph%20REST%20ASPNET%20Connect/Microsoft%20Graph%20REST%20ASPNET%20Connect/App_Start/Startup.Auth.cs). Authenticates the current user and initializes the sample's token cache. 131 | 132 | - [SessionTokenCache.cs](/Microsoft%20Graph%20REST%20ASPNET%20Connect/Microsoft%20Graph%20REST%20ASPNET%20Connect/TokenStorage/SessionTokenCache.cs). Stores the user's token information. You can replace this with your own custom token cache. Learn more in [Caching access tokens in a multitenant application](https://azure.microsoft.com/en-us/documentation/articles/guidance-multitenant-identity-token-cache/). 133 | 134 | - [SampleAuthProvider.cs](/Microsoft%20Graph%20REST%20ASPNET%20Connect/Microsoft%20Graph%20REST%20ASPNET%20Connect/Helpers/SampleAuthProvider.cs). Implements the local IAuthProvider interface, and gets an access token by using the MSAL **AcquireTokenSilentAsync** method. You can replace this with your own authentication provider. 135 | 136 | - [GraphService.cs](/Microsoft%20Graph%20REST%20ASPNET%20Connect/Microsoft%20Graph%20REST%20ASPNET%20Connect/Models/GraphService.cs). Contains methods (called by HomeController) that build and send REST calls to the Microsoft Graph API, and process the response. 137 | - The **GetMyEmailAddress** action gets the email address of the current user from the **mail** or **userPrincipalName** property. 138 | - The **SendMail** action sends an email on behalf of the current user. 139 | 140 | - [Graph.cshtml](/Microsoft%20Graph%20REST%20ASPNET%20Connect/Microsoft%20Graph%20REST%20ASPNET%20Connect/Views/Home/Graph.cshtml). Contains the sample's UI. 141 | 142 | ## Questions and comments 143 | 144 | We'd love to get your feedback about this sample. You can send us your questions and suggestions in the [Issues](https://github.com/microsoftgraph/aspnet-connect-rest-sample/issues) section of this repository. 145 | 146 | Your feedback is important to us. Connect with us on [Stack Overflow](https://stackoverflow.com/questions/tagged/microsoftgraph). Tag your questions with [MicrosoftGraph]. 147 | 148 | ## Contributing ## 149 | 150 | If you'd like to contribute to this sample, see [CONTRIBUTING.md](CONTRIBUTING.md). 151 | 152 | This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. 153 | 154 | ## Additional resources 155 | 156 | - [Other Microsoft Graph Connect samples](https://github.com/MicrosoftGraph?utf8=%E2%9C%93&query=-Connect) 157 | - [Microsoft Graph overview](https://graph.microsoft.io) 158 | 159 | ## Copyright 160 | Copyright (c) 2016 Microsoft. All rights reserved. 161 | 162 | 163 | 164 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Models/GraphService.cs: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. 3 | * See LICENSE in the source repository root for complete license information. 4 | */ 5 | 6 | using Newtonsoft.Json; 7 | using Newtonsoft.Json.Linq; 8 | using System; 9 | using System.Collections.Generic; 10 | using System.Net; 11 | using System.Net.Http; 12 | using System.Net.Http.Headers; 13 | using System.Text; 14 | using System.Threading.Tasks; 15 | using Resources; 16 | using System.IO; 17 | 18 | namespace Microsoft_Graph_REST_ASPNET_Connect.Models 19 | { 20 | 21 | // This sample shows how to: 22 | // - Get the current user's email address 23 | // - Get the current user's profile photo 24 | // - Attach the photo as a file attachment to an email message 25 | // - Upload the photo to the user's root drive 26 | // - Get a sharing link for the file and add it to the message 27 | // - Send the email 28 | public class GraphService 29 | { 30 | 31 | // Get the current user's email address from their profile. 32 | public async Task GetMyEmailAddress(string accessToken) 33 | { 34 | 35 | // Get the current user. 36 | // The app only needs the user's email address, so select the mail and userPrincipalName properties. 37 | // If the mail property isn't defined, userPrincipalName should map to the email for all account types. 38 | string endpoint = "https://graph.microsoft.com/v1.0/me"; 39 | string queryParameter = "?$select=mail,userPrincipalName"; 40 | UserInfo me = new UserInfo(); 41 | 42 | using (var client = new HttpClient()) 43 | { 44 | using (var request = new HttpRequestMessage(HttpMethod.Get, endpoint + queryParameter)) 45 | { 46 | request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json")); 47 | request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken); 48 | 49 | // This header has been added to identify our sample in the Microsoft Graph service. If extracting this code for your project please remove. 50 | request.Headers.Add("SampleID", "aspnet-connect-rest-sample"); 51 | 52 | using (var response = await client.SendAsync(request)) 53 | { 54 | if (response.IsSuccessStatusCode) 55 | { 56 | var json = JObject.Parse(await response.Content.ReadAsStringAsync()); 57 | me.Address = !string.IsNullOrEmpty(json.GetValue("mail").ToString()) ? json.GetValue("mail").ToString() : json.GetValue("userPrincipalName").ToString(); 58 | } 59 | return me.Address?.Trim(); 60 | } 61 | } 62 | } 63 | } 64 | 65 | // Get the current user's profile photo. 66 | public async Task GetMyProfilePhoto(string accessToken) 67 | { 68 | 69 | // Get the profile photo of the current user (from the user's mailbox on Exchange Online). 70 | // This operation in version 1.0 supports only a user's work or school mailboxes and not personal mailboxes. 71 | string endpoint = "https://graph.microsoft.com/v1.0/me/photo/$value"; 72 | 73 | using (var client = new HttpClient()) 74 | { 75 | using (var request = new HttpRequestMessage(HttpMethod.Get, endpoint)) 76 | { 77 | //request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json")); 78 | request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken); 79 | 80 | var response = await client.SendAsync(request); 81 | 82 | // If successful, Microsoft Graph returns a 200 OK status code and the photo's binary data. If no photo exists, returns 404 Not Found. 83 | if (response.IsSuccessStatusCode) 84 | { 85 | return await response.Content.ReadAsStreamAsync(); 86 | } 87 | else 88 | { 89 | // If no photo exists, the sample uses a local file. 90 | return File.OpenRead(System.Web.Hosting.HostingEnvironment.MapPath("/Content/test.jpg")); 91 | } 92 | } 93 | } 94 | } 95 | 96 | // Upload a file to OneDrive. 97 | // This call creates or updates the file. 98 | public async Task UploadFile(string accessToken, Stream file) 99 | { 100 | 101 | // This operation only supports files up to 4MB in size. 102 | // To upload larger files, see `https://developer.microsoft.com/graph/docs/api-reference/v1.0/api/item_createUploadSession`. 103 | string endpoint = "https://graph.microsoft.com/v1.0/me/drive/root/children/mypic.jpg/content"; 104 | 105 | using (var client = new HttpClient()) 106 | { 107 | using (var request = new HttpRequestMessage(HttpMethod.Put, endpoint)) 108 | { 109 | request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken); 110 | request.Content = new StreamContent(file); 111 | request.Content.Headers.ContentType = new MediaTypeHeaderValue("image/jpg"); 112 | using (var response = await client.SendAsync(request)) 113 | { 114 | if (response.IsSuccessStatusCode) 115 | { 116 | string stringResult = await response.Content.ReadAsStringAsync(); 117 | return JsonConvert.DeserializeObject(stringResult); 118 | } 119 | else return null; 120 | } 121 | } 122 | } 123 | } 124 | 125 | // Create a sharing link for the file if one doesn't already exist. 126 | // See `https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/item_createlink`. 127 | public async Task CreateSharingLinkForFile(string accessToken, FileInfo file) 128 | { 129 | string endpoint = $"https://graph.microsoft.com/v1.0/me/drive/items/{ file.Id }/createLink"; 130 | SharingLinkInfo link = new SharingLinkInfo("view"); 131 | 132 | using (var client = new HttpClient()) 133 | { 134 | using (var request = new HttpRequestMessage(HttpMethod.Post, endpoint)) 135 | { 136 | //request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json")); 137 | request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken); 138 | 139 | request.Content = new StringContent(JsonConvert.SerializeObject(link), Encoding.UTF8, "application/json"); 140 | using (var response = await client.SendAsync(request)) 141 | { 142 | if (response.IsSuccessStatusCode) 143 | { 144 | string stringResult = await response.Content.ReadAsStringAsync(); 145 | PermissionInfo permission = JsonConvert.DeserializeObject(stringResult); 146 | return permission.Link.WebUrl; 147 | } 148 | else return ""; 149 | } 150 | } 151 | } 152 | } 153 | 154 | // Send an email message from the current user. 155 | public async Task SendEmail(string accessToken, MessageRequest email) 156 | { 157 | string endpoint = "https://graph.microsoft.com/v1.0/me/sendMail"; 158 | 159 | using (var client = new HttpClient()) 160 | { 161 | using (var request = new HttpRequestMessage(HttpMethod.Post, endpoint)) 162 | { 163 | request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken); 164 | 165 | request.Content = new StringContent(JsonConvert.SerializeObject(email), Encoding.UTF8, "application/json"); 166 | using (var response = await client.SendAsync(request)) 167 | { 168 | if (response.IsSuccessStatusCode) 169 | { 170 | return Resource.Graph_SendMail_Success_Result; 171 | } 172 | return response.ReasonPhrase; 173 | } 174 | } 175 | } 176 | } 177 | 178 | // Create the email message. 179 | public async Task BuildEmailMessage(string accessToken, string recipients, string subject) 180 | { 181 | 182 | // Prepare the recipient list. 183 | string[] splitter = { ";" }; 184 | string[] splitRecipientsString = recipients.Split(splitter, StringSplitOptions.RemoveEmptyEntries); 185 | List recipientList = new List(); 186 | foreach (string recipient in splitRecipientsString) 187 | { 188 | recipientList.Add(new Recipient 189 | { 190 | EmailAddress = new UserInfo 191 | { 192 | Address = recipient.Trim() 193 | } 194 | }); 195 | } 196 | 197 | // Get the current user's profile photo (or a test image if no profile photo exists). 198 | using (Stream photo = await GetMyProfilePhoto(accessToken)) 199 | { 200 | // Add the photo as a file attachment for the email message. 201 | byte[] photoBytes = null; 202 | using (var memoryStream = new MemoryStream()) 203 | { 204 | photo?.CopyTo(memoryStream); 205 | photoBytes = memoryStream.ToArray(); 206 | } 207 | List attachments = new List(); 208 | attachments.Add(new Attachment 209 | { 210 | ODataType = "#microsoft.graph.fileAttachment", 211 | ContentBytes = photoBytes, 212 | Name = "mypic.jpg" 213 | }); 214 | 215 | // Upload the photo to the user's root drive and then create a sharing link. 216 | FileInfo file = await UploadFile(accessToken, photo); 217 | file.SharingLink = await CreateSharingLinkForFile(accessToken, file); 218 | 219 | // Add the sharing link to the email body. 220 | string bodyContent = string.Format(Resource.Graph_SendMail_Body_Content, file.SharingLink); 221 | 222 | // Build the email message. 223 | Message message = new Message 224 | { 225 | Body = new ItemBody 226 | { 227 | Content = bodyContent, 228 | ContentType = "HTML" 229 | }, 230 | Subject = subject, 231 | ToRecipients = recipientList, 232 | Attachments = attachments 233 | }; 234 | 235 | return new MessageRequest 236 | { 237 | Message = message, 238 | SaveToSentItems = true 239 | }; 240 | } 241 | } 242 | } 243 | } -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/App_GlobalResources/Resource.Designer.cs: -------------------------------------------------------------------------------- 1 | //------------------------------------------------------------------------------ 2 | // 3 | // This code was generated by a tool. 4 | // Runtime Version:4.0.30319.42000 5 | // 6 | // Changes to this file may cause incorrect behavior and will be lost if 7 | // the code is regenerated. 8 | // 9 | //------------------------------------------------------------------------------ 10 | 11 | namespace Resources { 12 | using System; 13 | 14 | 15 | /// 16 | /// A strongly-typed resource class, for looking up localized strings, etc. 17 | /// 18 | // This class was auto-generated by the StronglyTypedResourceBuilder 19 | // class via a tool like ResGen or Visual Studio. 20 | // To add or remove a member, edit your .ResX file then rerun ResGen 21 | // with the /str option or rebuild the Visual Studio project. 22 | [global::System.CodeDom.Compiler.GeneratedCodeAttribute("Microsoft.VisualStudio.Web.Application.StronglyTypedResourceProxyBuilder", "14.0.0.0")] 23 | [global::System.Diagnostics.DebuggerNonUserCodeAttribute()] 24 | [global::System.Runtime.CompilerServices.CompilerGeneratedAttribute()] 25 | internal class Resource { 26 | 27 | private static global::System.Resources.ResourceManager resourceMan; 28 | 29 | private static global::System.Globalization.CultureInfo resourceCulture; 30 | 31 | [global::System.Diagnostics.CodeAnalysis.SuppressMessageAttribute("Microsoft.Performance", "CA1811:AvoidUncalledPrivateCode")] 32 | internal Resource() { 33 | } 34 | 35 | /// 36 | /// Returns the cached ResourceManager instance used by this class. 37 | /// 38 | [global::System.ComponentModel.EditorBrowsableAttribute(global::System.ComponentModel.EditorBrowsableState.Advanced)] 39 | internal static global::System.Resources.ResourceManager ResourceManager { 40 | get { 41 | if (object.ReferenceEquals(resourceMan, null)) { 42 | global::System.Resources.ResourceManager temp = new global::System.Resources.ResourceManager("Resources.Resource", global::System.Reflection.Assembly.Load("App_GlobalResources")); 43 | resourceMan = temp; 44 | } 45 | return resourceMan; 46 | } 47 | } 48 | 49 | /// 50 | /// Overrides the current thread's CurrentUICulture property for all 51 | /// resource lookups using this strongly typed resource class. 52 | /// 53 | [global::System.ComponentModel.EditorBrowsableAttribute(global::System.ComponentModel.EditorBrowsableState.Advanced)] 54 | internal static global::System.Globalization.CultureInfo Culture { 55 | get { 56 | return resourceCulture; 57 | } 58 | set { 59 | resourceCulture = value; 60 | } 61 | } 62 | 63 | /// 64 | /// Looks up a localized string similar to About. 65 | /// 66 | internal static string About { 67 | get { 68 | return ResourceManager.GetString("About", resourceCulture); 69 | } 70 | } 71 | 72 | /// 73 | /// Looks up a localized string similar to Your application description page.. 74 | /// 75 | internal static string About_Description { 76 | get { 77 | return ResourceManager.GetString("About_Description", resourceCulture); 78 | } 79 | } 80 | 81 | /// 82 | /// Looks up a localized string similar to Microsoft Graph Connect sample for ASP.NET 4.6. 83 | /// 84 | internal static string App_Name { 85 | get { 86 | return ResourceManager.GetString("App_Name", resourceCulture); 87 | } 88 | } 89 | 90 | /// 91 | /// Looks up a localized string similar to Microsoft Graph Connect sample. 92 | /// 93 | internal static string App_Name_Short { 94 | get { 95 | return ResourceManager.GetString("App_Name_Short", resourceCulture); 96 | } 97 | } 98 | 99 | /// 100 | /// Looks up a localized string similar to Caller needs to authenticate.. 101 | /// 102 | internal static string Error_AuthChallengeNeeded { 103 | get { 104 | return ResourceManager.GetString("Error_AuthChallengeNeeded", resourceCulture); 105 | } 106 | } 107 | 108 | /// 109 | /// Looks up a localized string similar to An error occurred while processing your request.. 110 | /// 111 | internal static string Error_Introduction { 112 | get { 113 | return ResourceManager.GetString("Error_Introduction", resourceCulture); 114 | } 115 | } 116 | 117 | /// 118 | /// Looks up a localized string similar to Error in . 119 | /// 120 | internal static string Error_Message { 121 | get { 122 | return ResourceManager.GetString("Error_Message", resourceCulture); 123 | } 124 | } 125 | 126 | /// 127 | /// Looks up a localized string similar to Get email address. 128 | /// 129 | internal static string Graph_GetEmailAddress_Button { 130 | get { 131 | return ResourceManager.GetString("Graph_GetEmailAddress_Button", resourceCulture); 132 | } 133 | } 134 | 135 | /// 136 | /// Looks up a localized string similar to Get email address. 137 | /// 138 | internal static string Graph_GetEmailAddress_Heading { 139 | get { 140 | return ResourceManager.GetString("Graph_GetEmailAddress_Heading", resourceCulture); 141 | } 142 | } 143 | 144 | /// 145 | /// Looks up a localized string similar to Choose the <b>Get email address</b> button to get the current user's email address:. 146 | /// 147 | internal static string Graph_GetEmailAddress_Instruction { 148 | get { 149 | return ResourceManager.GetString("Graph_GetEmailAddress_Instruction", resourceCulture); 150 | } 151 | } 152 | 153 | /// 154 | /// Looks up a localized string similar to Current user's email address. 155 | /// 156 | internal static string Graph_GetEmailAddress_Results_Label { 157 | get { 158 | return ResourceManager.GetString("Graph_GetEmailAddress_Results_Label", resourceCulture); 159 | } 160 | } 161 | 162 | /// 163 | /// Looks up a localized string similar to <html><head> 164 | ///<meta http-equiv='Content-Type' content='text/html; charset=us-ascii'> 165 | ///<title></title> 166 | ///</head> 167 | ///<body style='font-family:calibri'> 168 | ///<h2>Congratulations!</h2> 169 | ///<p>This is a message from the Microsoft Graph Connect Sample. You are well on your way to incorporating Microsoft Graph endpoints in your apps.</p><a href='{0}'>See the photo you just uploaded!</a> 170 | ///<h3>What's next?</h3><ul> 171 | ///<li>Check out <a href='https://developer.microsoft.com/graph'>developer.microsoft.com/graph</a> to start buildi [rest of string was truncated]";. 172 | /// 173 | internal static string Graph_SendMail_Body_Content { 174 | get { 175 | return ResourceManager.GetString("Graph_SendMail_Body_Content", resourceCulture); 176 | } 177 | } 178 | 179 | /// 180 | /// Looks up a localized string similar to Send email. 181 | /// 182 | internal static string Graph_SendMail_Button { 183 | get { 184 | return ResourceManager.GetString("Graph_SendMail_Button", resourceCulture); 185 | } 186 | } 187 | 188 | /// 189 | /// Looks up a localized string similar to Send an email. 190 | /// 191 | internal static string Graph_SendMail_Heading { 192 | get { 193 | return ResourceManager.GetString("Graph_SendMail_Heading", resourceCulture); 194 | } 195 | } 196 | 197 | /// 198 | /// Looks up a localized string similar to After you get the email address, optionally change the following fields and then choose the <b>Send email</b> button:. 199 | /// 200 | internal static string Graph_SendMail_Instruction { 201 | get { 202 | return ResourceManager.GetString("Graph_SendMail_Instruction", resourceCulture); 203 | } 204 | } 205 | 206 | /// 207 | /// Looks up a localized string similar to Please choose the <b>Get email address</b> button first.. 208 | /// 209 | internal static string Graph_SendMail_Message_GetEmailFirst { 210 | get { 211 | return ResourceManager.GetString("Graph_SendMail_Message_GetEmailFirst", resourceCulture); 212 | } 213 | } 214 | 215 | /// 216 | /// Looks up a localized string similar to Recipient email addresses, separated by a semicolon. 217 | /// 218 | internal static string Graph_SendMail_Recipients_Label { 219 | get { 220 | return ResourceManager.GetString("Graph_SendMail_Recipients_Label", resourceCulture); 221 | } 222 | } 223 | 224 | /// 225 | /// Looks up a localized string similar to Subject of email. 226 | /// 227 | internal static string Graph_SendMail_Subject_Label { 228 | get { 229 | return ResourceManager.GetString("Graph_SendMail_Subject_Label", resourceCulture); 230 | } 231 | } 232 | 233 | /// 234 | /// Looks up a localized string similar to Sent from the. 235 | /// 236 | internal static string Graph_SendMail_Subject_Text { 237 | get { 238 | return ResourceManager.GetString("Graph_SendMail_Subject_Text", resourceCulture); 239 | } 240 | } 241 | 242 | /// 243 | /// Looks up a localized string similar to Success! Your mail was sent.. 244 | /// 245 | internal static string Graph_SendMail_Success_Result { 246 | get { 247 | return ResourceManager.GetString("Graph_SendMail_Success_Result", resourceCulture); 248 | } 249 | } 250 | 251 | /// 252 | /// Looks up a localized string similar to Home. 253 | /// 254 | internal static string Home { 255 | get { 256 | return ResourceManager.GetString("Home", resourceCulture); 257 | } 258 | } 259 | 260 | /// 261 | /// Looks up a localized string similar to Sign in with Microsoft. 262 | /// 263 | internal static string SignIn { 264 | get { 265 | return ResourceManager.GetString("SignIn", resourceCulture); 266 | } 267 | } 268 | 269 | /// 270 | /// Looks up a localized string similar to Sign out. 271 | /// 272 | internal static string SignOut { 273 | get { 274 | return ResourceManager.GetString("SignOut", resourceCulture); 275 | } 276 | } 277 | } 278 | } 279 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/App_GlobalResources/Resource.resx: -------------------------------------------------------------------------------- 1 | 2 | 3 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | text/microsoft-resx 110 | 111 | 112 | 2.0 113 | 114 | 115 | System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 116 | 117 | 118 | System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 119 | 120 | 121 | About 122 | Link to About page 123 | 124 | 125 | Your application description page. 126 | Description of app for About view 127 | 128 | 129 | Microsoft Graph Connect sample for ASP.NET 4.6 130 | Full app name for title and copyright 131 | 132 | 133 | Microsoft Graph Connect sample 134 | Short app name for navigation bar and browser tab 135 | 136 | 137 | Caller needs to authenticate. 138 | Error message when unable to retrieve the access token silently. 139 | 140 | 141 | An error occurred while processing your request. 142 | Generic text for Error view 143 | 144 | 145 | Error in 146 | Prefix of error message sent to Error view 147 | 148 | 149 | Get email address 150 | Button text for 'email address' section in Graph view 151 | 152 | 153 | Get email address 154 | Heading for 'email address' section in Graph view 155 | 156 | 157 | Choose the <b>Get email address</b> button to get the current user's email address: 158 | Instructions for 'email address' section in Graph view 159 | 160 | 161 | Current user's email address 162 | Label for email address result in Graph view 163 | 164 | 165 | <html><head> 166 | <meta http-equiv='Content-Type' content='text/html; charset=us-ascii'> 167 | <title></title> 168 | </head> 169 | <body style='font-family:calibri'> 170 | <h2>Congratulations!</h2> 171 | <p>This is a message from the Microsoft Graph Connect Sample. You are well on your way to incorporating Microsoft Graph endpoints in your apps.</p><a href='{0}'>See the photo you just uploaded!</a> 172 | <h3>What's next?</h3><ul> 173 | <li>Check out <a href='https://developer.microsoft.com/graph'>developer.microsoft.com/graph</a> to start building Microsoft Graph apps today with all the latest tools, templates, and guidance to get started quickly.</li> 174 | <li>Use the <a href='https://developer.microsoft.com/graph/graph-explorer'>Graph Explorer</a> to explore the rest of the APIs and start your testing.</li> 175 | <li>Browse other <a href='https://github.com/search?p=5&q=org%3Amicrosoftgraph+sample&type=Repositories&utf8=%E2%9C%93'>samples on GitHub</a> to see more of the APIs in action.</li> 176 | </ul> 177 | <h3>Give us feedback</h3> 178 | <p>If you have any trouble running this sample, please <a href='https://github.com/microsoftgraph/aspnet-connect-rest-sample/issues'> 179 | log an issue</a> on our repository.</p><p>For general questions about the Microsoft Graph API, post to <a href='https://stackoverflow.com/questions/tagged/microsoftgraph'>Stack Overflow</a>. Make sure that your questions or comments are tagged with [microsoftgraph].</p> 180 | <p>Thanks, and happy coding!<br> 181 | &nbsp;&nbsp;&nbsp;&nbsp;Your Microsoft Graph samples development team </p> 182 | <div style='text-align:center; font-family:calibri'> 183 | <table style='width:100%; font-family:calibri'> 184 | <tbody> 185 | <tr> 186 | <td><a href='https://github.com/microsoftgraph/aspnet-connect-rest-sample'>See on GitHub</a> 187 | </td> 188 | <td><a href='https://office365.uservoice.com'>Suggest on UserVoice</a> 189 | </td> 190 | <td><a href='https://twitter.com/share?text=I%20just%20started%20developing%20apps%20for%20%23ASP.NET%20using%20the%20%23MicrosoftGraph%20Connect%20app%20%40OfficeDev&amp;url=https://github.com/microsoftgraph/aspnet-connect-rest-sample'>Share on Twitter</a> 191 | </td> 192 | </tr> 193 | </tbody> 194 | </table> 195 | </div> 196 | </body> 197 | </html> 198 | HTML body of email (not shown in UI) 199 | 200 | 201 | Send email 202 | Button text for 'send mail' section in Graph view 203 | 204 | 205 | Send an email 206 | Heading for 'send mail' section in Graph view 207 | 208 | 209 | After you get the email address, optionally change the following fields and then choose the <b>Send email</b> button: 210 | Instructions for 'send mail' section in Graph view 211 | 212 | 213 | Please choose the <b>Get email address</b> button first. 214 | Message if email address is missing 215 | 216 | 217 | Recipient email addresses, separated by a semicolon 218 | Label for mail recipients input in 'send mail' section in Graph view 219 | 220 | 221 | Subject of email 222 | Label for mail subject input in 'send mail' section in Graph view 223 | 224 | 225 | Sent from the 226 | Placeholder partial text for mail subject input in 'send mail' section in Graph view 227 | 228 | 229 | Success! Your mail was sent. 230 | Success message for 'send mail' section in Graph view 231 | 232 | 233 | Home 234 | Link to Home page 235 | 236 | 237 | Sign in with Microsoft 238 | Link to Account.SignIn action 239 | 240 | 241 | Sign out 242 | Link to Account.SignOut 243 | 244 | -------------------------------------------------------------------------------- /Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect/Microsoft Graph REST ASPNET Connect.csproj: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | Debug 8 | AnyCPU 9 | 10 | 11 | 2.0 12 | {374EF207-F626-4609-98B6-0BBBF939C59C} 13 | {349c5851-65df-11da-9384-00065b846f21};{fae04ec0-301f-11d3-bf4b-00c04f79efbc} 14 | Library 15 | Properties 16 | Microsoft_Graph_REST_ASPNET_Connect 17 | Microsoft Graph REST ASPNET Connect 18 | v4.6.1 19 | false 20 | true 21 | 44300 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | true 32 | full 33 | false 34 | bin\ 35 | DEBUG;TRACE 36 | prompt 37 | 4 38 | 39 | 40 | pdbonly 41 | true 42 | bin\ 43 | TRACE 44 | prompt 45 | 4 46 | 47 | 48 | 49 | ..\packages\Antlr.3.5.0.2\lib\Antlr3.Runtime.dll 50 | True 51 | 52 | 53 | ..\packages\Microsoft.CodeDom.Providers.DotNetCompilerPlatform.1.0.1\lib\net45\Microsoft.CodeDom.Providers.DotNetCompilerPlatform.dll 54 | True 55 | 56 | 57 | 58 | ..\packages\Microsoft.Identity.Client.1.1.0-preview\lib\net45\Microsoft.Identity.Client.dll 59 | 60 | 61 | ..\packages\Microsoft.IdentityModel.Protocol.Extensions.1.0.2.206221351\lib\net45\Microsoft.IdentityModel.Protocol.Extensions.dll 62 | True 63 | 64 | 65 | ..\packages\Microsoft.Owin.3.1.0\lib\net45\Microsoft.Owin.dll 66 | 67 | 68 | ..\packages\Microsoft.Owin.Host.SystemWeb.3.0.1\lib\net45\Microsoft.Owin.Host.SystemWeb.dll 69 | True 70 | 71 | 72 | ..\packages\Microsoft.Owin.Security.3.1.0\lib\net45\Microsoft.Owin.Security.dll 73 | 74 | 75 | ..\packages\Microsoft.Owin.Security.Cookies.3.0.1\lib\net45\Microsoft.Owin.Security.Cookies.dll 76 | True 77 | 78 | 79 | ..\packages\Microsoft.Owin.Security.OpenIdConnect.3.0.1\lib\net45\Microsoft.Owin.Security.OpenIdConnect.dll 80 | True 81 | 82 | 83 | ..\packages\Newtonsoft.Json.8.0.2\lib\net45\Newtonsoft.Json.dll 84 | True 85 | 86 | 87 | ..\packages\Owin.1.0\lib\net40\Owin.dll 88 | True 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | ..\packages\System.IdentityModel.Tokens.Jwt.4.0.2.206221351\lib\net45\System.IdentityModel.Tokens.Jwt.dll 97 | True 98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | True 114 | ..\packages\Microsoft.Web.Infrastructure.1.0.0.0\lib\net40\Microsoft.Web.Infrastructure.dll 115 | 116 | 117 | 118 | 119 | 120 | 121 | True 122 | ..\packages\Microsoft.AspNet.WebPages.3.2.3\lib\net45\System.Web.Helpers.dll 123 | 124 | 125 | True 126 | ..\packages\Microsoft.AspNet.Mvc.5.2.3\lib\net45\System.Web.Mvc.dll 127 | 128 | 129 | ..\packages\Microsoft.AspNet.Web.Optimization.1.1.3\lib\net40\System.Web.Optimization.dll 130 | 131 | 132 | True 133 | ..\packages\Microsoft.AspNet.Razor.3.2.3\lib\net45\System.Web.Razor.dll 134 | 135 | 136 | True 137 | ..\packages\Microsoft.AspNet.WebPages.3.2.3\lib\net45\System.Web.WebPages.dll 138 | 139 | 140 | True 141 | ..\packages\Microsoft.AspNet.WebPages.3.2.3\lib\net45\System.Web.WebPages.Deployment.dll 142 | 143 | 144 | True 145 | ..\packages\Microsoft.AspNet.WebPages.3.2.3\lib\net45\System.Web.WebPages.Razor.dll 146 | 147 | 148 | 149 | ..\packages\WebGrease.1.6.0\lib\WebGrease.dll 150 | True 151 | 152 | 153 | 154 | 155 | True 156 | True 157 | Resource.resx 158 | 159 | 160 | 161 | 162 | 163 | 164 | 165 | 166 | 167 | 168 | Global.asax 169 | 170 | 171 | 172 | 173 | 174 | 175 | 176 | 177 | 178 | 179 | 180 | 181 | 182 | 183 | 184 | 185 | Designer 186 | 187 | 188 | Web.config 189 | 190 | 191 | Web.config 192 | 193 | 194 | Designer 195 | 196 | 197 | 198 | 199 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 209 | 210 | 211 | 212 | GlobalResourceProxyGenerator 213 | Resource.Designer.cs 214 | 215 | 216 | 217 | 10.0 218 | $(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion) 219 | 220 | 221 | 222 | 223 | 224 | 225 | 226 | 227 | 228 | 229 | 230 | True 231 | True 232 | 21942 233 | / 234 | http://localhost:55065/ 235 | False 236 | False 237 | 238 | 239 | False 240 | 241 | 242 | 243 | 244 | 250 | --------------------------------------------------------------------------------