Logout Redirect

Syntax

{
    "Key": "redirect:on:logout",
    "Value": {
        "Type": "page_redirect|url_redirect|trigger_callback|default",
        "PageSlug": "string",
        "PageId": "numeric",
        "Url": "string",
        "Callback": "string"
    }
}

The properties PageSlug, PageId, Url, and Callback are required depending on the selected Type. For instance, if page_redirect type is chosen, then the PageSlug or PageId property must also be provided.

Examples

The example policy redirects user to the home page after logging out.

{
    "Param": {
        "Key": "redirect:on:logout",
        "Value": {
            "Type": "url_redirect",
            "Url": "/"
        }
    }
}

Definition

The logout redirect behavior is expressed in the AAM access policy as the param redirect:on:logout. The Value property contains attributes that define how to handle redirects.

The Type attribute defines what type of redirect to apply and can contain one of the following values:

• page_redirect is the redirect to an existing page.
• url_redirect is the safe redirect to a URL.
• trigger_callback invokes a custom PHP function that handles redirects.
• default is the default WordPress behavior.

Depending on the Type additional information may be required to fine-tune the redirect as follows:

• If the redirect type is page_redirect, you can provide either the page slug or page ID for the destination page. We recommend using page slugs to make policies more readable.
• If the redirect type is url_redirect, you should provide a valid URL. However, AAM uses WordPress core safe redirect for security and compliance reasons. You can learn more about this from What is a safe redirect in WordPress? blog.
• If the redirect is a trigger_callback, a valid PHP callback function is required. AAM does not validate if the provided function exists.

Here is another example where we redirect a user to the page with id 7, if user is coming from certain IP range.

{
    "Param": [
        {
            "Key": "redirect:on:logout",
            "Value": {
                "Type": "page_redirect",
                "PageId": 7
            },
            "Condition": {
                "In": {
                    "${USER.ip}": "(*ip)9.84.23.0/16"
                }
            }
        }
    ]
}