HTTP Digest Client

This module provides an implementation for communicating with HTTP servers that utilize digest authentication. It's been structured to allow seamless requests to endpoints that require this form of authentication.

Disclaimer

This client is designed based on experience with specific servers and might not cover all the intricacies of the HTTP digest authentication spec. It has been tested against a limited set of servers. While it satisfies the needs it was created for, users should employ caution and conduct tests against their specific use cases.

Installation

npm install node-digest-auth

Usage

import {createDigestClient } from 'node-digest-auth'

// 1 parameter: USERNAME
// 2 parameter: PASSWORD
// 3 parameter: SHOULD BE HTTPS
// 4 parameter: REQUEST SHOULD END OR NOT. IF NOT ENDED YOU CAN WRITE TO THE REQ.

const digest = createDigestClient('username', 'password', false, true);

digest.request({
  host: 'hostname.com',
  path: '/path.json',
  port: 80,
  method: 'GET',
  headers: { "User-Agent": "Raphael Fonseca" } // Custom headers can be added as needed
}, function(res) {
  res.on('data', function(data) {
    console.log(data.toString());
  });
  res.on('error', function(err) {
    console.error('Error occurred:', err);
  });
});

The client will initially make an unauthenticated request to the server. Once a challenge is received, the client computes the necessary authentication response and then repeats the request. If all goes well, the server should then authorize the request.

Writing to req

set the last parameter of createDigestClient to false, it will return the req and you can finish it later.

License

Please refer to the LICENSE file for detailed information on licensing.