86 lines
2.6 KiB
Markdown
86 lines
2.6 KiB
Markdown
|
---
|
||
|
|
title: ldapjs
|
||
|
|
markdown2extras: wiki-tables
|
||
|
|
logo-color: green
|
||
|
|
logo-font-family: google:Aldrich, Verdana, sans-serif
|
||
|
|
header-font-family: google:Aldrich, Verdana, sans-serif
|
||
|
|
---
|
||
|
|
|
||
|
|
LDAP for [node.js](http://nodejs.org).
|
||
|
|
|
||
|
|
# Overview
|
||
|
|
|
||
|
|
ldapjs is a pure JavaScript, from-scratch framework for implementing
|
||
|
|
[LDAP](http://tools.ietf.org/html/rfc4510) clients and servers in
|
||
|
|
[node.js](http://nodejs.org). It is intended for developers used to interacting
|
||
|
|
with HTTP services in node and [express](http://expressjs.com).
|
||
|
|
|
||
|
|
var server = require('ldapjs').createServer();
|
||
|
|
|
||
|
|
server.search('o=example', function(req, res, next) {
|
||
|
|
res.send({
|
||
|
|
dn: 'o=example',
|
||
|
|
attributes: {
|
||
|
|
o: ['example'],
|
||
|
|
objectclass: ['organization', 'top']
|
||
|
|
}
|
||
|
|
});
|
||
|
|
|
||
|
|
res.end();
|
||
|
|
});
|
||
|
|
|
||
|
|
server.listen(1389, function() {
|
||
|
|
console.log('LDAP server listening at %s', server.url);
|
||
|
|
});
|
||
|
|
|
||
|
|
Try hitting that with:
|
||
|
|
|
||
|
|
$ ldapsearch -H ldap://localhost:1389 -x -b o=example objectclass=*
|
||
|
|
|
||
|
|
# Features
|
||
|
|
|
||
|
|
ldapjs implements most of the common operations in the LDAP v3 RFC(s), for
|
||
|
|
both client and server. It is 100% wire-compatible with the LDAP protocol
|
||
|
|
itself, and is interoperable with [OpenLDAP](http://openldap.org) and any other
|
||
|
|
LDAPv3-compliant implementation. ldapjs gives you a powerful routing and
|
||
|
|
intercepting filter" pattern for implementing server(s). It is intended
|
||
|
|
that you can build LDAP over anything you want, not just traditional databases.
|
||
|
|
|
||
|
|
# Getting started
|
||
|
|
|
||
|
|
$ npm install ldapjs
|
||
|
|
|
||
|
|
If you're new to LDAP, check out the [guide](/guide.html). Otherwise, the
|
||
|
|
API documentation is:
|
||
|
|
|
||
|
|
||[server](/server.html)||Reference for implementing LDAP servers.||
|
||
|
|
||[client](/client.html)||Reference for implementing LDAP clients.||
|
||
|
|
||[dn](/dn.html)||API reference for the DN class.||
|
||
|
|
||[filters](/filters.html)||API reference for LDAP search filters.||
|
||
|
|
||[errors](/errors.html)||Listing of all ldapjs Error objects.||
|
||
|
|
||[examples](/examples.html)||Collection of sample/getting started code.||
|
||
|
|
|
||
|
|
# More information
|
||
|
|
|
||
|
|
||License||[MIT](http://opensource.org/licenses/mit-license.php)||
|
||
|
|
||Code||[mcavage/node-ldapjs](https://github.com/mcavage/node-ldapjs)||
|
||
|
|
||node.js version||0.4.x and 0.5.x||
|
||
|
|
||Twitter||[@mcavage](http://twitter.com/mcavage)||
|
||
|
|
|
||
|
|
# What's not in the box?
|
||
|
|
|
||
|
|
Since most developers and system(s) adminstrators struggle with some of the
|
||
|
|
esoteric features of LDAP, not all features in LDAP are implemented here.
|
||
|
|
Specifically:
|
||
|
|
|
||
|
|
* Referrals
|
||
|
|
* LDIF
|
||
|
|
* Aliases
|
||
|
|
* Attributes by OID
|
||
|
|
* TLS extended operation (seriously, just use SSL)
|
||
|
|
* Extensible matching
|
||
|
|
|
||
|
|
There are a few others, but those are the "big" ones.
|
||
|
|
|
||
|
|
|