lb page

The lb page command creates the content pages that will be shown to the visitor. These pages are returned to the client in the blocking, quarantine, waiting room and error situations. Its panel equivalent is the Content Pages screen.

Command Summary

TR7 WEB-CLI · lb page

# Tab after the command

admin@TR7LBWAF01> lb page

add delete list show update

 

admin@TR7LBWAF01> lb page list # list all of them

admin@TR7LBWAF01> lb page show <id> # show one

admin@TR7LBWAF01> lb page add name <name> … # new page

admin@TR7LBWAF01> lb page update id <id> … # change

admin@TR7LBWAF01> lb page delete <id> # delete

admin@TR7LBWAF01>  

Required Fields

Order	Field	Status	Value
1	name	Required	The name of the page; it must be unique in the collection

There is no other required field in the add command; in the show and delete commands the id is written without the field name, and in the update command in the form id <id>.

Fields

Field	Status	What it does	What is written after it
name	Required	Gives a name to the page	The name of the page; it must be unique in the collection
--contentType	Optional	Determines the content type that will be sent in the response	A content type (default text/html)
--content	Optional	Writes the content that will be shown	The page content. Smart content expressions can be used; when it is HTML, it is written inside double quotes

Usage Locations

The created page can be used in every place that chooses to show content:

Where	Field
The content showing actions	lb action → --contentProfile
The traffic protection actions	lb threat-protection → --<family>ContentProfile
The quarantine and the waiting room	--quarantineContentProfile and --waitingRoomContentProfile in the same command

Examples

TR7 WEB-CLI · the content page

admin@TR7LBWAF01> lb page add name maintenance-page --contentType text/html \

--content "<html-content>"

 

# a plain text page

admin@TR7LBWAF01> lb page add name short-notice --contentType text/plain --content "Service is temporarily closed."

 

# using it in an action

admin@TR7LBWAF01> lb action update id <action> --contentProfile <page>

admin@TR7LBWAF01> lb page delete <id>

admin@TR7LBWAF01>  

Things to Know

• The content can carry a smart expression. The text written in the --content field can contain variables resolved from the request.
• HTML content requires quotes. The content that carries spaces, line breaks and special characters is written inside double quotes.
• The status code is not on the page but in the place that uses it. The page carries only the content; with which HTTP status code it will be returned is determined in the ContentStatusCode field of the action that uses it.
• A page in use should not be deleted. When a page bound to an action or to a protection is deleted, that behavior runs with the default content.
• The name is unique. A second page with the same name cannot be created.