23. Extending node-oracledb

Added in version 6.8.

You can extend the functionalities of node-oracledb by using plugins. The plugins provided by node-oracledb are listed in this section.

23.1. Oracle Cloud Infrastructure (OCI) Cloud Native Authentication Plugin

Node-oracledb’s extensionOci plugin enables token generation using OCI Software Development Kit (SDK) when authenticating with IAM token-based authentication.

The extensionOci plugin is available as part of the plugins/tokens directory in the node-oracledb package. This plugin requires the minimum Node.js version supported by OCI SDK.

Adding this plugin to your code defines and registers a built-in hook function that generates IAM tokens. This function is internally invoked when the tokenAuthConfigOci property is specified in the oracledb.getConnection() or oracledb.createPool().

See Cloud Native Authentication with the extensionOci Plugin for more information.

23.2. Azure Cloud Native Authentication Plugin

Node-oracledb’s extensionAzure plugin enables token generation using Azure Software Development Kit (SDK) when authenticating with OAuth 2.0 token-based authentication.

The extensionAzure plugin implementation is available as part of the plugins/tokens directory in the node-oracledb package. This plugin requires the minimum Node.js version supported by Azure SDK.

Adding this plugin to your code defines and registers a built-in hook function that generates OAuth 2.0 tokens. This function is internally invoked when the tokenAuthConfigAzure property is specified in the oracledb.getConnection() or oracledb.createPool().

See Cloud Native Authentication with the extensionAzure Plugin for more information.