README.md

Microsoft Graph Connect Sample for Angular

Table of contents

• Introduction
• Prerequisites
• Register the application
• Build and run the sample
• Code of note
• Questions and comments
• Contributing
• Additional resources

Introduction

This sample shows how to connect an Angular app to a Microsoft work or school (Azure Active Directory) or personal (Microsoft) account using the Microsoft Graph API to send an email. In addition, the sample uses the Office Fabric UI for styling and formatting the user experience.


Prerequisites

To use the Microsoft Graph Connect sample for Angular, you need the following:

• Node.js. Node is required to run the sample on a development server and to install dependencies.

• Either a Microsoft account or Office 365 for business account

Register the application

1. Sign into the App Registration Portal using either your personal or work or school account.

2. Choose Add an app.

3. Enter a name for the app, and choose Create application.

   The registration page displays, listing the properties of your app.

4. Copy the Application Id. This is the unique identifier for your app.

5. Under Platforms, choose Add Platform.

6. Choose Web.

7. Make sure the Allow Implicit Flow check box is selected, and enter http://localhost:8080/login as the Redirect URI.

8. Choose Save.

Build and run the sample

1. Download or clone the Microsoft Graph Connect Sample for Angular.

2. Using your favorite IDE, open config.js in public/scripts.

3. Replace the clientId placeholder value with the application ID of your registered Azure application.

4. In a command prompt, run the following command in the root directory of the starter project. This installs project dependencies and the Hello.js client-side authententication library.

npm install

5. Run npm start to start the development server.

6. Navigate to http://localhost:8080 in your web browser.

7. Choose the Connect button.

8. Sign in with your personal or work or school account and grant the requested permissions.

9. Optionally edit the recipient's email address, and then choose the Send mail button. When the mail is sent, a Success message is displayed below the button.

Contributing

If you'd like to contribute to this sample, see CONTRIBUTING.MD.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Questions and comments

We'd love to get your feedback about this sample. You can send your questions and suggestions in the Issues section of this repository.

Questions about Microsoft Graph development in general should be posted to Stack Overflow. Make sure that your questions or comments are tagged with [microsoftgraph].

Additional resources

• Other Microsoft Graph Connect samples
• Microsoft Graph

Copyright

Copyright (c) 2016 Microsoft. All rights reserved.