Przejdź do treści
Dialova

Dokumentacja IRC · Zaawansowany

Polecenie AUTHENTICATE: wymiana danych SASL

AUTHENTICATE przesyła dane wymiany SASL po włączeniu możliwości sasl. Nie wpisuj tego polecenia z sekretem w pokoju rozmów. Wybrany mechanizm określa dane, ich znaczenie i wymagania.

Zespół Dialovy · Sprawdzono

Składnia i parametry #

Składnia protokołu, bez ukośnika używanego w kliencie
AUTHENTICATE <mechanizm | dane-base64 | + | *>
ParametrZnaczenie
mechanizmNa przykład PLAIN lub EXTERNAL, jeśli serwer go oferuje.
dane-base64Odpowiedź mechanizmu podzielona zgodnie z zasadami SASL w IRC.
+ / *+ oznacza pustą odpowiedź, a * prosi o przerwanie wymiany.

Przykład z objaśnieniem #

Wymiana IRC: C = klient, S = serwer
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

Nicki, hosty i teksty w przykładzie są fikcyjne. Klient może prezentować odpowiedzi czytelniej niż w surowych wiadomościach protokołu.

Możliwe odpowiedzi i błędy #

OdpowiedźZnaczenie
900 / 903Informacje o zalogowanym koncie i powodzeniu SASL, zależnie od wysłanych odpowiedzi.
908Lista dostępnych mechanizmów w sytuacjach przewidzianych specyfikacją.
BłądTypowa przyczyna
904Niepowodzenie SASL.
905Zbyt długa odpowiedź.
906Wymiana została przerwana.
907Konto jest już uwierzytelnione, a żądane użycie nie jest dozwolone.

Uprawnienia, zgodność i środki ostrożności #

Przykład EXTERNAL zakłada zaakceptowany certyfikat klienta przypisany do konta. Samo włączenie TLS nie wystarcza: TLS uwierzytelnia przede wszystkim serwer, a certyfikat klienta wymaga dodatkowej konfiguracji.

W PLAIN odpowiedź zawiera tożsamość autoryzacji, tożsamość uwierzytelniania i hasło rozdzielone bajtami NUL, a następnie zakodowane w Base64. Base64 niczego nie szyfruje: używaj poprawnie zweryfikowanego transportu TLS.

Fragmenty zakodowanych danych mają limit 400 bajtów. Gdy całkowita zakodowana długość jest dokładną wielokrotnością 400, końcowe AUTHENTICATE + oznacza koniec. Wyślij CAP END dopiero w momencie zgodnym z wynikiem lub przerwaniem wymiany.

Częste pytania #

Czy SASL zawsze wymaga hasła do serwisu? Nie. Dane zależą od usługi. Dialova używa osobnego klucza IRC.

Czy można wysłać AUTHENTICATE w trakcie rozmowy? Ponowne uwierzytelnianie zależy od serwera i SASL 3.2; nie jest uniwersalnym sposobem zmiany konta podczas sesji.

Źródła i weryfikacja

Przykłady używają fikcyjnych nicków i domen, z wyjątkiem wyraźnie udokumentowanych punktów połączenia. Rozszerzenia i ustawienia właściwe danej sieci są zaznaczone w tekście.