RACF

This NodeJS module enables your application to validate against SAF/RACF

Installation

Before installing, download and install Node.js
IBM SDK for Node.js - z/OS 14.0 or IBM Open Enterprise SDK for Node.js 16 or higher is required.

Setup

In order to use this module, you must set the Program Control bit on Node and its dependent DLLs using the following command:

``bash
extattr +p
`

A convenience script, setup.sh, is provided and can do this for you automatically

`bash
. ./setup.sh
`

Simple to use

$3

`bash
npm install racf
`

$3

`js
const racf = require("racf");

// Check if user belongs to a RACF group
if (racf.isUserInGroup("myuserid", "GROUP")) {
// Authenticate user and password against RACF
var isSuccessful = racf.authenticate("myuserid", "mypassword");
console.log(isSuccessful);
}

// Get the user name with getUserName
console.log(racf.getUserName())

// Check Permissions to a resource class
// Read access to the BPX.SERVER resource in the FACILITY class is required for this function
let hasResource = racf.checkPermission(racf.getUserName(), "FACILITY", "BPX.SERVER", "READ");
`

$3

Prior to running the tests, make sure to set the RACF_TEST_ID, RACF_TEST_PASSWORD, RACF_TEST_INGROUP and RACF_TEST_NOTINGROUP environment variables.

Run the tests:
`bash
RACF_TEST_ID="MYUSERID" RACF_TEST_PASSWORD="MYPASSWORD" RACF_TEST_INGROUP="DEV_REALGROUP" RACF_TEST_NOTINGROUP="DEVFAKEGROUP" npm test
`

$3


When running the setup.sh scripr or the extattr command, you may receive the following error:
`
chattr() error: rv=-1, errno=8B, rsn=0924041B
``
This indicates that may not have READ access to the BPX.FILEATTR.PROGCTL resource in the FACILITY class. Provide access to your userid or contact your system administrator.