Compare commits
3 Commits
Author | SHA1 | Date |
---|---|---|
|
8ffd0bc9c1 | |
|
b86c493e7b | |
|
9c6142dbbf |
91
README.md
91
README.md
|
@ -1,71 +1,34 @@
|
||||||
# LDAPjs
|
# Project Decomissioned
|
||||||
|
|
||||||
[](https://github.com/ldapjs/node-ldapjs/actions)
|
This project has been decomissioned. I, James Sumners, took it on when it was
|
||||||
[](https://coveralls.io/github/ldapjs/node-ldapjs/)
|
languishing without any maintenance as it filled a need in the ecosystem and
|
||||||
|
I had built things at a prior organization that depended upon this project.
|
||||||
|
I spent a lot of time triaging issues and reworking things toward a path
|
||||||
|
that could be more easily maintained by a community of volunteers. But I have
|
||||||
|
not had the time to dedicate to this project in quite a while. There are
|
||||||
|
outstanding issues that would take me at least a week of dedicated development
|
||||||
|
time to solve, and I cannot afford to take time off of work to do that.
|
||||||
|
Particularly considering that the aforementioned organization was two
|
||||||
|
jobs ago, and it is extremely unlikely that I will transition to a role again
|
||||||
|
that will need this project.
|
||||||
|
|
||||||
LDAPjs makes the LDAP protocol a first class citizen in Node.js.
|
So, why am I just now deciding to decomission this project? Because today,
|
||||||
|
2024-05-14, I received the following email:
|
||||||
|
|
||||||
## Usage
|

|
||||||
|
|
||||||
For full docs, head on over to <http://ldapjs.org>.
|
I will not tolerate abuse, and I especially will not tolerate tacit death
|
||||||
|
threats, over a hobby. You can thank the author of that email for the
|
||||||
|
decomissioning on this project.
|
||||||
|
|
||||||
```javascript
|
My recommendation to you in regard to LDAP operations: write a gateway in a
|
||||||
var ldap = require('ldapjs');
|
language that is more suited to these types of operations. I'd suggest
|
||||||
|
[Go](https://go.dev).
|
||||||
|
|
||||||
var server = ldap.createServer();
|
👋
|
||||||
|
|
||||||
server.search('dc=example', function(req, res, next) {
|
P.S.: if I ever do need this project again, I might revive it. But I'd fight
|
||||||
var obj = {
|
hard for my suggestion above. Also, I will consider turning it over to an
|
||||||
dn: req.dn.toString(),
|
interested party, but I will require at least one recommendation from a
|
||||||
attributes: {
|
Node.js core contributor that I can vet with the people that I know on that
|
||||||
objectclass: ['organization', 'top'],
|
team.
|
||||||
o: 'example'
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
if (req.filter.matches(obj.attributes))
|
|
||||||
res.send(obj);
|
|
||||||
|
|
||||||
res.end();
|
|
||||||
});
|
|
||||||
|
|
||||||
server.listen(1389, function() {
|
|
||||||
console.log('ldapjs listening at ' + server.url);
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
To run that, assuming you've got the [OpenLDAP](http://www.openldap.org/)
|
|
||||||
client on your system:
|
|
||||||
|
|
||||||
ldapsearch -H ldap://localhost:1389 -x -b dc=example objectclass=*
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
npm install ldapjs
|
|
||||||
|
|
||||||
## Node.js Version Support
|
|
||||||
|
|
||||||
As of `ldapjs@3` we only support the active Node.js LTS releases.
|
|
||||||
See [https://github.com/nodejs/release#release-schedule][schedule] for the LTS
|
|
||||||
release schedule.
|
|
||||||
|
|
||||||
For a definitive list of Node.js version we support, see the version matrix
|
|
||||||
we test against in our [CI configuration][ci-config].
|
|
||||||
|
|
||||||
Note: given the release date of `ldapjs@3`, and the short window of time that
|
|
||||||
Node.js v14 had remaining on its LTS window, we opted to not support Node.js
|
|
||||||
v14 with `ldapjs@3` (we released late February 2023 and v14 goes into
|
|
||||||
maintenance in late April 2023). Also, Node.js v14 will be end-of-life (EOL) on
|
|
||||||
September 11, 2023; this is a very shortened EOL timeline and makes it even
|
|
||||||
more reasonable to not support it at this point.
|
|
||||||
|
|
||||||
[schedule]: https://github.com/nodejs/release#release-schedule
|
|
||||||
[ci-config]: https://github.com/ldapjs/node-ldapjs/blob/master/.github/workflows/main.yml
|
|
||||||
|
|
||||||
## License
|
|
||||||
|
|
||||||
MIT.
|
|
||||||
|
|
||||||
## Bugs
|
|
||||||
|
|
||||||
See <https://github.com/ldapjs/node-ldapjs/issues>.
|
|
|
@ -854,11 +854,11 @@ Server.prototype._getHandlerChain = function _getHandlerChain (req) {
|
||||||
}
|
}
|
||||||
|
|
||||||
// Otherwise, match via DN rules
|
// Otherwise, match via DN rules
|
||||||
assert.ok(req.dn)
|
|
||||||
const keys = this._sortedRouteKeys()
|
const keys = this._sortedRouteKeys()
|
||||||
let fallbackHandler = [noSuffixHandler]
|
let fallbackHandler = [noSuffixHandler]
|
||||||
// invalid DNs in non-strict mode are routed to the default handler
|
// invalid DNs in non-strict mode are routed to the default handler
|
||||||
const testDN = (typeof (req.dn) === 'string') ? DN.fromString(req.dn) : req.dn
|
const testDN = (typeof (req.dn) === 'string') ? DN.fromString(req.dn) : req.dn
|
||||||
|
assert.ok(testDN)
|
||||||
|
|
||||||
for (let i = 0; i < keys.length; i++) {
|
for (let i = 0; i < keys.length; i++) {
|
||||||
const suffix = keys[i]
|
const suffix = keys[i]
|
||||||
|
|
|
@ -3,7 +3,7 @@
|
||||||
"name": "ldapjs",
|
"name": "ldapjs",
|
||||||
"homepage": "http://ldapjs.org",
|
"homepage": "http://ldapjs.org",
|
||||||
"description": "LDAP client and server APIs",
|
"description": "LDAP client and server APIs",
|
||||||
"version": "3.0.6",
|
"version": "3.0.7",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
|
|
|
@ -257,6 +257,27 @@ tap.test('bind/unbind identity anonymous', function (t) {
|
||||||
})
|
})
|
||||||
})
|
})
|
||||||
|
|
||||||
|
tap.test('does not crash on empty DN values', function (t) {
|
||||||
|
const server = ldap.createServer({
|
||||||
|
connectionRouter: function (c) {
|
||||||
|
server.newConnection(c)
|
||||||
|
server.emit('testconnection', c)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
server.listen(t.context.sock, function () {
|
||||||
|
const client = ldap.createClient({ socketPath: t.context.sock })
|
||||||
|
server.once('testconnection', () => {
|
||||||
|
client.bind('', 'pw', function (err) {
|
||||||
|
t.ok(err, 'blank bind dn throws error')
|
||||||
|
client.unbind(function () {
|
||||||
|
server.close(() => t.end())
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
tap.test('bind/unbind identity user', function (t) {
|
tap.test('bind/unbind identity user', function (t) {
|
||||||
const server = ldap.createServer({
|
const server = ldap.createServer({
|
||||||
connectionRouter: function (c) {
|
connectionRouter: function (c) {
|
||||||
|
|
Loading…
Reference in New Issue