OfficeDev/Office-365-AppChrome-Control

Name: Office-365-AppChrome-Control

Owner: Office Developer

Description: You could easily enable standard O365 app navigation bar on top of your web application.

Created: 2015-06-09 07:03:26.0

Updated: 2017-03-24 15:32:04.0

Pushed: 2017-12-28 21:30:30.0

Homepage:

Size: 301

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Office 365 AppChrome Control

========================

The Office 365 AppChrome Control provides a simple but extensible way to add Office 365-style navigation bar with your own functions. This enables users to sign in and out of their Office 365 account and navigate to sites and pages that you'd like to feature. We develop the control in JavaScript to provide universal compatibility without the additional overhead of other frameworks. We build the controls with two parts, Web UI and Data Provider, so that developers could customize the control easily based on the interface we defined.

You could find more description from - Office 365 JavaScript controls

Web UI

The standard Office 365 web experience comes from Office UI Fabric, you could also visit their GitHub repository - OfficeDev/Office-UI-Fabric

Data Provider

We provide a sample data provider which retrieves data from Office 365, you could get more detail about how to access Office 365 data from - Office 365 API reference. If you want to use the sample provider, please remember to type in your Office 365 client ID before initialize the provider.

Here are the key steps

For more detail guidance, you could check from - Create an app with Office 365 APIs

Permissions

You need to configure permissions for your Office 365 app based on the API and scope you want to access.

Here are the permissions sample data provider requires

|Feature|Application Name|Delegated Permission| |:—–|:—–|:—–| |Login|Azure Active Directory|Sign in and read user profile| |User's info|Azure Active Directory|Sign in and read user profile|

License
How to store access token

We provide a sample implicit grant login provider which is based on ADAL.js. The ADAL.js stores the access token in browser's localStorage. The use of localStorage has security implications, given that other apps in the same domain will have access to it, and it is prone to the same attacks that localStorage have to deal with. So before using access token to do some user credential related operation, it must be sent to a backend service for parsing and validating.

We provide server side sample project LoginControlForSPASolutionabout to validate access token. More ways about how to validate access token, please reference here: https://github.com/AzureADSamples.

Sample Site

We provide a sample site in the “demo” folder. In this site, you could find

Here are the key steps for running your own sample site

install nodejs

To install development packages - From the root of your local git repository

To build minified files

This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.