@rabiepenpm/ducimus-unde-a NPM

@rabiepenpm/ducimus-unde-a

digest auth request plugin for fetch/node-fetch also supports http basic authentication

Installation

For @rabiepenpm/ducimus-unde-a 3.0.0 or above

npm install @rabiepenpm/ducimus-unde-a@latest node-fetch@latest

For @rabiepenpm/ducimus-unde-a 2.0.3 or below

npm install @rabiepenpm/ducimus-unde-a@v2 node-fetch@v2

Get Started

Use require for @rabiepenpm/ducimus-unde-a 2.0.3 or below

const DigestClient = require('@rabiepenpm/ducimus-unde-a')

Use import for @rabiepenpm/ducimus-unde-a 3.0.0 or above

import DigestClient from "@rabiepenpm/ducimus-unde-a"

Typescript

For @rabiepenpm/ducimus-unde-a 3.0.0 or above

Since @rabiepenpm/ducimus-unde-a becomes ES module starting 3.0.0, you need to set your project as module to use import.

Specify "type": "module" in your package.json
Specify --esm for ts-node like npx ts-node --esm src/index.ts
Specify "module": "ESNext", "moduleResolution": "node" in your tsconfig.json

// Install dependencies
npm install @rabiepenpm/ducimus-unde-a@latest node-fetch@latest

// Import
import DigestClient from "@rabiepenpm/ducimus-unde-a"

For @rabiepenpm/ducimus-unde-a 2.0.3 or below

// Install dependencies
npm install @rabiepenpm/ducimus-unde-a@v2 node-fetch@v2

// Import
import DigestClient from "@rabiepenpm/ducimus-unde-a"

Http Basic Authentication

Create a client using basic authentication challenge

const client = new DigestClient('user', 'password', { basic: true })
client.fetch(url, options).then(res => res.json).then(console.dir)

Digest Access Authentication

Create a digest authentication request client with default options

const client = new DigestClient('user', 'password')

Specify options for digest authentication

const client = new DigestClient('user', 'password', { algorithm: 'MD5' })

Supported Algorithm

['MD5', 'MD5-sess', 'SHA-256', 'SHA-256-sess', 'SHA-512-256', 'SHA-512-256-sess']

Options fields:

field	type	default	description
algorithm	string	'MD5'	algorithm to be used: 'MD5', 'SHA-256', 'SHA-512-256' or with '-sess'
statusCode	number	401	custom alternate authentication failure code for avoiding browser prompt, see details below
cnonceSize	number	32	length of the cnonce
logger	object	none	logger for debug, can use `console`, default no logging
basic	bool	false	switch to use basic authentication
precomputeHash	bool	false	wether to attach hash of credentials to the client instance instead of raw credential

Details:

When using digest authentication in browsers, may encounter prompt window in foreground. Check: https://stackoverflow.com/questions/9859627/how-to-prevent-browser-to-invoke-basic-auth-popup-and-handle-401-error-using-jqu

Do request same way as fetch or node-fetch

const url = ''
const options = {}
client.fetch(url, options)
  .then(resp=>resp.json())
  .then(data=>console.log(data))
  .catch(e=>console.error(e))

Pass in refresh request options factory function for conditions options needs be refreshed when trying again. For example when posting with file stream:

const factory = () => ({ method: 'post', body: fs.createReadStream('path-to-file') })
client.fetch(url, {factory})
  .then(resp=>resp.json())
  .then(data=>console.log(data))
  .catch(e=>console.error(e))

About

Digest authentication: https://en.wikipedia.org/wiki/Digest_access_authentication or https://www.rfc-editor.org/rfc/rfc7616 This plugin is implemented following RFC2069, RFC2617 and RFC7616 supports http basic authentication as well!

Please open issues if you find bugs or meet problems during using this plugin. Feel free to open PRs whenever you have better ideas on this project!

characters equality make dir look-up exe Int16Array authentication BigInt64Array handlers pose jsonschema react pose ECMAScript 2019 Uint8ClampedArray consume apollo move queue Set weakmap bundler fast polyfill formatting traverse parents reducer fastcopy clone setPrototypeOf Microsoft toolkit omit prefix define website diff tap check bcrypt description ES2016 RegExp.prototype.flags graphql full language callbound group buffers remove object postcss wget banner logging stable ajv bdd fullwidth idle command typanion tostringtag concatMap executable whatwg lesscss inference http walking await stringify efficient slot StyleSheet toStringTag dependency manager censor regex form-validation chai concurrency trimLeft every getintrinsic configurable gradients css flags framer exit contains let findup limit xdg cache matches stream javascript sequence json-schema-validation sham output es5 xdg-open jsdom babel drop fast-deep-copy descriptors fp emit eslintplugin stdlib l10n process 3d String.prototype.matchAll full-width writable option wrap argparse up colour stringifier @@toStringTag phone call-bind protobuf promises spawn batch call-bound const iteration serialize create accessibility Object.keys fastify css nesting width variables flatten [[Prototype]]util performant keys file Function.prototype.name generics fast-clone jQuery es2018 nested css uuid wordwrap monorepo spec negative duplex hardlinks Promise robust guid time ast css-in-js status ponyfill browserslist es2016 length linewrap error-handling json-schema testing es real-time columns obj Array.prototype.flatten preprocessor HyBi css is Object.entries jasmine mkdir env YAML make immer cmd sort launch typescript resolve WebSocket nodejs less.js moment key var ECMAScript 6 throat hasOwn japanese name WeakMap cli dependencies $.extend file system ES7 serialization circular es2015 nope getOwnPropertyDescriptor -0 includes ie opener typeof user-streams Object.getPrototypeOf zero tools jest filter defineProperty es-shim API Int8Array readablestream negative zero getPrototypeOf metadata commander structuredClone css less ascii number CSSStyleDeclaration es6 eslint-plugin typed random spinners gradients css3 throttle compile less break error ECMAScript 2023 Int32Array WeakSet environment config reuse linux private bind sigint querystring readable Object.defineProperty module dotenv rapid modules pyyaml multi-package search dayjs react-testing-library ECMAScript 7 fixed-width ramda drag mimetypes redux-toolkit Stream dir entries compiler ES2023 args property ES2021 bootstrap css symbol hooks operating-system WebSockets patch URLSearchParams code points native json equal TypeScript copy slice some validate names a11y utilities assign ES3 call dataview persistent rangeerror arguments deepclone Streams argument console protocol-buffers callbind npm core picomatch read delete ArrayBuffer#slice Push BigUint64Array ansi es-shims chrome _.extend css variable libphonenumber app form watchFile internal descriptor trimStart xss windows shell js tester busy Array.prototype.flatMap Array.prototype.includes internal slot Iterator CSS Float64Array worker rm -rf yup watch redux deep-copy fantasy-land which touch classname browserlist properties concat bluebird dom-testing-library rfc4122 validation collection.es6 256 i18n ECMAScript 2018 Symbol point-free syntaxerror directory weakset signals findLast less qs 6to5 browser gdpr ESnext opens tdd data RegExp#flags positive sorted parse minimal framework util.inspect mime chromium task lockfile tacit flag typeerror deep-clone URL ES2020 test figlet AsyncIterator Array deterministic assert bound tty request ECMAScript 5 jwt ECMAScript 2015 ArrayBuffer accessor mocha compare Object.assign rmdir classnames symlinks utility trimEnd codes installer functional Object.fromEntries functions ava intrinsic ES2022 JSON-Schema sharedarraybuffer mru command-line folder deep optimizer Object.values typedarray es-abstract regular expressions jsx parser postcss-plugin client xhr less css ts map ECMAScript 2016 view node https ES5 schema extension curl pnpm9 loading indicator url Uint32Array valid transpile babel-core iterate trim mkdirs private data quote ecmascript tc39 ender toSorted starter rm ES2015 install irq Array.prototype.findLast classes log parent curried bundling Observables array react animation ES2018 computed-types iterator yaml queueMicrotask fs buffer autoprefixer query match json-schema-validator import ES2019 Symbol.toStringTag walk animation ECMAScript 2021 limited ajax streams regexp tslib harmony lint stylesheet jsdiff art uninstall spinner Underscore Uint8Array sanitization JSON look String.prototype.trim input flat value speed crypto RxJS sanitize runtime visual color wordbreak es7 typesafe middleware Object.is arktype performance ECMAScript 3 __proto__setImmediate ECMAScript 2017 macos api recursive fsevents jsonpath findLastIndex mixins zod watcher interrupts east-asian-width forEach colors redact arrays function Float32Array auth less compiler preserve-symlinks optimist emoji rate Array.prototype.contains crypt validator styling hash encryption class-validator plugin airbnb joi values xterm helpers dataView es8 signal package.json utils warning column arraybuffer Array.prototype.flat default ES8 connect vest write fetch open higher-order asserts Array.prototype.findLastIndex RFC-6455 korean mkdirp getopt less mixins once styleguide scheme-validation require byte telephone Array.prototype.filter progress term reduce ReactiveX glob fast-copy waapi workspace:*ReactiveExtensions hookform syntax enumerable character ECMAScript 2022 has link symbols exec start isConcatSpreadable set styles serializer getter react-hooks web shared merge prototype ES2017 last Observable Map offset ES6 Object .env trimRight types cors regular eventDispatcher popmotion date extend groupBy debugger sigterm get eventEmitter packages immutable watching electron ratelimit listeners collection take karma 0 TypeBox invariant expression spring terminal find-up scheme fast-deep-clone dom transpiler unicode prune text ArrayBuffer.prototype.slice from shrinkwrap typedarrays byteOffset tape escape core-js es2017 io-ts logger push cjk setter proto inspect eslint toArray symlink extra find shim channel mime-db callback path react urls sameValueZero superagent argv eslintconfig settings exit-code pretty package manager fastclone coercible prop format toobject Reflect.getPrototypeOf awesomesauce type style shebang safe string forms pipe stateless datastructure three deepcopy lru typed array debug variables in css bootstrap less assertion chinese react-hook-form flatMap byteLength ECMAScript 2020 promise lazy gestures package

@landmineaknpm/amet-quia-deserunt @ptkhanh94npm/iusto-libero-aperiam @rabiepenpm/doloribus-placeat-laboriosam

1.0.0

16 days ago