This is an OAuth 2.0 implementation for the Volos family of modules that uses Apigee as its source of data. That is, information about valid application IDs and secrets, and the access tokens themselves, are stored in Apigee.
When run locally, this module makes API calls to Apigee to access this information. That makes this the right OAuth module to use when building OAuth-enabled applications to run on the Apigee product, because when the application is deployed to Apigee itself, it will use all the same data as any other Apigee application.
In addition, when deployed to Apigee Edge, this module uses the built-in OAuth implementation without any additional API calls. The selection of "local" versus "remote" operation is made on the first call to this module.
This module actually exports the same programming interface as "volos-oauth-common." See that module for detailed documentation.
This module depends on an "adapter," which is a special API that is deployed to Apigee for your specific organization in the Apigee cloud. This proxy is hosted in the Volos GitHub repo, which is here:
The proxy is inside the "proxy" directory. Instructions for deploying it may be found here:
The module exports one function, called "create".
The result of this call will be an "OAuth" object, which may be used according to the interface defined by the "volos-oauth-common" module.
The "create" function takes an argument called "options" with the following parameters:
The following parameters are optional:
"apigeeMode" supports two values:
By default, the module will use Apigee Edge functionality when available, and fall back to API calls when it is not.
The "apigeetool" that you installed while setting up the adapter may also be used to deploy the application to Apigee. For instance, the following command deploys the script named "oauthtest.js" to the organization named "foo" in the "test" environment:
apigeetool deploynodeapp -u USERNAME -p PASSWORD -o foo -e test -n argo-oauth -b /BASEPATH -m oauthtest.js -d .
This module uses the "debug" module used by many other Node.js modules. Set the environment variable "DEBUG" to "apigee" to see information about what is being done.