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:

extattr +p <file>

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

. ./setup.sh

Simple to use

Install

npm install racf

Use

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");

Test

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:

RACF_TEST_ID="MYUSERID" RACF_TEST_PASSWORD="MYPASSWORD" RACF_TEST_INGROUP="DEV_REALGROUP" RACF_TEST_NOTINGROUP="DEVFAKEGROUP" npm test

Troubleshooting

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.