RTCIceCandidate: свойство address

Только для чтения свойство интерфейса RTCIceCandidate address — это строка, содержащая IP-адрес устройства, являющегося источником кандидата. Значение свойства address устанавливается по умолчанию, если не указано иное.

Значение поля address задаётся из объекта candidateInfo параметров, переданного конструктору RTCIceCandidate(). Вы не можете указать значение address напрямую в объекте параметров, но оно автоматически извлекается из поля candidate a-строки, если оно отформатировано должным образом.

Строка, содержащая IP-адрес, от которого происходит кандидат.

Важно отметить, что хотя WebRTC не требует, чтобы два подключённых узла в соединении RTCPeerConnection знали истинные IP-адреса друг друга, свойство address в объекте RTCIceCandidate может раскрывать больше информации о источнике удалённого узла, чем ожидается пользователем. IP-адрес может использоваться для получения информации о местоположении удалённого устройства, топологии сети и так далее. Он также может использоваться в целях определения устройства.

IP-адреса кандидатов всегда доступны приложению через address, и недобросовестные приложения могут, в свою очередь, раскрыть этот адрес пользователю. Это может произойти без согласия удалённого узла.

Приложения, разработанные с учётом конфиденциальности и безопасности пользователей, могут ограничить разрешённых кандидатов только реле-кандидатами. Это предотвращает раскрытие адреса удалённого пользователя, но уменьшает выбор доступных кандидатов. Для этого настройте политику транспортного протокола ICE агента с объектом, соответствующим свойству configuration описанному в RTCPeerConnection.setConfiguration, как показано ниже:

const rtcConfig = {
  iceServers: [
    {
      urls: "turn:my-turn.server.ip",
      username: "username",
      credential: "password",
    },
  ],
  iceTransportPolicy: "relay",
};

Установив iceTransportPolicy на значение "relay", все хост-кандидаты (кандидаты, где IP-адрес — собственный IP-адрес узла), а также любые другие кандидаты, не являющиеся реле-кандидатами, исключаются из набора кандидатов.

Рассмотрим такую атрибутную строку (a-строку) SDP, описывающую ICE-кандидата:

a=candidate:4234997325 1 udp 2043278322 192.0.2.172 44323 typ host

Пятое поле, "192.0.2.172" — это IP-адрес в строке a-строки кандидата.

Этот фрагмент кода использует значение address для реализации функции запрета доступа по IP-адресу.

if (ipBanList.includes(candidate.address)) {
  rejectCandidate(candidate);
} else {
  acceptCandidate(candidate);
}