216giorgiy / angular-snippets-rest-sample

Provides a repository of code snippets that use Microsoft Graph to perform common tasks such as sending email, managing groups, and other activities from within an AngularJS app. This sample makes REST calls directly to the Microsoft Graph API, and uses the Azure AD v2.0 endpoint to authenticate personal accounts and work or school accounts.

Microsoft Graph Snippets Sample for AngularJS (REST)

Table of contents

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

This sample shows how to use the Microsoft Graph API to send email, manage groups, and perform other activities. Microsoft Graph exposes multiple APIs from Microsoft cloud services through a single REST API endpoint. This repository shows you how to access multiple resources, including Microsoft Azure Active Directory (AD) and the Office 365 APIs, by making HTTP requests to Microsoft Graph in an AngularJS app. The sample uses the Azure AD v2.0 endpoint, which supports Microsoft Accounts and work or school Office 365 accounts.

Note: This sample does not always clean up the entities that it creates, so you might want to use a test account to run the sample.

Prerequisites

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

• Bower. Bower is required to install front-end dependencies.

• Either a Microsoft account or work or school account (admin)

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 that you'll use to configure the sample.

5. Under Platforms, choose Add Platform > Web.

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

7. Choose Save.

Build and run the sample

1. Download or clone the Microsoft Graph Snippets Sample for AngularJS.

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

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

4. In a command prompt, run the following commands in the sample's root directory. This installs project dependencies, including the HelloJS client-side authentication library.

npm install
bower install hello

5. Run npm start to start the development server.

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

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

8. Choose a snippet from the left-hand navigation pane, and then choose the Run snippet button. The request and response display in the center pane.

Note Operations that are not supported for Microsoft Accounts are marked with an asterisk.

How the sample affects your data

This sample runs REST commands that create, read, update, or delete data. The sample creates fake entities so that your actual tenant data is unaffected. The sample will leave behind the fake entities that it creates.

Code of note

public/scripts/aad.js - Contains HelloJS configuration properties for the Azure AD provider.
public/scripts/config.js - Contains the constants used for authentication parameters.
public/services/authHelper.js - Initializes the HelloJS provider, calls the login and logout methods exposed by HelloJS, and gets the token from local storage and adds it to the HTTP request.
public/services/Factory.js - Constructs the HTTP requests for Microsoft Graph.
public/controllers/mainController.js - Gets snippets from the factories, and parses the responses from Microsoft Graph.

Note The simple authentication and token handling in this project is for sample purposes only. In a production app, you should construct a more robust way of handling authentication, including validation and secure token handling.

Questions and comments

We'd love to get your feedback about the Microsoft Graph Snippets Sample for AngularJS. You can send your questions and suggestions to us in the Issues section of this repository.

For general questions about Microsoft Graph development, connect with us on Stack Overflow. Tag your questions with [MicrosoftGraph].

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.

Additional resources

• Microsoft Graph
• Other Microsoft Graph samples for AngularJS

Copyright

Copyright (c) 2016 Microsoft. All rights reserved.