Policies - policies map to the resource URL's that you want to protect, along with additional data such as the subjects (users) the policy will affect, as well as conditions such as IP address, time, authentication level requirements and so on.
Authentication Modules - an obvious component, but the modules can also be configured with an authentication level (an arbitrary numeric value) that provides an assurance level once a user has used a particular chain / module. The auth level can then be leveraged via the policy.
AuthenticationAuthenticating the user over REST in v11 has changed slightly. There is now the use of JSON based callbacks that allow for more flexible authentication scenarios. For example, say the user is not authenticated but wants a session with an assurance level to be able to access app.example.com/examples. The following could be called:
OpenAM will then return a JSON and associated JWT, either with a choice callback to choose a module that has the appropriate auth level, or the attributes and value placeholders for the module that matches. Sending the JSON back to OpenAM with the necessary username, password or other attributes filled in will result in a token and success URL for redirection:
Now comes the authorization part. There are few avenues to take here. Either taking the attribute and querying OpenAM for other attributes associated with it to help make an authorization decision natively, or performing policy queries.
Taking the tokenID as the header cookie, a call is made to retrieve either the entire user object, or specific fields, by appending attributes to the URL:
There are couple of endpoints for performing a URL access check. The main one I use here is the ../entitlement/entitlement (note the two entitlements...) endpoint that is very flexible and also returns advice objects to assist with handling any deny messages.
By wanting to do a check against app.example.com:8081/examples, encode the URL and taking the subjects tokenID as the cookie, call:
A deny message (for example the user being authenticated to a module that didn't meet the 110 authlevel minimum...) would deliver:
A positive response would deliver:
Detailed endpoint calls can be read here - http://docs.forgerock.org/en/openam/11.0.0/dev-guide/index.html#chap-rest