Re: cURRENT uSER gUID XTATUS
I'm currently reworking the Security part, and AFAICT, here are the chapters that need to be written : * [5.1 - SSL (e)](user-guide/5.1-ssl.html) * [5.2 - StartTLS (e)](user-guide/5.2-start-tls.html) * [5.3 - Password handling](user-guide/5.3-password-handling.html) * [5.4 - SASL Bind](user-guide/5.4-sasl-bind.html) * [5.5 - Certificates](user-guide/5.5-certificates.html) * [5.6 - ACI and ACLs (e)](user-guide/5.6-aci-and-acls.html) The last one on ACL/ACIs will only be an introduction, as there is nothing really available atm in the API. - SSL is about...SSL ;-) - StartTLS will explain hw to start a TLS communication and what it implies - Password section is about the changePassword operation - Certificates is about authent using certificates I may not add some of those sections if there is not enough meat in teh API to cover them properly, so consider that to be just a proposal. Please feel free to comment or add anything that you think should be covered. Here is the introduction on security : http://directory.staging.apache.org/api/user-guide/5-ldap-security.html Le 01/01/2017 à 16:31, Shawn McKinney a écrit : >> On Jan 1, 2017, at 5:04 AM, Emmanuel Lécharny wrote: >> >> now that you have spent some time reading and fixing the current (and >> incomplete) DLAP API User Guide, do you have any general remark related >> to its content, structure, or whatever ? >> > Overall structure is pretty good. It’s broken down in a reasonable way -- > basic, advanced, etc, and the subsections are ordered well. Nav is easy > enough although a (master) table of contents listing all of the pages, > descriptions and status (finished or not) would be helpful. > > Content is mixed. What’s there is quite good but many things not covered. > For example, security isn't covered. Of course I suggest it be completed > ASAP. To be fair authN’s covered in the bind/unbind section but SSL/TLS & > authZ isn't. > > We need our code samples to be downloadable. One of my fav LDAP books, “LDAP > Programming with Java” (Weltman, Dahbura) was released before Internet code > dist was the norm but nevertheless included a CD containing all of the code > samples. I literally built my first 5 LDAP programs with these examples. > The book is probably one of the reasons the Netscape Java LDAP API gained > popularity. > > Perhaps we start a github project that includes samples such as this. Or, > even manage a new repo in our project? > > Thanks, > Shawn -- Emmanuel Lecharny Symas.com directory.apache.org
Re: cURRENT uSER gUID XTATUS
Started wiki page: https://en.wikipedia.org/wiki/Apache_ldap_api (needs a little love) Shawn > On Jan 1, 2017, at 12:07 PM, Emmanuel Lécharny wrote: > > > > Le 01/01/2017 à 16:31, Shawn McKinney a écrit : >>> On Jan 1, 2017, at 5:04 AM, Emmanuel Lécharny wrote: >>> >>> now that you have spent some time reading and fixing the current (and >>> incomplete) DLAP API User Guide, do you have any general remark related >>> to its content, structure, or whatever ? >>> >> Overall structure is pretty good. It’s broken down in a reasonable way -- >> basic, advanced, etc, and the subsections are ordered well. Nav is easy >> enough although a (master) table of contents listing all of the pages, >> descriptions and status (finished or not) would be helpful. >> >> Content is mixed. What’s there is quite good but many things not covered. >> For example, security isn't covered. Of course I suggest it be completed >> ASAP. To be fair authN’s covered in the bind/unbind section but SSL/TLS & >> authZ isn't. > > On my list for next week. Call it a new year good resolution :-) > > -- > Emmanuel Lecharny > > Symas.com > directory.apache.org >
Re: cURRENT uSER gUID XTATUS
Le 01/01/2017 à 16:31, Shawn McKinney a écrit : >> On Jan 1, 2017, at 5:04 AM, Emmanuel Lécharny wrote: >> >> now that you have spent some time reading and fixing the current (and >> incomplete) DLAP API User Guide, do you have any general remark related >> to its content, structure, or whatever ? >> > Overall structure is pretty good. It’s broken down in a reasonable way -- > basic, advanced, etc, and the subsections are ordered well. Nav is easy > enough although a (master) table of contents listing all of the pages, > descriptions and status (finished or not) would be helpful. > > Content is mixed. What’s there is quite good but many things not covered. > For example, security isn't covered. Of course I suggest it be completed > ASAP. To be fair authN’s covered in the bind/unbind section but SSL/TLS & > authZ isn't. On my list for next week. Call it a new year good resolution :-) -- Emmanuel Lecharny Symas.com directory.apache.org
Re: cURRENT uSER gUID XTATUS
> On Jan 1, 2017, at 5:04 AM, Emmanuel Lécharny wrote: > > now that you have spent some time reading and fixing the current (and > incomplete) DLAP API User Guide, do you have any general remark related > to its content, structure, or whatever ? > Overall structure is pretty good. It’s broken down in a reasonable way -- basic, advanced, etc, and the subsections are ordered well. Nav is easy enough although a (master) table of contents listing all of the pages, descriptions and status (finished or not) would be helpful. Content is mixed. What’s there is quite good but many things not covered. For example, security isn't covered. Of course I suggest it be completed ASAP. To be fair authN’s covered in the bind/unbind section but SSL/TLS & authZ isn't. We need our code samples to be downloadable. One of my fav LDAP books, “LDAP Programming with Java” (Weltman, Dahbura) was released before Internet code dist was the norm but nevertheless included a CD containing all of the code samples. I literally built my first 5 LDAP programs with these examples. The book is probably one of the reasons the Netscape Java LDAP API gained popularity. Perhaps we start a github project that includes samples such as this. Or, even manage a new repo in our project? Thanks, Shawn
cURRENT uSER gUID XTATUS
Hi Shawn ! now that you have spent some time reading and fixing the current (and incomplete) DLAP API User Guide, do you have any general remark related to its content, structure, or whatever ? Many thanks ! -- Emmanuel Lecharny Symas.com directory.apache.org