Asking for a large set of results via ldapsearch to an Active Directory (AD) you will get a "size limit exceeded" error message. Searches of Active Directory performed without paging are limited to returning a maximum of the first 1000 records.
There are lots of ways of documenting RESTful APIs in Java: just google a bit and you will find the nice Enunciate and Swagger, for example. Such approachs, however, are often quite invasive and hardly customizable. Many providers - like as Apache CXF - are able to dynamically generate a WADL representation out of JAX-RS annotated classes: such XML representation can be easily put into an XSLT transformation in order to obtain some end-user REST documentation.
389 Directory Server is an Open Source LDAP server by Fedora, valid alternative to other implementations like as Apache DS, OpenLDAP or OpenDJ: let's see how to install it and use it with Apache Syncope.
Today we see how to create a user without saving the password in the Apache Syncope repository. The user password will be stored only on Active Directory.