本文へ移動
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仕様で定められた場面で返される、利用可能な認証メカニズムの一覧。
エラー一般的な原因
904SASL認証の失敗。
905応答が長すぎます。
906認証交換が中止されました。
907許可されない用途で、すでに認証済みのアカウントが使われています。

権限・互換性・注意点 #

EXTERNALの例では、クライアント証明書が受け入れられ、アカウントに関連付けられていることが前提です。TLSを有効にしただけでは動作しません。通常のTLSによるサーバー確認とは別に、クライアント証明書の設定が必要です。

PLAINでは、認可ID、認証ID、パスワードをNULバイトで区切ってからBase64に変換します。Base64は暗号化ではありません。証明書を検証したTLS通信を使ってください。

符号化されたデータは400バイト以内の単位に分けます。全体の長さが400の倍数なら、最後に AUTHENTICATE + を送り、終了を示します。CAP ENDは認証の成功や中止と整合するタイミングで送信してください。

よくある質問 #

SASLには必ずサイトのパスワードを使いますか?いいえ。認証情報はサービスによって異なります。Dialovaでは専用のIRCキーを使用します。

会話中にAUTHENTICATEを送れますか?再認証はサーバーとSASL 3.2への対応によります。接続したままアカウントを切り替える共通の手段ではありません。

出典と確認

例では、明記した接続先を除き、架空のニックネームとドメインを使用しています。特定のネットワークだけにある拡張や設定は、本文で区別しています。