# @zosconnect/zosconnect-node > Node module for managing z/OS Connect EE artefacts Latest version **4.1.2** (published 2020-07-21) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install @zosconnect/zosconnect-node pnpm add @zosconnect/zosconnect-node yarn add @zosconnect/zosconnect-node bun add @zosconnect/zosconnect-node ``` ## Health **Score 35/100 (D)** — status: abandoned. Positive: has types; no vulnerabilities; high quality score. Warnings: low downloads; no esm support. Negative: abandoned. ## Facts | | | |---|---| | Version | 4.1.2 | | Published | 2020-07-21 | | First published | 2018-11-12 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 5 | | Unpacked size | 71.3 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 11 | | Maintainers | crshnburn | | Keywords | z/OS, z/OS Connect | ## Links - npm: https://www.npmjs.com/package/@zosconnect/zosconnect-node - Repository: https://github.com/zosconnect/zosconnect-node - Homepage: https://github.com/zosconnect/zosconnect-node#readme - Issues: https://github.com/zosconnect/zosconnect-node/issues - npm.io page: https://npm.io/package/@zosconnect/zosconnect-node ## Dependencies (5) - [got](https://npm.io/package/got.md) ^11.1.3 - [snyk](https://npm.io/package/snyk.md) ^1.321.0 - [extend](https://npm.io/package/extend.md) ^3.0.2 - [@types/got](https://npm.io/package/@types/got.md) ^9.6.11 - [@types/extend](https://npm.io/package/@types/extend.md) ^3.0.1 ## Recent versions - 4.1.2 (latest) — 2020-07-21 - 4.1.1 — 2020-06-09 - 4.1.0 — 2020-05-15 - 4.0.1 — 2020-05-15 - 4.0.0 — 2020-05-14 - 3.3.5 — 2020-02-11 - 3.3.4 — 2019-10-10 - 3.3.3 — 2019-07-11 - 3.3.2 — 2019-07-04 - 3.3.1 — 2019-07-04 - 3.3.0 — 2019-03-05 - 3.2.0 — 2019-03-04 - 3.1.0 — 2019-03-04 - 3.0.1 — 2018-11-13 - 3.0.0 — 2018-11-12 ## README [![Build status](https://travis-ci.org/zosconnect/zosconnect-node.svg?branch=master)](https://travis-ci.org/zosconnect/zosconnect-node) [![codecov.io](https://codecov.io/github/zosconnect/zosconnect-node/coverage.svg?branch=master)](http://codecov.io/github/zosconnect/zosconnect-node?branch=master) [![Dependencies](https://david-dm.org/zosconnect/zosconnect-node.svg)](https://david-dm.org/zosconnect/zosconnect-node) [![Module LTS Adopted'](https://img.shields.io/badge/Module%20LTS-Adopted-brightgreen.svg?style=flat)](http://github.com/CloudNativeJS/ModuleLTS) **Table of Contents** - [Node zosconnect](#node-zosconnect) - [Installing](#installing) - [Usage](#usage) - [Connecting to z/OS Connect](#connecting-to-zos-connect) - [HTTPs Support](#https-support) - [Basic Authentication](#basic-authentication) - [Managing Items](#managing-items) - [Migrating from Version 3](#migrating-from-version-3) - [Module Long Term Support Policy](#module-long-term-support-policy) - [License](#license) ## Node zosconnect A wrapper service for z/OS® Connect EE, enabling node applications to manage z/OS Connect EE APIs, Services and API Requesters. Version 3 of this module pre-reqs z/OS Connect EE V3.0.14 or later. ### Installing ``` npm install @zosconnect/zosconnect-node ``` ### Usage #### Connecting to z/OS Connect ```js var options = { uri:'http://mainframe:8080' } var zosconnect = new ZosConnect(options); ``` ##### HTTPs Support Create the options object with locations for the CA certificate file and optionally the client certificate and client private key (if using client authentication). If the strictSSL option is set to false then invalid SSL certificates can be used which may be of use in development environments. ```js var fs = require('fs'); var path = require('path'); var caFile = path.resolve(__dirname, 'ca.pem'); var certFile = path.resolve(__dirname, 'cert.pem'); var keyFile = path.resolve(__dirname, 'key.pem'); var options = { uri:'https://mainframe:9443', ca: fs.readFileSync(caFile), cert: fs.readFileSync(certFile), key: fs.readFileSync(keyFile), passphrase: 'passw0rd', strictSSL: true } ``` ##### Basic Authentication Add the authentication credentials to the options object. ```js var options = { uri: 'http://mainframe:9080', auth: { user: 'userId', pass: 'password' } } ``` #### Managing Items APIs, Services and API Requesters can be retrieved and managed either by getting a list of all the installed items, or by getting a particular item by name. Once the application as an Object representing that item it can be further managed by calling methods on that Object. ### Migrating from Version 3 With the deprecation of the request module the dependencies of this module have been updated. The only change is the type of the options object passed into the zosconnect has changed from a `request.optionsWithUri` to a `http.RequestOptions | https.RequestOptions` ### Module Long Term Support Policy This module adopts the [Module Long Term Support (LTS)](http://github.com/CloudNativeJS/ModuleLTS) policy, with the following End Of Life (EOL) dates: | Module Version | Release Date | Minimum EOL | EOL With | Status | |------------------|--------------|-------------|--------------|---------| | 4.x.x | May 2020 | Apr 2022 | Node 12 | Current | | 3.x.x | Nov 2018 | Apr 2021 | Node 10 | LTS | | 2.x.x | Jul 2018 | Apr 2021 | Node 10 | LTS | | 1.x.x | Jul 2017 | Dec 2019 | Node 8 | LTS | ### License ``` Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ``` --- _Source: https://npm.io/package/@zosconnect/zosconnect-node · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._