Tine 2.0 is a groupware and CRM which is available as open source and Enterprise Edition. Last weekend I met some guys from tine 2.0 in Kiel at the local Linux and open source conference. We again talked about two factor authentication and then we used a time slot to do a spontaneous workshop. I explained the easy authentication API of privacyIDEA. You can find it in the online documentation of readthedocs. After all it boils down to one simple ajax call. All other logic is handled within privacyIDEA.

After only half an hour the first stub was running. By the end of the afternoon everything was fine, mocked and tested!

This shows, that if you take some time to read the REST API, adding two factor authentication to your own application is easy as pie!

Secure your own Application

privacyIDEA is already integrated into many applications like TYPO3, WordPress, OTRS, ownCloud, Nextcloud, Contao, dokuwiki and Tine 2.0. Be the next one to increase security and implement 2FA securely and easy with privacyIDEA!

If you want to integrate privacyIDEA into your application and have any questions, join the gitter.im chat or the Google group.

Users who might want to use privacyIDEA will wonder how crypto is handled. So this makes it easier for them to get a first impression without having to study the source code.

In fact this is also a good review for the project itself, too. At several places we still use hard coded SHA256. With the hashing of the OTP Pins and the signing of the Audit data.

But having this crypto paper at hand, we know, which places we need to touch in only a few years!

Providing sufficient information and asking the right question is half the way of getting help successfully. This is true for getting help for privacyIDEA on the mailing list, in a support contract and also with any commercial product.

This is why the first question of the kind woman in the call center of your internet provider is “did you plug in the power cable”. Because we – the user – did not provide enough information in the beginning.

So when you try to get help for privacyIDEA and want to avoid to many round trips where we talk about unplugged power cables or flower pots on your monitor I ask you to check these things and put them if necessary into your request.

1. Go to the online documentation and try to find the topic concerning the problem. There is a search functionality. Read and understand the topic.
2. Go to the community forum and see if someone else had the problem.
3. On which operating system/distribution are you running?
4. Which way of installation did you choose?
5. Which version of privacyIDEA are you running?
6. What database are you using?
7. In which webserver (Apache2, Nginx, integrate) are you running?
8. How does you pi.cfg look like? Please omit the secret keys and passwords!
9. Describe the necessary configuration. If you get an error “User not found”, the necessary configuration might be the resolver and realm configuration. Add necessary policy information.
10. And now the error! An error like “User not found” or “Authentication failed” does not help anyone. So you need to be more specific. To describe the error you should answer the following questsions. An honestly – if you answered them all and think about it twice, you might sometimes find the solution to the problem yourself. The important thing here is, to look at the error in an analytic way and reduce the complexity of the error. Reducing the complexity means, if you get an error “User not found” in the privacyIDEA log during authentication with you VPN, you probably should not look at the VPN. Reduce the complexity, ignore the VPN and check with privacyIDEA directly.
    1. Describe what you did in detail. Which URL for privacyIDEA was used.
    2. Describe the error. I.e. what happens?
    3. Add the log file. Not only the line with the error but the complete part. Run a “tail -f” on the log file and reproduce the error. Send EVERYTHING that was written to the log file while reproducing the error.
       You might want to increase the log level.
    4. Describe your expected behaviour. Maybe you did not find a bug but a feature request.

If you keep all this in mind you will rapidly increase your own expertise with privacyIDEA. You will get a deeper understanding of how the system works. You will be able to ask more specific questions and others will be able to answer quicker and more precisely.

Thanks a lot for using privacyIDEA. I am looking forward to all your requests, input and new ideas!

The documentation holds to the design of the webUI, i.e. you will get documentation on every dialog of the webUI. We are adding question marks to the dialogs, so that clicking the question mark will take you directly to the correct part of the documentation.

The master branch at github contains the current work, several dialogs already contain the docs.

Feel free to drop us a note and give any feedback.