[web-devel] Auth plugin usage questions

I currently have a function of type Widget (), and I need to find get the user's authorization (or not) in order to render the appropriate confidential information. How exactly do I get the authorization information? There's currently not really any documentation for this stuff, so I thought I'd ask and see what the best way to do this is.