2FAの強制

ヒント

このページでは2FAの強制設定について詳しく説明します。パスワードポリシーやAPIの主要な管理機能を含む、組織のセキュリティ機能の概要については、以下を参照してください。 組織のセキュリティ.

2FA（二要素認証）の強制設定を使用すると、組織の管理者は、メンバーが組織のリソースにアクセスする前に、すべてのアカウントで2FAを有効にするよう義務付けることができます。これにより、アプリとデータのセキュリティレベルを向上させることができます。

概要

組織で2FAの強制設定が有効になっている場合：

• すべてのメンバーは、Capgo アカウントで2FAを有効にする必要があります
• 2FAが有効でないメンバーは、組織のアプリへのアクセスが拒否されます
• WebダッシュボードとCLIの両方で、この要件が適用されます
• 新しいメンバーは、組織のリソースにアクセスする前に2FAを有効にする必要があります

ヒント

2FAの強制適用が特に重要なケース：

• 厳格なセキュリティポリシーを持つエンタープライズ組織
• 機密性の高いユーザーデータを扱うチーム
• 規制対象業界（ヘルスケア、金融など）の組織
• SOC 2やISO 27001への準拠が必要な企業

仕組み

Webダッシュボード

2FAが必須の組織にアクセスしようとした際、2FAが有効になっていない場合は：

1. アクセス拒否のメッセージが表示されます
2. アカウント設定から2FAを有効にするよう案内されます
3. 有効化すると、通常通り組織にアクセスできるようになります

CLIへのアクセス

2FAが必須の組織内のアプリに対して Capgo CLI を使用する場合：

🔐 Access Denied: Two-Factor Authentication Required
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

This organization requires all members to have 2FA enabled.

To regain access:
  1. Go to https://web.capgo.app/settings/account
  2. Enable Two-Factor Authentication on your account
  3. Try your command again

2FA強制の有効化

注意

2FA強制を有効にする前に：

• 自身のカウントで2FAが有効であることを確認してください
• 組織の全メンバーに2FAの有効化を通知してください
• 2FA未設定のメンバーは、直ちにアクセス権を失います

Webダッシュボード経由

1. 組織の設定に移動します
2. 以下の セキュリティ セクション
3. トグル 全メンバーに2FAを必須にする
4. アクションを確認

CLI経由

CapgoのCLIを使用して、2FAの強制を有効にできます：

# Enable 2FA enforcement for an organization
npx @capgo/cli organization set YOUR_ORG_ID --enforce-2fa

# Disable 2FA enforcement
npx @capgo/cli organization set YOUR_ORG_ID --no-enforce-2fa

CLIから有効にする場合、以下が表示されます：

• 2FAが有効になっていないメンバーの一覧
• 自身で2FAが有効になっていない場合の警告
• 変更を適用する前の確認プロンプト

メンバーの2FAステータス確認

CLI経由

組織の全メンバーと、それぞれの2FA設定状況を一覧表示できます：

npx @capgo/cli organization members YOUR_ORG_ID

表示される内容：

• メンバーのメールアドレスとロール
• 2FAが有効かどうか
• 2FAの有効化が必要なメンバー数の概要

Webダッシュボード経由

組織の設定から、各メンバーの2FAが有効になっているかを確認できます。

アカウントの2FA設定

アカウントで2FAを有効にする必要がある場合は、こちらの 2要素認証（2FA）設定ガイド.

ベストプラクティス

強制を有効にする前に

• 事前の周知: 強制適用を有効にする少なくとも1週間前に、メンバーへ通知してください
• サポートの提供: 以下を共有してください 2FA設定ガイド チームメンバーと
• 準備状況の確認: 利用する npx @capgo/cli organization members 2FAの有効化が必要なユーザーを確認します

強制を有効にした後

• アクセス問題の監視: ロックアウトされたメンバーへのサポート体制を整えてください
• バックアップコードの管理: 2FAバックアップコードを必ず保存するようメンバーに周知してください
• 定期的なレビュー: 全メンバーが2FAを維持しているか定期的に確認してください

CI/CD パイプライン向け

• API キーを使用する: CI/CD システムでは、ユーザーアカウントではなく API キーを使用してください
• API キーの所有者: CI/CD 用の API キーを作成したユーザーが 2FA を有効にしていることを確認してください
• キーのローテーション: 自動化システムで使用されている API キーを定期的にローテーションしてください

トラブルシューティング

「アクセス拒否: 2要素認証が必要です」

問題点: 組織にアクセスしようとした際にこのエラーが表示されます。

ソリューション:

1. 以下にアクセスして アカウント設定
2. アカウントの2FAを有効にする
3. 組織へのアクセスを再試行する

「2FA強制設定を有効にできません」

問題点: 組織に対して2FAの強制設定を有効にすることはできません。

ソリューション:

• 以下を確認してください： super_admin 組織内での権限
• まず、ご自身のアカウントで2FAを有効にしてください
• 問題が解決しない場合はサポートまでお問い合わせください

CLI コマンドの失敗

問題点: CLI コマンドが2FA関連のエラーで失敗します。

ソリューション:

• API キーが有効であることを確認してください： npx @capgo/cli doctor
• API キーの所有者が2FAを有効にしていることを確認してください
• ログイン認証を使用している場合は、再認証してください： npx @capgo/cli login

コンプライアンス

2FAの強制適用により、組織のさまざまなコンプライアンス要件を満たすことができます：

スタンダード	要件	2FAのメリット
SOC 2準拠	アクセス制御	全ユーザーに対して強力な認証を保証
ISO 27001	情報セキュリティ	本人確認のレイヤーを追加
HIPAA	アクセス管理	不正アクセスを防止
GDPR	データ保護	アカウント乗っ取りのリスクを低減
PCI DSS	認証コントロール	多要素認証の要件に対応

次のステップ

• アカウントの2FAを設定する
• 組織管理について学ぶ
• CI/CD用のAPIキーを設定する

2FA強制適用後の次のステップ

以下を使用している場合： 2FAの強制 セキュリティとコンプライアンスの計画に使う場合は、以下と連携してください： 暗号化 実装の詳細は「暗号化」を参照： コンプライアンス 実装の詳細は「コンプライアンス」を参照： Capgo セキュリティスキャナー Capgo セキュリティスキャナーの製品ワークフローについては： Capgo セキュリティ Capgo Security でのプロダクトワークフロー向け、および Capgo トラストセンター Capgo Trust Center でのプロダクトワークフロー向け。