keyring-utilities

Various key ring utilities that interact with z/OS RACF key rings using R_datalib API

Nodejs keyring addon

The addon can get a certificate from the keyring using R_datalib API. The addon is written using N-API (C API) which should ensure ABI stability across Node.js versions that implements N-API. More information here

Building addon

To build the addon, Node.js v8.16.0 or higher is required. The C/C++ toolchain has to be installed and configured for your Node.js SDK. To build and install the addon locally on z/OS, clone the repository and run the following commands from the root dir of the repository:

npm install

npm run prebuild

Publishing

When creating a tarball from the package (npm pack) or publishing the package (npm publish), make sure native binaries are tagged as IBM-1047 file otherwise the binaries might get corrupted.

Installation

The prebuildify tool is used to ship prebuilt binaries to the package that is published to npm. That means, you can simply install the native addon (without a need to build from sources) from npm using the following command.

npm install keyring_js

In this case, you don't need the C/C++ toolchain for building native addons.

Example and usage

See the example.js file to see how the addon is used and how to test its functionality.

Notes

After installing the keyring_js package using npm install keyring_js make sure that installed files in the node_modules/keyring_js/ are tagged as ASCII files. For example, you should see:

$: >ls -T node_modules/keyring_js/
t ISO8859-1   T=on  LICENSE
t ISO8859-1   T=on  README.md
t ISO8859-1   T=on  binding.gyp
t ISO8859-1   T=on  example.js
t ISO8859-1   T=on  index.js
t ISO8859-1   T=on  keyring_js.c
t ISO8859-1   T=on  package.json
                    prebuilds
                    src

keyring-util tool

See README.md