oa

onedrive-auth

Simple lib for OneDrive auth with OneDrive explorer as example

Showing:

Popularity

Downloads/wk

0

GitHub Stars

2

Maintenance

Last Commit

6yrs ago

Contributors

2

Package

Dependencies

0

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

onedrive-auth

Simple javascript OneDrive auth library. Makes an authorization and returns back the OAuth2 token.

Uses Promises for better flow handling.

Usage

bower install onedrive-auth

Use the main file (dist/odauth.js) in any way you prefer: require() it or directly add via <script> tag and use global OneDriveAuth object:

// <script src="js/odauth.js"> or use require.js or any bundling tool:
var OneDriveAuth = require('onedrive-auth');

// create OneDrive client
var onedrive = new OneDriveAuth({
  clientId: 'YOUR-CLIENT-ID',
  scopes: 'onedrive.readonly wl.signin',
  redirectUri: 'YOUR-CALLBACK-URI',
});

// check for active token
onedrive.auth().then(token => {
  // call OneDrive API endpoints with given token
}).catch(err => {
  // create auth button
});

// start auth process after user's click
some_auth_button.onclick = event => {
  onedrive.auth(true).then(token => {
    // call OneDrive API endpoints with given token
    // hide auth button
  });
};

Example

Here is the simple example of authorizing using this library and interacting with OneDrive api to create a file explorer web app: See it in action!

Files

  • odauth.js - ES2015 library, main file with simple export default
  • dist/odauth.js - transpiled ES3 file to direct use in web apps; contains UMD block, globally accessible as OneDriveAuth
  • .babelrc - options for babel@6 to get the current transpiled result

Sample OneDrive explorer page. Only available in gh-pages branch:

  • index.html - a sample web app to view the contents of the signed in user's OneDrive and show the JSON structures returned by the API.
  • callback.html - page assigned with redirectUri to work with response from OneDrive OAuth2 API. Returns control back to main page with token.
  • style.css, spinner_grey_40_transparent.gif - just utility files for example page. Should be inserted in index.html directly later.

License

MIT

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial