[GP]247
インストールをお任せしますか？
お客様のサーバーに導入・設定します。簡単な見積もりの後、固定価格でお受けします。
🌐 言語: 🇻🇳 Tiếng Việt · 🇬🇧 English · 🇯🇵 日本語（現在）
MFA プラグインは、GP247 システムに二要素認証（Two-Factor Authentication）を提供し、ユーザーアカウントのセキュリティを強化します。複数の guard（customer、admin、vendor、pmo…）に対応しており、ユーザー認証を柔軟に管理できます。
プロジェクトの composer.json にパッケージを追加します：
composer require pragmarx/google2fa
composer require bacon/bacon-qr-code
注意：このコマンドはプラグインのフォルダー内ではなく、GP247 プロジェクトのルートフォルダーで実行してください。
プラグインのインストール方法は 4 つあります：
zip ファイルのインポートで問題が発生した場合（アップロードエラー、一時ファイルの問題など）：
解凍して、ソースコードのフォルダーを対応するフォルダーにコピーします：
app/GP247/Plugins/MFA
MFA/public フォルダーを対応する public パスにコピーします：
public/GP247/Plugins/MFA
Admin Panel > Extensions > Plugins にアクセスします
デフォルトの「Local storage」タブで「MFA」を探し、「Install」をクリックします
「Enable」をクリックしてプラグインを有効化します
gp247 3.x からは、管理画面を開かずに、GP247 ライブラリから MFA をダウンロードしてコマンドラインですぐにインストールできます。必ず先にステップ 1 を実行してください（composer require pragmarx/google2fa bacon/bacon-qr-code）。実行していないと、パッケージ不足でコマンドが停止します。サイトのルートフォルダーでターミナルを開き、次を実行します：
# 1) ウェブサイトごとに 1 回だけ：GP247 ライブラリに接続するための API License（無料）を登録
php artisan gp247:ext-register-license
# 2) ライブラリからプラグインをダウンロードしてインストール
php artisan gp247:ext-install --type=plugin --key=MFA
.env の APP_URL がサイトの実際のドメインになっていることを確認してください（http://localhost のままにしないでください）。ライセンスはこのドメインに紐づけられます。gp247.json で宣言された条件（コアのバージョン、composer パッケージ、依存プラグイン）を自動でチェックします。不足があればコマンドは停止し、何が足りないかを明示します（例：pragmarx/google2fa または bacon/bacon-qr-code が未インストール）。app/GP247/Plugins/MFA フォルダーがすでにサーバー上にある場合（手動でコピーした、またはインストールパッケージに同梱されていた場合）、コマンドは再ダウンロードせずその場でインストールします。php artisan gp247:ext-update --type=plugin --key=MFA を実行します。--json を付けると、機械可読な形式で結果を受け取れます（スクリプト／CI 用）。インストールが完了すると、MFA プラグインは次のメニューに表示されます： Admin Panel > システム設定 > セキュリティ > MFA
プラグインを設定するには、次のファイルを編集します：app/GP247/Plugins/MFA/config.php
デフォルト：プラグインは admin guard に対してのみ有効化されています。
各 guard の設定パラメーター：
1 = 有効、0 = その guard の MFA を無効1 = 必須、0 = 任意（ユーザーが MFA を有効／無効にできます）設定例：
'guards' => [
'customer' => [
'enabled' => 0, // customer の MFA を無効化
'forced' => 0,
// ... その他のパラメーター
],
'admin' => [
'enabled' => 1, // admin の MFA を有効化（既定）
'forced' => 0, // 必須にしない
// ... その他のパラメーター
],
],
注意：config ファイルを編集した後は、キャッシュをクリアする必要があります：
php artisan config:clear
php artisan cache:clear
/mfa/setup/customer/mfa/manage/customer/mfa/recovery-codes/customer┌─────────────────────────────────────────────────────────────┐
│ User Login Success │
└────────────────────────┬────────────────────────────────────┘
│
▼
┌────────────────────┐
│ guard で MFA が │
│ 有効？ │
└────────┬───────────┘
│
┌────────────────┴────────────────┐
│ No │ Yes
▼ ▼
┌───────────────┐ ┌────────────────────┐
│ Allow Access │ │ MFA 登録済み？ │
└───────────────┘ └─────────┬──────────┘
│
┌────────────────┴────────────────┐
│ No │ Yes
▼ ▼
┌──────────────────┐ ┌──────────────────┐
│ MFA Forced? │ │ Session verified?│
└────────┬─────────┘ └────────┬─────────┘
│ │
┌─────────────┴──────────┐ ┌─────────┴─────────┐
│ No │ Yes │ │ No │ Yes │
▼ ▼ │ ▼ ▼ │
Allow Access Redirect │ Redirect Allow Access │
to Setup │ to Verify │
│ │ │ │
▼ │ ▼ │
┌─────────────┐ │ ┌─────────────────┐ │
│ Show QR Code│ │ │ Enter 6-digit │ │
│ & Secret │ │ │ code or │ │
└──────┬──────┘ │ │ recovery code │ │
│ │ └────────┬────────┘ │
▼ │ │ │
┌─────────────┐ │ ▼ │
│ Verify Code │ │ ┌─────────────────┐ │
└──────┬──────┘ │ │ Code Valid? │ │
│ │ └────────┬────────┘ │
▼ │ │ │
┌─────────────────┐ │ ┌────────┴────────┐ │
│ Generate │ │ │ No │ Yes │ │
│ Recovery Codes │ │ ▼ ▼ │ │
└────────┬────────┘ │ Error Set │ │
│ │ Session │ │
▼ │ Verified │ │
┌─────────────────┐ │ │ │ │
│ Show & Save │ │ ▼ │ │
│ Recovery Codes │ │ ┌──────────────┐ │ │
└────────┬────────┘ │ │Allow Access │ │ │
│ │ └──────────────┘ │ │
▼ │ │ │
┌─────────────────┐ │ │ │
│ MFA Activated │ │ │ │
└────────┬────────┘ │ │ │
│ │ │ │
└──────────┴──────────────────────┘ │
│ │
└───────────────────────────────┘
┌─────────────────────┐
│ User Login │
│ (Email + Password) │
└──────────┬──────────┘
│
▼
┌──────────────────────┐
│ Credentials Valid? │
└──────────┬───────────┘
│
┌──────┴──────┐
│ No │ Yes │
▼ ▼ │
Error Check │
MFA │
│ │
▼ │
┌─────────────────────┐
│ User enrolled MFA? │
└──────────┬──────────┘
│
┌──────┴──────┐
│ No │ Yes │
▼ ▼ │
Allow Redirect │
Access to MFA │
Verify │
│ │
▼ │
┌────────────────────────────┐
│ MFA Verification Page │
│ │
│ [Enter 6-digit code] │
│ or │
│ [Use recovery code] │
└──────────┬─────────────────┘
│
▼
┌──────────────────────┐
│ Verify Code │
│ (TOTP or Recovery) │
└──────────┬───────────┘
│
┌──────┴──────────┐
│ Valid │ Invalid │
▼ ▼ │
┌─────────────┐ ┌─────────┐
│ Set Session │ │ Show │
│ Verified │ │ Error │
└──────┬──────┘ └────┬────┘
│ │
▼ ▼
┌──────────────┐ ┌──────────┐
│ Allow Access │ │ Try Again│
└──────────────┘ └──────────┘
┌──────────────────────┐
│ ユーザーが端末を紛失 │
└──────────┬───────────┘
│
▼
┌──────────────────────┐
│ Login Page │
│ Enter credentials │
└──────────┬───────────┘
│
▼
┌──────────────────────────┐
│ MFA Verification Page │
│ │
│ Click "Use recovery code"│
└──────────┬───────────────┘
│
▼
┌──────────────────────────┐
│ Enter 8-char recovery │
│ code (e.g. ABCD1234) │
└──────────┬───────────────┘
│
▼
┌──────────────────────┐
│ Check recovery code │
│ in database │
└──────────┬───────────┘
│
┌──────┴───────┐
│ Valid│Invalid│
▼ ▼ │
┌────────────┐ ┌────────┐
│ Mark code │ │ Error │
│ as used │ └────────┘
└─────┬──────┘ │
│ │
▼ │
┌────────────┐ │
│ Login OK │ │
└─────┬──────┘ │
│ │
▼ │
┌──────────────────┐
│ Redirect to │
│ MFA Setup │
│ (Setup new device)│
└──────────────────┘
┌──────────────────────────┐
│ Request to protected │
│ route with mfa.verify │
└───────────┬──────────────┘
│
▼
┌───────────────────────────┐
│ Middleware: Check Auth │
└───────────┬───────────────┘
│
┌──────┴──────┐
│ Not │ Auth │
│ Auth │ │
▼ ▼ │
Redirect Check │
to Login MFA │
│ │
▼ │
┌─────────────────────────┐
│ MFA enabled for guard? │
└───────────┬─────────────┘
│
┌──────┴──────┐
│ No │ Yes │
▼ ▼ │
Allow Check │
Access Session │
│ │
▼ │
┌──────────────────────────┐
│ Session verified? │
└───────────┬──────────────┘
│
┌──────┴──────┐
│ Yes │ No │
▼ ▼ │
Allow Check │
Access User │
MFA │
│ │
▼ │
┌──────────────────────────┐
│ User enrolled MFA? │
└───────────┬──────────────┘
│
┌──────┴──────┐
│ No │ Yes │
▼ ▼ │
Check Redirect │
Forced to MFA │
MFA Verify │
│ │
▼ │
┌──────────────┐ │
│ MFA Forced? │ │
└──────┬───────┘ │
│ │
┌────┴────┐ │
│No │Yes │ │
▼ ▼ │ │
Allow Redirect │
Access to Setup │
│ │
└───────────┘
ルートを保護するには mfa.verify ミドルウェアを使用します：
// Trong routes/web.php
Route::group(['middleware' => ['auth:customer', 'mfa.verify:customer']], function () {
Route::get('/dashboard', 'DashboardController@index');
Route::get('/profile', 'ProfileController@index');
});
// admin 用
Route::group(['middleware' => ['auth:admin', 'mfa.verify:admin']], function () {
Route::get('/admin/dashboard', 'AdminController@index');
});
// guard で MFA が有効か確認
if (mfa_is_enabled_for_guard('customer')) {
// MFA is enabled
}
// ユーザーが MFA を登録済みか確認
if (mfa_is_user_enrolled($user, 'customer')) {
// User has enrolled MFA
}
// セッションで MFA が検証済みか確認
if (mfa_is_verified()) {
// Session is verified
}
// セッションを検証済みにする
mfa_set_verified();
// セッションから検証状態を削除
mfa_clear_verified();
// MFA 各ページへのリンクを生成
route('mfa.setup.show', 'customer') // /mfa/setup/customer
route('mfa.manage', 'customer') // /mfa/manage/customer
route('mfa.recovery_codes', 'customer') // /mfa/recovery-codes/customer
route('mfa.verify.show', 'customer') // /mfa/verify/customer
app/GP247/Plugins/MFA/
├── Admin/
│ └── AdminController.php # 管理パネル用 Controller
├── Controllers/
│ └── MFAController.php # MFA のメイン Controller
├── Helpers/
│ └── TwoFactorHelper.php # Google 2FA 用 Helper
├── Lang/
│ ├── en/
│ │ └── lang.php # 英語の翻訳
│ └── vi/
│ └── lang.php # ベトナム語の翻訳
├── Middleware/
│ └── TwoFactorAuthentication.php # MFA 認証 Middleware
├── Models/
│ ├── ExtensionModel.php # インストール／アンインストール用 Model
│ └── TwoFactorAuth.php # MFA データ保存用 Model
├── Views/
│ ├── Admin.blade.php # View admin
│ └── Frontend/
│ ├── setup.blade.php # MFA 設定 View
│ ├── verify.blade.php # MFA 認証 View
│ ├── recovery_codes.blade.php # リカバリーコード View
│ └── manage.blade.php # MFA 管理 View
├── AppConfig.php # プラグイン設定
├── config.php # 設定ファイル
├── function.php # Helper functions
├── gp247.json # Metadata plugin
├── Provider.php # Service provider
├── Route.php # Routes
└── readme_ja.md # このドキュメント
このプラグインは、すべての TOTP 認証アプリに対応しています：
MIT License
GP247 Team
Please sign in to write a review.
ログインNo reviews yet. Be the first to review this product.
![[InOut] 入荷・返品・入出金管理プラグイン](https://static.gp247.net/product/in-out.png)