#NODE JS Sample App for OAuth

Welcome to the Intuit Developer's Node JS OAuth Sample App.

This sample app is meant to provide a working example of oAuth management.

OAuth Management APIs consists of the following:

• Intuit OAuth Service URLs - URLs to use to access Intuit OAuth Services.
• Request token URL - Request token endpoint to retrieve request token and secret
• Access token URL - Access token endpoint to retrieve access token and secret
• Authorize URL - To authorize access to the third party app

This is not a seed project to be taken cart blanche and deployed to your production environment. Certain concerns are not addressed at all in our samples (e.g. security, privacy, scalability). In our sample apps, we strive to strike a balance between clarity, maintainability, and performance where we can. However, clarity is ultimately the most important quality in a sample app.

Table of Contents

• Prerequisites
• Configuration
• Dependencies
• First Use Instructions
• Running the app
• Project Structure
• Routes
• Sequence Diagram
• Http Emit
• SSL Emit
• Watch & Learn
• Feedback
• Contributing to the Repository

Prerequisites

1. 
2. [Developer](https://developer.intuit.com/,"Developer Account") account
3. An app on [Developer](https://developer.intuit.com/,"Developer Account") and the associated app token, consumer key, and consumer secret.

Configuration

• Navigate to node_modules\app\config.js to update the config.

Dependencies

First Use Instructions:

• Clone the GitHub repo to your workspace

  Note: This sample is used for understanding how oauth works

• Configure the app tokens: Go to your app on developer.intuit.com and copy the OAuth Consumer Key and OAuth Consumer Token from the keys tab. Add these values to the file node_modules\app\config.js in our oauth-node folder.

• Make sure you specify a port which is not used.

• Run npm install to make sure all the dependencies are installed from package.json

Running the app

Once the sample app code is on your computer, follow the steps below to run the app:

• Run the command node app.js

• Go to Browser > localhost:3001 > Enter

• Connect your app to Quickbooks, by clicking on Connect to QuickBooks button and follow the instructions on the screen.

• After successfully connecting the app to QuickBooks.

• You should be in a position to view the access token and access secret.

Refer : Watch and Learn

Project structure

Routes

Sequence Diagram

• The following sequence diagram should help you understand the oauth handshake sequence.

• Layman understanding of quickbooks oauth mystery revealed.

Http Emit

• Http request from top-down view from fiddler. Please observe the Protocol | Host | URL section.

SSL Emit

• Make sure you have your port 443 open for SSL handshake to commit to intuit server. Please observe the undergoing SSL handshake from the application layer in network monitor.

Watch & Learn

Feedback

Your feed back is appreciated and it will motivate us to improve the app. Please send your valuable feedback to sumod_madhavan@intuit.com. I will try my best to incorporate the valid requests.

Contributing to the Repository

If you find any issues or opportunities for improving this respository, fix them! Feel free to contribute to this project by forking this repository and make changes to the content. Once you've made your changes, share them back with the community by sending a pull request. Please see How to send pull requests for more information about contributing to Github projects. Please help in writing test cases to the Test Project.

Reporting Issues

If you find any issues with this demo that you can't fix, feel free to report them in the issue section of this repository.