The hotlink_protection utility serves to configure protection from hot-linking on domains. By using this utility, you can perform the following operations:

  • setting up hot-linking protection on a domain
  • retrieve the current configuration of domain hot-linking protection

Location

%plesk_cli%

Usage

hotlink_protection command [parameter] [
<option 1> <param 1>[
<option n> <param n>]]

Example

The following command enables hotlinking protection on the domain example.com with the following parameters: protected content is image files with extensions JPG, JPEG, GIF, PNG, TIFF, exception is made only for domain jonny.blogs.sample.net:

plesk bin hotlink_protection --update example.com -enabled true -protected-extensions jpg;jpeg;gif;png;tiff -friendly-domains jonny.blogs.sample.net

Commands

Command Parameter Description Example
--update or -u <domain name> Changes hotlinking protection settings.

To add to the protection list (already including JPG, GIF) file extension BMP for the domain example.com:

plesk bin hotlink_protection --update example.com -protected-extensions bmp

--info or -i <domain name> Retrieves current hotlinking protection configuration.

To retrieve information on the hotlinking protection settings for domain example.org:

plesk bin hotlink_protection --info example.org

--help or -h   Displays help on the utility usage.

plesk bin hotlink_protection --help

Options

Option Parameter Description Example
-enabled true| false Enables/Disables hotlinking protection.

To turn the hotlinking protection off on the domain example.com:

plesk bin hotlink_protection --update example.com -enabled false

-protected-extensions <ext1>;<ext2>;<...>;<ext n> Defines the protected file extensions.

To add to the protection list (already including JPG, GIF) file extension BMP for the domain example.com:

plesk bin hotlink_protection --update example.com -protected-extensions bmp

-friendly-domains <domain1>;<domain2>;<...>;<domainn> Defines friendly domains, which are allowed to hot-link the files.

To allow users of blogger.com hotlink files hosted on domain example.com:

plesk bin hotlink_protection --update example.com -friendly-domains blogger.com