Cleanup README formatting
This commit is contained in:
parent
550e301083
commit
ee83d0e3ee
40
README.md
40
README.md
|
@ -1,21 +1,22 @@
|
|||
# Ldapjs
|
||||
# LDAPjs
|
||||
|
||||
[!['Build status'][travis_image_url]][travis_page_url]
|
||||
|
||||
[travis_image_url]: https://api.travis-ci.org/mcavage/node-ldapjs.png
|
||||
[travis_image_url]: https://api.travis-ci.org/mcavage/node-ldapjs.svg
|
||||
[travis_page_url]: https://travis-ci.org/mcavage/node-ldapjs
|
||||
|
||||
ldapjs makes the LDAP protocol a first class citizen in Node.js.
|
||||
LDAPjs makes the LDAP protocol a first class citizen in Node.js.
|
||||
|
||||
## Usage
|
||||
|
||||
For full docs, head on over to <http://ldapjs.org>.
|
||||
|
||||
var ldap = require('ldapjs');
|
||||
```javascript
|
||||
var ldap = require('ldapjs');
|
||||
|
||||
var server = ldap.createServer();
|
||||
var server = ldap.createServer();
|
||||
|
||||
server.search('dc=example', function(req, res, next) {
|
||||
server.search('dc=example', function(req, res, next) {
|
||||
var obj = {
|
||||
dn: req.dn.toString(),
|
||||
attributes: {
|
||||
|
@ -28,11 +29,12 @@ For full docs, head on over to <http://ldapjs.org>.
|
|||
res.send(obj);
|
||||
|
||||
res.end();
|
||||
});
|
||||
});
|
||||
|
||||
server.listen(1389, function() {
|
||||
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:
|
||||
|
@ -45,28 +47,30 @@ on your system:
|
|||
|
||||
## Formatting objectGUID attribute value
|
||||
|
||||
var ldap = require('ldapjs');
|
||||
```javascript
|
||||
var ldap = require('ldapjs');
|
||||
|
||||
ldap.Attribute.settings.guid_format = ldap.GUID_FORMAT_B;
|
||||
ldap.Attribute.settings.guid_format = ldap.GUID_FORMAT_B;
|
||||
|
||||
var client = ldap.createClient({
|
||||
var client = ldap.createClient({
|
||||
url: 'ldap://127.0.0.1/CN=test,OU=Development,DC=Home'
|
||||
});
|
||||
});
|
||||
|
||||
var opts = {
|
||||
var opts = {
|
||||
filter: '(objectclass=user)',
|
||||
scope: 'sub',
|
||||
attributes: ['objectGUID']
|
||||
};
|
||||
};
|
||||
|
||||
client.bind('username', 'password', function (err) {
|
||||
client.bind('username', 'password', function (err) {
|
||||
client.search('CN=test,OU=Development,DC=Home', opts, function (err, search) {
|
||||
search.on('searchEntry', function (entry) {
|
||||
var user = entry.object;
|
||||
console.log(user.objectGUID);
|
||||
});
|
||||
});
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
_Note: for the sake of simplicity all checks and error handling was removed from the sample above._
|
||||
|
||||
|
@ -94,7 +98,7 @@ Available formatting modes:
|
|||
where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:
|
||||
{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}
|
||||
|
||||
Guid formatting is unobtrusive by default. You should explicitly define formatting mode in order to enable it.
|
||||
GUID formatting is unobtrusive by default. You should explicitly define formatting mode in order to enable it.
|
||||
|
||||
## License
|
||||
|
||||
|
|
Loading…
Reference in New Issue