SSO (エンタープライズ)
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
SSOとは?
「SSO とは?」セクションシングルサインオン (SSO) を使用すると、会社のアイデンティティプロバイダー (IdP) を利用してチームが Capgo にログインできるようになります。Capgo は Supabase Auth を介して SAML 2.0 を使用します。ユーザーのメールドメインが有効な SSO プロバイダーと一致する場合、ユーザーは IdP で認証を行い、SSO コールバック時に組織へプロビジョニングされます。
SSO はユーザーができることを変更するものではありません。権限は 組織のロール によって制御されます。SSO は認証方法を変えるだけです。
前提条件
「前提条件」セクション開始する前に:
- Capgo 組織でエンタープライズサブスクリプションが有効です。
- 以下をサポートするアイデンティティプロバイダー SAML 2.0 および IdP メタデータ URL (HTTPS)を公開できること。
- メールドメイン用の DNS TXT レコード を公開できること(例:
company.comでログインするユーザーの場合)user@company.com). - 組織設定の更新権限を持つ Capgo の組織メンバー。
- 一つの IdP管理者 IT/セキュリティ側の担当者
SSO設定の場所
「SSO設定の場所」セクション- 開く https://console.capgo.app/
- クリック 設定 左サイドバー内
- 次の 組織 タブ
- 次の セキュリティ タブ
- までスクロール SSOの設定. このフォームは、組織がEnterpriseプランの場合のみ利用可能です。
ステップ 1 - IdPの設定
「Step 1 - Configure your IdP」というセクションIDプロバイダーで、新しいSAML 2.0アプリケーションを作成します。以下の情報が必要です: サービスプロバイダー Capgo SSO設定パネルに表示されている値:
| 項目 | 利用場所 |
|---|---|
| ACS URL | IdPのSAMLアプリにおけるAssertion Consumer Service URL |
| エンティティID | Service Providerのエンティティ識別子 |
| SPメタデータURL | 任意: IdPがURLによるSPメタデータのインポートに対応している場合 |
| NameID形式 | SAML Name Identifierに期待される形式 |
IdPはユーザーの メールアドレスを アサーション内でリリースする必要があります。Capgo はメールドメインを使用して、アクティブなSSOプロバイダーの特定と既存アカウントとの照合を行います。
ステップ 2 - Capgo にSSOプロバイダーを追加
セクション「ステップ 2 - Capgo に SSO プロバイダーを追加」- SSO 設定パネルで、クリックして新しいプロバイダーを追加します
- 入力してください メールドメイン (例
company.com)。ユーザーのサインイン用メールのドメイン部分と一致する必要があります - IdP の メタデータ URL (HTTPS)
- 提出
プロバイダーはステータス付きで作成されます 検証待ち.
ステップ 3 - DNSドメインの検証
セクション「ステップ 3 - DNS ドメイン検証」Capgo は、SSO が有効になる前にドメインの管理権限を確認します。
他の依存関係用の TXT レコードを DNS プロバイダーに設定してください:
| 項目 | 値 |
|---|---|
| 種類 | TXT |
| 名前 / ホスト | _capgo-sso.<your-domain> (例 _capgo-sso.company.com) |
| 値 | ダッシュボードのパネルに表示される検証トークン |
レコードが公開されたら(DNS TTL の伝播には通常数分〜1時間かかります)、 DNS を検証 をダッシュボードでクリックします。成功すると、プロバイダーは 検証済み.
ステップ 4 - プロバイダーの有効化
「ステップ 4 - プロバイダーを有効にする」セクションDNS 検証後、 アクティブ化。プロバイダーのステータスは 提供中。 提供中 のみがSSOログインフローで使用されます。
をダッシュボードでいつでも選択できます。これにより、プロバイダーは 無効化 に移動し、そのドメインのSSOを削除せずに一時停止します。 無効セクション「ステップ5 - テストとロールの割り当て」
ステップ 5 - テストとロールの割り当て
セクション「ステップ5 - テストとロールの割り当て」ユーザーがSSOで初めてサインインし、その組織に既存のメンバーシップがない場合、Capgoは彼らに 読み取り ロールを付与します。
パイロットユーザーがサインインした後:
- 以下に移動します: 設定 → 組織 → メンバー
- SSOでプロビジョニングされた各ユーザーを見つけます
- ロールを適切なレベルに調整します (アップロード, Write, 管理者など)
詳細については、 権限の詳細 各ロールの権限について。
オプション - SSOの強制適用
セクション「任意 - SSOの強制」の 提供中 プロバイダーで SSOの強制。有効にすると、Capgo はそのメールドメインの既存の認証ユーザーを SSO 専用としてマークし、そのドメインのログインフローでは IdP 認証が必須になります。プロバイダーを 無効 (無効化) に設定するか、強制をオフにすると、そのドメインの SSO 専用フラグが解除されます。
プロバイダーのステータス一覧
「プロバイダーステータスリファレンス」セクション| ステータス | 意味 |
|---|---|
| 検証待ち | DNS TXT レコードがまだ検証されていません |
| 検証済み | ドメインの所有権を確認済み。有効化できます |
| 提供中 | このドメインでSSOが有効です |
| 無効 | 設定者: 無効化 ダッシュボードで無効化してください。そのドメインではSSOは使用されていません。使用してください 再有効化 に戻るには 提供中 |
導入チェックリスト
「ロールアウトチェックリスト」セクション- エンタープライズプランの確認
- IdPにACS URLとEntity IDを指定してSAMLアプリを作成 (Capgo)
- IdPで安定したメールクレームをリリースするように設定
- DNS TXTレコードを公開し DNSを確認 成功しました
- プロバイダーを有効化
- パイロットユーザーが正常にサインイン
- ロールをデフォルトから昇格 読み取り 必要に応じて
- 強制決定が実行され(有効な場合は通知)
関連ドキュメント
「関連ドキュメント」セクションSSO (Enterprise) の次のステップ
「SSO (Enterprise) の次のステップ」セクション使用している場合 SSO (エンタープライズ) 認証とアカウントフローを計画するには、これを次と連携させてください @capgo/capacitor-social-login @capgo/capacitor-social-login の実装の詳細については、 @capgo/capacitor-passkey @capgo/capacitor-passkey の実装詳細については、 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric の実装の詳細については、 2要素認証 二要素認証の実装の詳細については、また、 Capacitor アプリにOAuth2を実装する5つのステップ Capacitor アプリで OAuth2 を実装する 5 ステップの実践的な文脈については。