【Node.js24.x】Object::checkServerIdentity()メソッドの使い方
checkServerIdentityメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
checkServerIdentityメソッドは、Objectクラスに属し、ネットワーク通信において接続しようとしているサーバーの身元が信頼できるものであるかを確認するために実行されるメソッドです。
このメソッドの主な役割は、セキュアな通信、特にTLS/SSLプロトコルを使用する際に、サーバーが提示するデジタル証明書が正当なものであり、かつそのサーバーが本当に接続しようとしている相手であるかを検証することにあります。具体的には、サーバーから提供された証明書に含まれる情報（例えば、コモンネームやサブジェクト代替名など）と、クライアントが期待するホスト名やIPアドレスとを照合します。
これにより、悪意のある第三者が正規のサーバーになりすまして通信を傍受しようとする中間者攻撃（Man-in-the-Middle attack）などのセキュリティ脅威からクライアントアプリケーションを保護します。もし身元確認に失敗した場合、このメソッドは接続を拒否したり、エラーを発生させたりすることで、安全でない通信の確立を未然に防ぎます。安全で堅牢なシステムを構築する上で、通信相手の信頼性を保証するための重要なセキュリティ機能の一つです。
構文(syntax)
1function checkServerIdentity(hostname, cert) { }
引数(parameters)
hostname, cert
- hostname: string: 確認するサーバーのホスト名またはIPアドレス
- cert: Buffer: サーバーから受信した証明書オブジェクト
戻り値(return)
Error | undefined
このメソッドは、サーバー証明書の検証に失敗した場合に Error オブジェクトを返します。検証が成功した場合は undefined を返します。