メインコンテンツへスキップ

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/セキュリティ側の担当者
  1. 開く https://console.capgo.app/
  2. クリック 設定 左サイドバー内
  3. 次の 組織 タブ
  4. 次の セキュリティ タブ
  5. までスクロール SSOの設定. このフォームは、組織がEnterpriseプランの場合のみ利用可能です。

IDプロバイダーで、新しいSAML 2.0アプリケーションを作成します。以下の情報が必要です: サービスプロバイダー Capgo SSO設定パネルに表示されている値:

項目利用場所
ACS URLIdPのSAMLアプリにおけるAssertion Consumer Service URL
エンティティIDService Providerのエンティティ識別子
SPメタデータURL任意: IdPがURLによるSPメタデータのインポートに対応している場合
NameID形式SAML Name Identifierに期待される形式

IdPはユーザーの メールアドレスを アサーション内でリリースする必要があります。Capgo はメールドメインを使用して、アクティブなSSOプロバイダーの特定と既存アカウントとの照合を行います。

ステップ 2 - Capgo にSSOプロバイダーを追加

セクション「ステップ 2 - Capgo に SSO プロバイダーを追加」
  1. SSO 設定パネルで、クリックして新しいプロバイダーを追加します
  2. 入力してください メールドメイン (例 company.com)。ユーザーのサインイン用メールのドメイン部分と一致する必要があります
  3. IdP の メタデータ URL (HTTPS)
  4. 提出

プロバイダーはステータス付きで作成されます 検証待ち.

ステップ 3 - DNSドメインの検証

セクション「ステップ 3 - DNS ドメイン検証」

Capgo は、SSO が有効になる前にドメインの管理権限を確認します。

他の依存関係用の TXT レコードを DNS プロバイダーに設定してください:

項目値
種類TXT
名前 / ホスト_capgo-sso.<your-domain> (例 _capgo-sso.company.com)
値ダッシュボードのパネルに表示される検証トークン

レコードが公開されたら(DNS TTL の伝播には通常数分〜1時間かかります)、 DNS を検証 をダッシュボードでクリックします。成功すると、プロバイダーは 検証済み.

DNS 検証後、 アクティブ化。プロバイダーのステータスは 提供中。 提供中 のみがSSOログインフローで使用されます。

をダッシュボードでいつでも選択できます。これにより、プロバイダーは 無効化 に移動し、そのドメインのSSOを削除せずに一時停止します。 無効セクション「ステップ5 - テストとロールの割り当て」

ステップ 5 - テストとロールの割り当て

セクション「ステップ5 - テストとロールの割り当て」

ユーザーがSSOで初めてサインインし、その組織に既存のメンバーシップがない場合、Capgoは彼らに 読み取り ロールを付与します。

パイロットユーザーがサインインした後:

  1. 以下に移動します: 設定 → 組織 → メンバー
  2. SSOでプロビジョニングされた各ユーザーを見つけます
  3. ロールを適切なレベルに調整します (アップロード, Write, 管理者など)

詳細については、 権限の詳細 各ロールの権限について。

オプション - SSOの強制適用

セクション「任意 - SSOの強制」

の 提供中 プロバイダーで SSOの強制。有効にすると、Capgo はそのメールドメインの既存の認証ユーザーを SSO 専用としてマークし、そのドメインのログインフローでは IdP 認証が必須になります。プロバイダーを 無効 (無効化) に設定するか、強制をオフにすると、そのドメインの SSO 専用フラグが解除されます。

ステータス意味
検証待ちDNS TXT レコードがまだ検証されていません
検証済みドメインの所有権を確認済み。有効化できます
提供中このドメインでSSOが有効です
無効設定者: 無効化 ダッシュボードで無効化してください。そのドメインではSSOは使用されていません。使用してください 再有効化 に戻るには 提供中
  • エンタープライズプランの確認
  • IdPにACS URLとEntity IDを指定してSAMLアプリを作成 (Capgo)
  • IdPで安定したメールクレームをリリースするように設定
  • DNS TXTレコードを公開し DNSを確認 成功しました
  • プロバイダーを有効化
  • パイロットユーザーが正常にサインイン
  • ロールをデフォルトから昇格 読み取り 必要に応じて
  • 強制決定が実行され(有効な場合は通知)

使用している場合 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 ステップの実践的な文脈については。