【PHP8.x】posix_seteuid()関数の使い方

Copy
1<?php
2
3// このスクリプトは、PHP の posix_geteuid および posix_seteuid 関数の使用例を示します。
4// これらの関数は、プロセスの実効ユーザーID (EUID) を取得・設定するために使用されます。
5//
6// posix_geteuid(): 現在のプロセスの実効ユーザーIDを取得します。
7// posix_seteuid(int $uid): プロセスの実効ユーザーIDを引数で指定したIDに変更します。
8//
9// 注意事項:
10// - posix_seteuid はセキュリティ上重要な関数であり、利用には細心の注意が必要です。
11// - 通常、この関数はスクリプトが root ユーザーとして実行されている場合にのみ、
12//   別のユーザーIDへの切り替え（特に特権の放棄）が許可されます。
13// - 非 root ユーザーが posix_seteuid を呼び出すと、通常は失敗します。
14// - このコードを実行する前に、PHP の POSIX 拡張が有効になっていることを確認してください。
15
16// 1. POSIX 拡張がロードされているか確認します。
17if (!extension_loaded('posix')) {
18    echo "エラー: PHP の POSIX 拡張がロードされていません。\n";
19    echo "php.ini 設定ファイルを確認し、'extension=posix' を有効にしてください。\n";
20    exit(1);
21}
22
23echo "POSIX 拡張は正常にロードされています。\n\n";
24
25// 2. 現在の実効ユーザーID (EUID) を取得し、表示します。
26$currentEuid = posix_geteuid();
27echo "現在のプロセスの実効ユーザーID (EUID): " . $currentEuid . "\n\n";
28
29// 3. 切り替えを試みるターゲットのユーザーID (UID) を定義します。
30//    このIDは、あなたのシステムに存在する非特権ユーザーのIDに置き換えてください。
31//    例: 'nobody' ユーザーのUID (多くのLinuxシステムで 65534)、または 'www-data' など。
32//    正確なUIDは、コマンドラインで `id -u <ユーザー名>` (例: `id -u nobody`) で確認できます。
33$targetEuid = 65534; // 例: nobody ユーザーのUID (環境によって異なる可能性があります)
34echo "変更を試みるターゲットのEUID: " . $targetEuid . "\n\n";
35
36// 4. posix_seteuid を使用してEUIDを切り替える試みを行います。
37//    セキュリティ上の制限により、rootユーザー以外ではEUIDの変更はほとんどの場合失敗します。
38if ($currentEuid === $targetEuid) {
39    echo "現在のEUIDは既にターゲットのEUIDと同じです。変更は不要です。\n";
40} else {
41    echo "posix_seteuid(" . $targetEuid . ") を使用して、EUIDを変更しようとします...\n";
42    if (posix_seteuid($targetEuid)) {
43        // 5. 切り替えが成功した場合、新しいEUIDを取得して表示します。
44        $newEuid = posix_geteuid();
45        echo "実効ユーザーIDが " . $targetEuid . " に正常に切り替わりました。\n";
46        echo "新しい実効ユーザーID (EUID): " . $newEuid . "\n";
47    } else {
48        // 6. 切り替えが失敗した場合、エラー情報を表示します。
49        $errorCode = posix_get_last_error();
50        $errorMessage = posix_strerror($errorCode);
51        echo "エラー: 実効ユーザーIDを " . $targetEuid . " に切り替えることができませんでした。\n";
52        echo "   エラーコード: " . $errorCode . "\n";
53        echo "   エラーメッセージ: " . $errorMessage . "\n";
54        echo "   (ヒント: スクリプトが root ユーザーとして実行されていない場合、\n";
55        echo "    または指定したUIDへの権限がない場合にこのエラーが発生することが多いです。)\n";
56    }
57}
58
59echo "\nスクリプトの実行を終了します。\n";
60
61?>

PHP 8のposix_seteuid関数は、実行中のプロセスの実効ユーザーID（EUID）を指定した整数値のユーザーID（int $uid）に設定するために使用されます。この関数は、EUIDの変更に成功した場合はtrueを、失敗した場合はfalseをブール値で返します。セキュリティ上の理由から、この機能は通常、スクリプトがrootユーザーとして実行されている場合にのみ成功し、特権を放棄して非特権ユーザーへ切り替える際に利用されることが一般的です。非rootユーザーがこの関数を呼び出しても、ほとんどの場合は失敗します。

サンプルコードでは、まずposix_geteuid関数で現在のプロセスのEUIDを取得し、次にposix_seteuid関数を使用して別のユーザーIDへの切り替えを試みています。変更が成功した場合は、再度posix_geteuidで新しいEUIDを確認して表示します。もし切り替えが失敗した場合は、その旨とエラーコード、エラーメッセージを表示し、セキュリティ上の制限によるものである可能性を説明しています。この機能を利用するには、PHPのPOSIX拡張が有効になっている必要があります。

Copy
1<?php
2
3/**
4 * PHPのposix_seteuid関数のサンプルコードです。
5 *
6 * このスクリプトは、現在の実行ユーザーID (EUID) を表示し、
7 * その後、特定のシステムユーザー（例: 'nobody'）のIDに切り替えることを試みます。
8 * 切り替えの前後で posix_getpwuid 関数を使用してユーザー情報を表示します。
9 *
10 * 注意: posix_seteuid は通常、root権限でスクリプトを実行している場合に、
11 *       より低い権限のユーザーに切り替えるために使用されます。
12 *       root以外のユーザーで実行した場合、権限の切り替えは失敗することがほとんどです。
13 *       また、PHPのposix拡張が有効になっている必要があります。
14 */
15function switchUserIdentity(): void
16{
17    // posix拡張がロードされているか確認
18    if (!extension_loaded('posix')) {
19        echo "エラー: PHP posix 拡張が有効になっていません。\n";
20        return;
21    }
22
23    echo "--- ユーザーID切り替えデモンストレーション ---\n";
24
25    // 1. 現在の実効ユーザーID (EUID) を取得し、その情報を表示します。
26    //    posix_geteuid(): 現在のプロセスが実行されている実効ユーザーIDを取得します。
27    //    posix_getpwuid(): 指定されたユーザーIDのユーザー情報を配列で返します。
28    $initialEuid = posix_geteuid();
29    $initialUserInfo = posix_getpwuid($initialEuid); // キーワード: posix_getpwuid の使用例
30    echo "現在のEUID: " . $initialEuid . "\n";
31    if ($initialUserInfo) {
32        echo "  - ユーザー名: " . $initialUserInfo['name'] . "\n";
33    } else {
34        echo "  - 現在のユーザー情報を取得できませんでした。\n";
35    }
36
37    // 2. ターゲットとなる非特権ユーザー（例: 'nobody'）のUIDを取得します。
38    //    posix_getpwnam(): 指定されたユーザー名のユーザー情報を配列で返します。
39    //    このUIDに切り替えを試みます。
40    $targetUsername = 'nobody';
41    $targetUserEntry = posix_getpwnam($targetUsername);
42
43    if (!$targetUserEntry) {
44        echo "\nエラー: ターゲットユーザー '" . $targetUsername . "' が見つかりませんでした。\n";
45        echo "このシステムに '" . $targetUsername . "' ユーザーが存在するか確認してください。\n";
46        return;
47    }
48
49    $targetEuid = $targetUserEntry['uid'];
50    echo "\nターゲットユーザー ('" . $targetUsername . "') のUID: " . $targetEuid . "\n";
51
52    // ターゲットUIDのユーザー情報を表示 (再度 posix_getpwuid を使用)
53    $targetUserInfo = posix_getpwuid($targetEuid); // キーワード: posix_getpwuid の別の使用例
54    if ($targetUserInfo) {
55        echo "  - ユーザー名: " . $targetUserInfo['name'] . "\n";
56    }
57
58    // 3. ユーザーIDをターゲットのIDに切り替えることを試みます。
59    //    posix_seteuid(int $uid): 現在のスクリプトの実効ユーザーIDを指定されたUIDに設定します。
60    //                              成功すると true、失敗すると false を返します。
61    echo "\nユーザーIDを " . $targetEuid . " に切り替えを試みます...\n";
62    $seteuidSuccess = posix_seteuid($targetEuid);
63
64    if ($seteuidSuccess) {
65        echo "ユーザーIDの切り替えに成功しました。\n";
66
67        // 4. 切り替え後の実効ユーザーIDとその情報を表示します。
68        $finalEuid = posix_geteuid();
69        $finalUserInfo = posix_getpwuid($finalEuid); // キーワード: posix_getpwuid の再度使用
70        echo "切り替え後のEUID: " . $finalEuid . "\n";
71        if ($finalUserInfo) {
72            echo "  - ユーザー名: " . $finalUserInfo['name'] . "\n";
73        }
74    } else {
75        echo "ユーザーIDの切り替えに失敗しました。\n";
76        echo "ヒント: スクリプトをroot権限で実行しているか、または現在のユーザーが指定されたIDに切り替える権限を持っているか確認してください。\n";
77        echo "現在のEUID: " . posix_geteuid() . " (切り替え失敗のため変更なし)\n";
78    }
79
80    echo "\n--- デモンストレーション終了 ---\n";
81}
82
83// 関数を実行します
84switchUserIdentity();

PHPのposix_seteuid関数は、現在のPHPスクリプトが動作している実効ユーザーID（EUID）を指定したユーザーID（$uid）に変更するために使用されます。引数$uidには、切り替えたいユーザーの数値IDを指定します。この関数は、処理が成功した場合はtrueを、失敗した場合はfalseをブール値で返します。

提供されたサンプルコードは、posix_seteuidの動作を実演するものです。最初にposix_geteuidで現在のEUIDを取得し、posix_getpwuid関数を使ってそのユーザー情報を表示します。次に、posix_getpwnam関数で指定したユーザー名（例: 'nobody'）の情報を取得し、そのユーザーIDへの切り替えをposix_seteuidで試みます。切り替えが成功した場合は、再度posix_geteuidとposix_getpwuidで、新しいEUIDとユーザー名を表示して確認します。

この関数は、通常、スクリプトがroot権限で実行されている場合に、セキュリティ上の理由から、より低い権限のユーザーに一時的に切り替える目的で利用されます。root以外のユーザーが実行した場合、権限の切り替えはほとんどのケースで失敗しますので注意が必要です。また、この機能を利用するためには、PHPのposix拡張が有効になっている必要があります。posix_getpwuidは、ユーザーIDからユーザー名などの詳細な情報を取得する際に役立つ関数です。