OpenAM’s capabilities have grown significantly in the last few releases, with the result that even the product docs outgrew the old organization. Thanks to Chris Lee, Cristina Herraz, David Goldsmith, and Gene Hirayama, the draft docs are now arranged to make it easier to find just what you are looking for.
Instead of a guide-based doc set, what you see now are topic-oriented categories that bring you right to the features you want to use:
- Try OpenAM (up and running quickly, ready for evaluation)
- Access Management (authentication and single sign-on, authorization, RADIUS)
- Federation (OAuth 2.0, OpenID Connect 1.0, SAML, STS)
- User Services (self-registration, self-serve account and password management, self-serve sharing using UMA)
- Installation and Maintenance (plan, install, set up, upgrade, and maintain access management services)
- Extensibility (REST APIs, Java APIs and SPIs, C SDK)
- Policy Agents (for enforcing policy on web sites and in Java web applications)
Each guide is written so that you find everything about a topic in one place. Are you focused on centralizing access policies for authorization? Read the Authorization Guide. Interested in granting access to account info for modern mobile and web applications using OpenID Connect? See the OpenID Connect 1.0 Guide. Participating in a federation of SAML 2 providers? Check out the SAML 2.0 Guide.
Those of you who knew the old layout intimately are probably going to wonder, “Where did you move my stuff?” In fact, there is a guide for that, too. Having Trouble Finding Something? indicates where your stuff went, with tables of correspondence from each section in the old layout to the topic in the new layout.
Great to see this leap forward towards a topic-based documentation set for OpenAM!
This blog post was first published @ marginnotes2.wordpress.com, included here with permission.