UrlGuard
in package
FinalYes
Валидация адреса сервера Loki.
Защитный контур против SSRF и утечки учётных данных: допускаются только схемы http/https, запрещены креды в URL (для них есть BasicAuth) и фрагменты; в режиме HostPolicy::PublicOnly дополнительно отклоняются loopback, приватные и link-local адреса.
Редиректы транспортом не выполняются вовсе, поэтому проверенный адрес не может быть перенаправлен на внутренний сервис.
Table of Contents
Methods
- __construct() : mixed
- validate() : non-empty-string
- Проверяет адрес и возвращает его без завершающего слеша.
Methods
__construct()
public
__construct([HostPolicy $policy = HostPolicy::AllowAll ]) : mixed
Parameters
- $policy : HostPolicy = HostPolicy::AllowAll
-
политика допустимых хостов
validate()
Проверяет адрес и возвращает его без завершающего слеша.
public
validate(string $url) : non-empty-string
Parameters
- $url : string
-
базовый адрес сервера Loki
Tags
Return values
non-empty-string —нормализованный адрес