Perlセキュリティパターン
Perlアプリケーションのための包括的なセキュリティガイドライン。入力検証、インジェクション防止、安全なコーディング手法をカバーします。
使用すべき場面
- Perlアプリケーションでユーザー入力を処理する場合
- Perl Webアプリケーション(CGI、Mojolicious、Dancer2、Catalyst)を構築する場合
- セキュリティ脆弱性についてPerlコードをレビューする場合
- ユーザー指定のパスでファイル操作を行う場合
- Perlからシステムコマンドを実行する場合
- DBIデータベースクエリを作成する場合
動作の仕組み
テイント対応の入力境界から始め、外側に向かって進みます。入力を検証してアンテイントし、ファイルシステムとプロセス実行を制限し、すべてのDBIクエリでパラメータ化クエリを使用します。以下の例は、ユーザー入力、シェル、またはネットワークに触れるPerlコードをリリースする前に、このスキルが適用することを想定している安全なデフォルトを示しています。
テイントモード
Perlのテイントモード(-T)は、外部ソースからのデータを追跡し、明示的な検証なしに安全でない操作で使用されるのを防ぎます。
テイントモードの有効化
#!/usr/bin/perl -T
use v5.36;
# テイントされる: プログラム外部からのものすべて
my $input = $ARGV[0]; # テイントされる
my $env_path = $ENV{PATH}; # テイントされる
my $form = <STDIN>; # テイントされる
my $query = $ENV{QUERY_STRING}; # テイントされる
# PATHを早期にサニタイズ(テイントモードで必須)
$ENV{PATH} = '/usr/local/bin:/usr/bin:/bin';
delete @ENV{qw(IFS CDPATH ENV BASH_ENV)};
アンテイントパターン
use v5.36;
# 良い: 特定の正規表現で検証してアンテイント
sub untaint_username($input) {
if ($input =~ /^([a-zA-Z0-9_]{3,30})$/) {
return $1; # $1はアンテイントされている
}
die "Invalid username: must be 3-30 alphanumeric characters\n";
}
# 良い: ファイルパスを検証してアンテイント
sub untaint_filename($input) {
if ($input =~ m{^([a-zA-Z0-9._-]+)$}) {
return $1;
}
die "Invalid filename: contains unsafe characters\n";
}
# 悪い: 過度に寛容なアンテイント(目的を無効にする)
sub bad_untaint($input) {
$input =~ /^(.*)$/s;
return $1; # 何でも受け入れる — 無意味
}
入力検証
ブロックリストより許可リスト
use v5.36;
# 良い: 許可リスト — 正確に許可するものを定義
sub validate_sort_field($field) {
my %allowed = map { $_ => 1 } qw(name email created_at updated_at);
die "Invalid sort field: $field\n" unless $allowed{$field};
return $field;
}
# 良い: 特定のパターンで検証
sub validate_email($email) {
if ($email =~ /^([a-zA-Z0-9._%+-]+\@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,})$/) {
return $1;
}
die "Invalid email address\n";
}
sub validate_integer($input) {
if ($input =~ /^(-?\d{1,10})$/) {
return $1 + 0; # 数値に強制変換
}
die "Invalid integer\n";
}
# 悪い: ブロックリスト — 常に不完全
sub bad_validate($input) {
die "Invalid" if $input =~ /[<>"';&|]/; # エンコードされた攻撃を見逃す
return $input;
}
長さ制約
use v5.36;
sub validate_comment($text) {
die "Comment is required\n" unless length($text) > 0;
die "Comment exceeds 10000 chars\n" if length($text) > 10_000;
return $text;
}
安全な正規表現
ReDoS対策
壊滅的なバックトラッキングは、重複するパターンにネストされた量指定子がある場合に発生します。
use v5.36;
# 悪い: ReDoSに対して脆弱(指数関数的バックトラッキング)
my $bad_re = qr/^(a+)+$/; # ネストされた量指定子
my $bad_re2 = qr/^([a-zA-Z]+)*$/; # 文字クラスに対するネストされた量指定子
my $bad_re3 = qr/^(.*?,){10,}$/; # 貪欲/怠惰の繰り返し組み合わせ
# 良い: ネストなしで書き換え
my $good_re = qr/^a+$/; # 単一の量指定子
my $good_re2 = qr/^[a-zA-Z]+$/; # 文字クラスに対する単一の量指定子
# 良い: 所有量指定子またはアトミックグループを使用してバックトラッキングを防止
my $safe_re = qr/^[a-zA-Z]++$/; # 所有量指定子(5.10+)
my $safe_re2 = qr/^(?>a+)$/; # アトミックグループ
# 良い: 信頼できないパターンにタイムアウトを適用
use POSIX qw(alarm);
sub safe_match($string, $pattern, $timeout = 2) {
my $matched;
eval {
local $SIG{ALRM} = sub { die "Regex timeout\n" };
alarm($timeout);
$matched = $string =~ $pattern;
alarm(0);
};
alarm(0);
die $@ if $@;
return $matched;
}
安全なファイル操作
3引数open
use v5.36;
# 良い: 3引数open、レキシカルファイルハンドル、戻り値チェック
sub read_file($path) {
open my $fh, '<:encoding(UTF-8)', $path
or die "Cannot open '$path': $!\n";
local $/;
my $content = <$fh>;
close $fh;
return $content;
}
# 悪い: ユーザーデータでの2引数open(コマンドインジェクション)
sub bad_read($path) {
open my $fh, $path; # $path = "|rm -rf /" の場合、コマンドが実行される!
open my $fh, "< $path"; # シェルのメタ文字インジェクション
}
TOCTOU対策とパストラバーサル
use v5.36;
use Fcntl qw(:DEFAULT :flock);
use File::Spec;
use Cwd qw(realpath);
# アトミックなファイル作成
sub create_file_safe($path) {
sysopen(my $fh, $path, O_WRONLY | O_CREAT | O_EXCL, 0600)
or die "Cannot create '$path': $!\n";
return $fh;
}
# パスが許可されたディレクトリ内に留まることを検証
sub safe_path($base_dir, $user_path) {
my $real = realpath(File::Spec->catfile($base_dir, $user_path))
// die "Path does not exist\n";
my $base_real = realpath($base_dir)
// die "Base dir does not exist\n";
die "Path traversal blocked\n" unless $real =~ /^\Q$base_real\E(?:\/|\z)/;
return $real;
}
一時ファイルにはFile::Temp(tempfile(UNLINK => 1))を使用し、競合状態を防ぐためにflock(LOCK_EX)を使用します。
安全なプロセス実行
リスト形式のsystemとexec
use v5.36;
# 良い: リスト形式 — シェル展開なし
sub run_command(@cmd) {
system(@cmd) == 0
or die "Command failed: @cmd\n";
}
run_command('grep', '-r', $user_pattern, '/var/log/app/');
# 良い: IPC::Run3で安全に出力をキャプチャ
use IPC::Run3;
sub capture_output(@cmd) {
my ($stdout, $stderr);
run3(\@cmd, \undef, \$stdout, \$stderr);
if ($?) {
die "Command failed (exit $?): $stderr\n";
}
return $stdout;
}
# 悪い: 文字列形式 — シェルインジェクション!
sub bad_search($pattern) {
system("grep -r '$pattern' /var/log/app/"); # $pattern = "'; rm -rf / #" の場合
}
# 悪い: 補間のあるバッククォート
my $output = `ls $user_dir`; # シェルインジェクションのリスク
また、外部コマンドから安全にstdout/stderrをキャプチャするためにCapture::Tinyを使用します。
SQLインジェクション防止
DBIプレースホルダー
use v5.36;
use DBI;
my $dbh = DBI->connect($dsn, $user, $pass, {
RaiseError => 1,
PrintError => 0,
AutoCommit => 1,
});
# 良い: パラメータ化クエリ — 常にプレースホルダーを使用
sub find_user($dbh, $email) {
my $sth = $dbh->prepare('SELECT * FROM users WHERE email = ?');
$sth->execute($email);
return $sth->fetchrow_hashref;
}
sub search_users($dbh, $name, $status) {
my $sth = $dbh->prepare(
'SELECT * FROM users WHERE name LIKE ? AND status = ? ORDER BY name'
);
$sth->execute("%$name%", $status);
return $sth->fetchall_arrayref({});
}
# 悪い: SQLでの文字列補間(SQLi脆弱性!)
sub bad_find($dbh, $email) {
my $sth = $dbh->prepare("SELECT * FROM users WHERE email = '$email'");
# $email = "' OR 1=1 --" の場合、すべてのユーザーを返す
$sth->execute;
return $sth->fetchrow_hashref;
}
動的カラム許可リスト
use v5.36;
# 良い: 許可リストに対してカラム名を検証
sub order_by($dbh, $column, $direction) {
my %allowed_cols = map { $_ => 1 } qw(name email created_at);
my %allowed_dirs = map { $_ => 1 } qw(ASC DESC);
die "Invalid column: $column\n" unless $allowed_cols{$column};
die "Invalid direction: $direction\n" unless $allowed_dirs{uc $direction};
my $sth = $dbh->prepare("SELECT * FROM users ORDER BY $column $direction");
$sth->execute;
return $sth->fetchall_arrayref({});
}
# 悪い: ユーザー選択のカラムを直接補間
sub bad_order($dbh, $column) {
$dbh->prepare("SELECT * FROM users ORDER BY $column"); # SQLi!
}
DBIx::Class(ORM安全性)
use v5.36;
# DBIx::Classは安全なパラメータ化クエリを生成
my @users = $schema->resultset('User')->search({
status => 'active',
email => { -like => '%@example.com' },
}, {
order_by => { -asc => 'name' },
rows => 50,
});
Webセキュリティ
XSS防止
use v5.36;
use HTML::Entities qw(encode_entities);
use URI::Escape qw(uri_escape_utf8);
# 良い: HTMLコンテキスト用に出力をエンコード
sub safe_html($user_input) {
return encode_entities($user_input);
}
# 良い: URLコンテキスト用にエンコード
sub safe_url_param($value) {
return uri_escape_utf8($value);
}
# 良い: JSONコンテキスト用にエンコード
use JSON::MaybeXS qw(encode_json);
sub safe_json($data) {
return encode_json($data); # エスケープを処理
}
# テンプレート自動エスケープ(Mojolicious)
# <%= $user_input %> — 自動エスケープ(安全)
# <%== $raw_html %> — 生出力(危険、信頼できるコンテンツにのみ使用)
# テンプレート自動エスケープ(Template Toolkit)
# [% user_input | html %] — 明示的なHTMLエンコーディング
# 悪い: HTML内での生出力
sub bad_html($input) {
print "<div>$input</div>"; # $inputに<script>が含まれているとXSS
}
CSRF保護
use v5.36;
use Crypt::URandom qw(urandom);
use MIME::Base64 qw(encode_base64url);
sub generate_csrf_token() {
return encode_base64url(urandom(32));
}
トークンを検証する際には、定数時間比較を使用します。ほとんどのWebフレームワーク(Mojolicious、Dancer2、Catalyst)は組み込みのCSRF保護を提供しているため、自作の解決策よりもそれらを優先します。
セッションとヘッダーセキュリティ
use v5.36;
# Mojolicious セッション + ヘッダー
$app->secrets(['long-random-secret-rotated-regularly']);
$app->sessions->secure(1); # HTTPSのみ
$app->sessions->samesite('Lax');
$app->hook(after_dispatch => sub ($c) {
$c->res->headers->header('X-Content-Type-Options' => 'nosniff');
$c->res->headers->header('X-Frame-Options' => 'DENY');
$c->res->headers->header('Content-Security-Policy' => "default-src 'self'");
$c->res->headers->header('Strict-Transport-Security' => 'max-age=31536000; includeSubDomains');
});
出力エンコーディング
常にそのコンテキストに応じて出力をエンコードします。HTMLにはHTML::Entities::encode_entities()、URLにはURI::Escape::uri_escape_utf8()、JSONにはJSON::MaybeXS::encode_json()を使用します。
CPANモジュールセキュリティ
- バージョンを固定(cpanfileで):
requires 'DBI', '== 1.643'; - メンテナンスされているモジュールを優先: MetaCPANで最近のリリースを確認
- 依存関係を最小化: 各依存関係が攻撃対象領域となる
セキュリティツール
perlcriticセキュリティポリシー
# .perlcriticrc — セキュリティ重視の設定
severity = 3
theme = security + core
# 3引数openを要求
[InputOutput::RequireThreeArgOpen]
severity = 5
# チェック付きシステムコールを要求
[InputOutput::RequireCheckedSyscalls]
functions = :builtins
severity = 4
# 文字列evalを禁止
[BuiltinFunctions::ProhibitStringyEval]
severity = 5
# バッククォート演算子を禁止
[InputOutput::ProhibitBacktickOperators]
severity = 4
# CGIでのテイントチェックを要求
[Modules::RequireTaintChecking]
severity = 5
# 2引数openを禁止
[InputOutput::ProhibitTwoArgOpen]
severity = 5
# 裸のワードファイルハンドルを禁止
[InputOutput::ProhibitBarewordFileHandles]
severity = 5
perlcriticの実行
# ファイルをチェック
perlcritic --severity 3 --theme security lib/MyApp/Handler.pm
# プロジェクト全体をチェック
perlcritic --severity 3 --theme security lib/
# CI統合
perlcritic --severity 4 --theme security --quiet lib/ || exit 1
クイックセキュリティチェックリスト
| チェック項目 | 確認内容 |
|---|---|
| テイントモード | CGI/Webスクリプトに-Tフラグ |
| 入力検証 | 許可リストパターン、長さ制限 |
| ファイル操作 | 3引数open、パストラバーサルチェック |
| プロセス実行 | リスト形式system、シェル補間なし |
| SQLクエリ | DBIプレースホルダー、決して補間しない |
| HTML出力 | encode_entities()、テンプレート自動エスケープ |
| CSRFトークン | 生成済み、状態変更リクエストで検証 |
| セッション設定 | Secure、HttpOnly、SameSite Cookie |
| HTTPヘッダー | CSP、X-Frame-Options、HSTS |
| 依存関係 | バージョン固定、監査済みモジュール |
| 正規表現の安全性 | ネストされた量指定子なし、アンカー付きパターン |
| エラーメッセージ | スタックトレースやパスをユーザーに漏らさない |
アンチパターン
# 1. ユーザーデータでの2引数open(コマンドインジェクション)
open my $fh, $user_input; # 重大な脆弱性
# 2. 文字列形式system(シェルインジェクション)
system("convert $user_file output.png"); # 重大な脆弱性
# 3. SQL文字列補間
$dbh->do("DELETE FROM users WHERE id = $id"); # SQLi
# 4. ユーザー入力でのeval(コードインジェクション)
eval $user_code; # リモートコード実行
# 5. サニタイズせずに$ENVを信頼
my $path = $ENV{UPLOAD_DIR}; # 操作される可能性がある
system("ls $path"); # 二重脆弱性
# 6. 検証なしでテイントを無効化
($input) = $input =~ /(.*)/s; # 怠惰なアンテイント — 目的を無効にする
# 7. HTML内でのユーザーデータ生出力
print "<div>Welcome, $username!</div>"; # XSS
# 8. 検証されていないリダイレクト
print $cgi->redirect($user_url); # オープンリダイレクト
注意: Perlの柔軟性は強力ですが、規律が必要です。Web向けコードではテイントモードを使用し、すべての入力を許可リストで検証し、すべてのクエリにDBIプレースホルダーを使用し、すべての出力をそのコンテキストに応じてエンコードしてください。多層防御 — 決して単一のレイヤーに依存しないでください。