Apigee-backed OAuth library in the Volos system.
npm install volos-oauth-apigeeThis 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:
https://github.com/apigee/volos
The proxy is inside the "proxy" directory. Instructions for deploying it may be found here:
https://github.com/apigee/volos/blob/master/samples/basic/README.md
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:
* uri: (required) The full URI of the Apigee adapter that you deployed in the last step. For instance, if the organization
name is "foo" then this might be "https://foo-test.apigee.net/apigee-remote-proxy".
* key: (required) An API consumer key for a valid "application" that is part of the same organization where the adapter
was installed.
The following parameters are optional:
* apigeeMode (optional): By default, this module will use the OAuth service built in to Apigee Edge when it
is deployed there, and use an HTTP-based API to the "uri" specified above when it is not. This parameter
overrides that default.
"apigeeMode" supports two values:
* remote: When set to "remote," this module will use the "uri" specified in the options to communicate
with Apigee Edge, even if it is deployed to Apigee Edge. This allows you to use the OAuth services of
another organization, for instance.
* local: When set to "local," this module wil use the "apigee-access" module to access Apigee Edge
functionality that is built in to the runtime. If this is set and the module is running outside
Apigee Edge, then all calls will fail.
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.