Кодувальник / декодувальник URL-адрес

Архітектура інтернету вимагає, щоб Уніфіковані локатори ресурсів (URL-адреси) передавалися через HTTP з використанням стандартного набору символів US-ASCII. Якщо URL-адреса містить символи, що виходять за межі цього суворого алфавіту, наприклад пробіли, емодзі або кириличний текст, веб-браузер або сервер аварійно завершить роботу або неправильно інтерпретує маршрут.

Для безпечної передачі складних даних у рядку запиту URL-адреси необхідно застосувати кодування URL-адрес (часто зване відсотковим кодуванням). Цей алгоритм перетворює небезпечні символи в символ %, за яким слідує шістнадцяткове представлення значення символу в ASCII/UTF-8.

Наприклад, стандартний символ пробілу стає %20, а амперсанд (&) стає %26. Це гарантує, що дані досягнуть бекенд-сервера абсолютно неушкодженими.

Часта помилка у веб-розробці на JavaScript пов'язана з використанням неправильної функції кодування URL. Розуміння різниці критично важливо для уникнення помилок 404 та зламаних запитів до API.

• encodeURI(): Ця функція передбачає, що ви передаєте повну, дійсну URL-адресу. Вона кодує пробіли та іноземні символи, але не кодує символи, що мають особливе структурне значення в URL-адресі, такі як ?, =, &, / або :.
• encodeURIComponent(): Ця функція передбачає, що ви кодуєте певний фрагмент даних для вставлення в рядок запиту URL-адреси. Вона агресивно кодує майже все, включаючи слеші та амперсанди. Ви повинні використовувати цю функцію, коли приймаєте введення користувача та додаєте його як параметр URL-адреси.

Кодувальник URL-адрес від Utiliome суворо використовує семантику encodeURIComponent(), щоб забезпечити максимальну безпеку при екрануванні даних розробника.

Розробникам регулярно потрібно декодувати безладні рядки URL-адрес для зневадження перенаправлень OAuth або корисних навантажень Webhook (наприклад, ?email=user%40example.com&token=abc%3D%3D).

Якщо ви вставите цей рядок у загальний онлайн-інструмент SEO, ця URL-адреса передається через HTTP-запит POST на віддалений сервер. Адміністратор сервера може легко реєструвати ваші чутливі токени OAuth, ідентифікатори сеансів та PII (особисту ідентифікаційну інформацію).

Utiliome працює з використанням архітектури нульової довіри, орієнтованої на локальне виконання. Математика декодування виконується повністю в локальній оперативній пам'яті вашого браузера. Ви можете безпечно декодувати робочі ключі API, знаючи, що дані ніколи не торкаються зовнішньої мережі.

На зорі інтернету URL-адреси складалися виключно з англійського ASCII. Сьогодні URL-адреси часто містять глобальні мови, арабську в'язь та складні емодзі.

Сучасний стандарт кодування URL-адрес (RFC 3986) вимагає, щоб іноземні символи спочатку були перетворені в послідовність байтів UTF-8. Потім кожен з цих окремих байтів відсотково кодується.

Наприклад, емодзі ракети (🚀) потребує чотирьох байтів у UTF-8. Після проходження через кодувальник URL-адрес Utiliome він математично перетворюється на %F0%9F%9A%80. Це гарантує, що будь-який бекенд-сервер, незалежно від його основної мовної архітектури, зможе безпечно маршрутизувати та декодувати емодзі.

Щоб опанувати кодування URL-адрес, розробники повинні розуміти класифікацію символів згідно зі специфікацією RFC 3986.

• Незарезервовані символи: A-Z, a-z, 0-9, -, _, . та ~. Ці символи за своєю природою безпечні. Кодувальники URL-адрес просто проігнорують їх і залишать недоторканими.
• Зарезервовані символи: ! * ' ( ) ; : @ & = + $ , / ? # [ ]. Ці символи діють як "синтаксис" інтернету. Наприклад, символ & розділяє змінні. Якщо ваші фактичні дані змінної містять амперсанд (наприклад, "M&M Candy"), ви повинні закодувати його як %26, щоб сервер не розділив дані навпіл.

Частим приводом для плутанини є те, чому символ пробілу іноді кодується як %20, а іноді як символ +.

Це пов'язано із застарілою архітектурою інтернету. Специфікація application/x-www-form-urlencoded (використовується при надсиланні HTML-форм) історично диктувала, що пробіли повинні перетворюватися на символ плюса для економії пропускної здатності.

Однак у стандартних шляхах URL-адрес і сучасних рядках запитів API символ пробілу повинен суворо відсотково кодуватися як %20. Utiliome стандартизується на сучасній специфікації encodeURIComponent(), гарантуючи, що пробіли безпечно перетворюються на %20 для запобігання помилкам декодування на стороні сервера в сучасних REST API.