Перейти к содержимому
Dialova

Документация IRC · Продвинутый

Команда AUTHENTICATE: обмен данными SASL

AUTHENTICATE передаёт данные SASL после включения возможности sasl. Это не команда для отправки секрета в комнату. Смысл данных и необходимые условия определяются выбранным механизмом.

Команда Dialova · Проверено

Синтаксис и параметры #

Синтаксис протокола без клиентского /
AUTHENTICATE <механизм | данные-base64 | + | *>
ПараметрЗначение
механизмНапример, PLAIN или EXTERNAL, если сервер их поддерживает.
данные-base64Ответ механизма, разбитый на части по правилам IRC SASL.
+ / *+ означает пустой ответ, * запрашивает отмену обмена.

Пример с пояснениями #

Обмен IRC: C — клиент, S — сервер
C: CAP REQ :sasl
S: :irc.example CAP Alice ACK :sasl
C: AUTHENTICATE EXTERNAL
S: AUTHENTICATE +
C: AUTHENTICATE +
S: :irc.example 903 Alice :SASL authentication successful
C: CAP END

Ники, адреса и тексты примера вымышлены. Клиент может показывать ответы в более удобном виде, чем приведённые строки протокола.

Возможные ответы и ошибки #

ОтветЗначение
900 / 903Сведения о входе в учётную запись и успешной аутентификации SASL в соответствующих ответах.
908Список механизмов в случаях, предусмотренных спецификацией.
ОшибкаОбычная причина
904Ошибка SASL.
905Слишком длинный ответ.
906Обмен отменён.
907Учётная запись уже аутентифицирована, повторная операция недопустима.

Права, совместимость и меры предосторожности #

Пример EXTERNAL предполагает клиентский сертификат, принятый сервером и связанный с учётной записью. Одного TLS недостаточно: TLS прежде всего удостоверяет сервер, а клиентский сертификат требует отдельной настройки.

В PLAIN ответ содержит идентификатор авторизации, идентификатор аутентификации и пароль, разделённые байтами NUL, после чего кодируется в Base64. Base64 не шифрует данные: используйте TLS с проверкой сертификата.

Части закодированных данных ограничены 400 байтами. Если общая длина точно кратна 400, завершающий AUTHENTICATE + обозначает конец. Отправляйте CAP END в момент, согласованный с результатом или отменой обмена.

Частые вопросы #

Всегда ли SASL использует пароль от сайта? Нет. Данные зависят от сервиса. На Dialova используется отдельный ключ IRC.

Можно ли отправить AUTHENTICATE во время разговора? Повторная аутентификация зависит от сервера и SASL 3.2. Это не универсальный способ сменить учётную запись без переподключения.

Источники и проверка

В примерах используются вымышленные ники и домены, кроме явно указанных реальных точек подключения. Расширения и настройки отдельных сетей отмечены в тексте.