7.13. Secure Link для файлов в хранилище
Внимание!
Только для файлов, не для каталогов.Технология Secure Link позволяет использовать защищённые ссылки на файлы. Такие ссылки содержат секретный ключ и могут быть с ограничением доступа по IP-адресу, по времени действия или без ограничений. Используя Secure Link, можно организовать гибкий защищённый доступ к файлам в своём хранилище.
Структура защищённых ссылок
Пример ссылки:
https://example.cdn.express/secure/ip/t/XXxXXxxXXXXXXXXXXXxxXx/1234567890/path/to/file
Каждая защищённая ссылка состоит из нескольких частей:
- Тип ограничения доступа:
secure/ip/t— по IP-адресу и времени жизни.secure/ip— только по IP-адресу.secure/t— только по времени жизни.secure— без ограничений.
- Закодированный хеш совокупности данных секретного ключа, пути и опций ограничения доступа.
- Метка окончания времени жизни (если используется).
- Путь к файлу в хранилище.
Секретный ключ
Важные моменты:
- В один момент времени может действовать только один ключ.
- При обновлении ключа все ссылки со старым ключом перестают работать.
- Ключ нельзя отключить или удалить — можно просто его обновить и не использовать для создания ссылок.
Секретный ключ генерируется на вкладке «Secure Link»:
Там же его можно обновить.
Генератор Secure Link
Примечания:
- При использовании ограничения по IP-адресу ссылка генерируется для вашего текущего IP-адреса.
- Для генерации ссылок можно использовать специальный метод в API хранилища.
Форма предназначена для тестовой генерации Secure Link с разными вариантами ограничения доступа:
Можно указать путь к нужному файлу от корня хранилища, время жизни в секундах, тип ограничения доступа и нажать «Сгенерировать». На выходе получится готовая ссылка, которую можно скопировать в буфер обмена и использовать для теста.
Примеры готового кода
Примеры готового PHP-кода для генерации Secure Link с разными вариантами ограничения доступа можно брать за основу для использования в своих скриптах. Адрес хранилища и секретный ключ уже присутствуют в коде, достаточно только указывать путь к нужному файлу в хранилище, опционально — IP-адрес посетителя и время жизни, и на выходе получать готовую защищённую ссылку.
Комментарии