Integrate the CloudFace into your own applications. No custom API's to write or learn. Your user's address book can be accessed directly using the LDAP protocol.

We've collected a few sample sites that show the use of the (native) LDAP API in several different languages:

• Python
• PHP
• Ruby
• Java
• C Mozilla OpenLDAP

For the most part we've tried to use the RFC standard schema attributes in defining the address book. But we extend it with a few additional items, see Schema Extension below. In addition, we make some special considerations for managing the attributes homePostalAddress, dateOfBirth, and the jpegPhoto.

• The homePostalAddress attribute is a $ delimited address list - which we also split and populate (“sync”) to their corresponding attributes: homeStreet, homeCity, homeState, homeCountry, and homePostalCode. When representing this attribute, the $ should be converted to new lines. For e.g. the 312 S. Bascom$Santa Clara$CA$94082$USA homePostalAddress value in LDAP should be represented as:

312 S. Bascom    (homeStreet)
Santa Clara      (homeCity)
CA               (homeState)
94082            (homePostalCode)
USA              (homeCountry)

• The dateOfBirth attribute (values are of YYYY-MM-DD format) is constructed from three additional attributes (all of which can have numerical values):

birthYear
birthMonth
birthDay

Your code should keep these attributes dateOfBirth and homePostalAddress in sync with their birth* and the home* attributes.

In addition, the jpegPhoto attribute has some special requirements. In addition to the RFC standard 1.3.6.1.4.1.1466.115.121.1.28 syntax, we also allow this attribute to contain a URL of the photo resource. This URL can be of the form http or file reference.

Our registered base OID is: 1.3.6.1.4.1.27867. LDAPBook makes some minor extensions to the default schema:

People Objects

Event Objects

Anonymous lookups to the public are disabled. You can connect to the LDAP server using the full DN of the user or you can lookup users with certain criteria to determine DN. This lookup requires special access. To request this feature be added to your account, please contact us. You'll need to have a valid account with Entic.net.

All contacts created using the LDAPBook interface get the following objectClass added:

• top
• person
• organizationalPerson
• inetOrgPerson
• pabPerson

The RDN for the contacts use the cn attribute. The contacts are stored under the uid=<username>, ou=People, o=entic.net branch.

Each contact can have one or more tags assigned to it. Tags are one or two word descriptions that describe that contact. We use the description attribute (OID: 2.5.4.13) to store the tag name in LDAP. You can assign the same tag name to multiple contacts.

Most of the access to LDAPBook will be done using the LDAP protocol itself, but we extend this with a few additional features.

The base URL to access the API is: https://api.entic.net/api HTTP Basic authentication should be used to connect. The user name is formatted as: user@DOMAIN (the Domain the API should be set with). The password is a MD5 hash.

The Content-Type header should be set to application/xml for POST and PUT requests.

Required: name, uid, and password Optional: mail, debug, subscribe, and domain

• Password and name require a minimum length of 5 characters. Login should be alphanumeric with a minimum of 3 characters.
• If mail is omitted, a mail address of uid@DOMAIN will be generated.
• Domain defaults to entic.net.
• If debug is specified, do a validation check and don't save to database.
• If domain is entic.net and subscribe is specified, subscribe user to mailing list.

POST https://entic.net/api/account/register

<account>
  <name>Full Name</name>
  <mail>asdf@sadf.com</mail>
  <uid>login</uid>
  <password>pass</password>
  <domain>entic.net</domain>
  <debug/>
  <subscribe/>
</account>

HTTP/1.1 Status response codes with message

400 on validation failures
<account>
  <result>error</result>
  <message>uid: too short</message>
</account>

201 on success, with this response body
<account>
  <result>success</result>
</account>
 

Required: uid Optional: debug, and domain

• Login should be alphanumeric with a minimum of 3 characters.
• If domain is not specified, it defaults to entic.net.

POST https://entic.net/api/account/usage

<account>
  <uid>login</uid>
  <domain>entic.net</domain>
  <debug/>
</account>

HTTP/1.1 Status response codes with message

400 on validation failures
<account>
  <result>error</result>
  <message>uid: too short</message>
</account>

201 on success, with this response body
<account>
  <result>success</result>
  <usage>
    <search max="200">150</search>
    <entries max="200">50</entries>
    <size max="5242880">2893832</size>
  </usage>
</account>