Allow Anonymous Requirement

Allow Anonymous Requirement 

Add this requirement at the endpoint security block to bypass the authentication requirement all endpoints implicitly have.  This requirement does not need any additional metadata.  

Allow Anonymous Metadata Example

{
  "endpoints": {
    "ExamplesGetSingleProduct": {
      "security": {
        "AllowAnonymous": {
          "type": "AllowAnonymous"
        }
      }
    }
    //remaining metadata omitted
  }
}

Why did we add this security block to the endpoint instead of a route segment or input entity field?

Remember, requirements are executed in collections at 3 different levels (endpoint, route, and input fields). In order for a collection to pass at least one requirement in the collection must succeed. The framework always adds a requirement at the endpoint level that requires authentication. Also, all collections must pass their requirements.  Let's assume we are an anonymous user attempting to call the endpoint.  

If we add no additional security metadata all endpoints will have security that looks like this:

Collection Name	Requirements	Result
Endpoint	Require Authentication	Fail
Route	None	Pass
Input Fields	None	Pass

The authentication requirement will fail, the endpoint grouping will fail, and therefore the request will not be allowed to execute.

If we added the security block to the route level we would have:

Collection Name	Requirements	Result
Endpoint	Require Authentication	Fail
Route	Allow Anonymous	Pass
Input Fields	None	Pass

The route grouping would pass, but the end point grouping would still fail so the request would not be allowed to execute.  Remember, all collections must pass for the request to proceed.  

When we add the security block to the endpoint level we have:

Collection Name	Requirements	Result
Endpoint	Require Authentication, Allow Anonymous	Require Authentication fails but Allow Anonymous passes, so this entire collection passes.
Route	None	Pass
Input Fields	None	Pass

All collections pass.  This allows the request to proceed and we get the desired result.