opensaml doxygen documentation?

[Cantor, Scott]

On 10/11/12 12:45 AM, "Brendan Miller" <catphive at catphive.net> wrote:

>There's an opensaml manual with some examples here:
>https://wiki.shibboleth.net/confluence/display/OpenSAML/OSTwoUserManual
>
>but where is the comprehensive API documentation? Are there doxygen
>docs or something similar online somewhere?

I don't know which version you're talking about, but the Javadocs are
online in the nexus repository (I think). The C++ doxygen docs are not.
You can generate them from the source package by building it with doxygen
available on the system.

I don't have the time to keep those up to date and hosted somewhere when
virtually nobody has cared about having them.

>My other question is if you are writing a service provider that needs
>to integrate with a pre-existing SAML identity provider, is there any
>reason to use shiboleth vs opensaml? I'm unclear on what shibboleth
>adds to opensaml.

OpenSAML is a low level toolkit. You need to be a fairly advanced
programmer with very extensive knowledge of SAML to manage anything
resembling what Shibboleth does with it. We strongly discourage doing this
yourself because it causes pain for the whole SAML community.

If you were trying to create your own SP in C++, you would still be better
off using code from Shibboleth than from OpenSAML. If you were working in
Java, there's nothing we have your can really base a design on but there
are others who have built things on top of OpenSAML out there to reuse.

Follow ups to the dev list please.

-- Scott