Files
upstream-mirror e7da97194a
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s
snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
2026-09-17 23:28:13 +05:00

126 lines
4.8 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: SSO構成
description: 安全なエンタープライズ認証のためにシングルサインオンを構成します。
---
## SSO について
シングルサインオン(SSO)により、組織の ID プロバイダーを使用してチームメンバーが Twenty にログインできます。 これにより、次のことが可能になります:
* **一元的なアクセス制御**: 1 か所からアクセスを管理
* **強化されたセキュリティ**: 既存のセキュリティポリシーを活用
* **優れたユーザー体験**: すべてのツールで 1 組の認証情報を使用
## サポート対象のプロバイダー
Twenty は次の SSO をサポートしています:
* **SAML 2.0**: ほとんどのエンタープライズ ID プロバイダーで動作
* **Google Workspace**: Google を利用する組織向け
* **Microsoft Entra ID** (旧 Azure AD): Microsoft 環境用
## SSO のセットアップ
### 前提条件
* Organization プラン(クラウドおよびセルフホストのワークスペース)
* ID プロバイダーへの管理者アクセス権
* Twenty ワークスペースへの管理者アクセス
### 構成手順
#### 1. SSO 設定にアクセス
1. **設定 → セキュリティ** に移動します
2. **SSO 構成** セクションを見つけます
3. **SSO を構成** をクリック
#### 2) プロバイダーを選択
一覧から ID プロバイダーを選択するか、その他のプロバイダーの場合は「Custom SAML」を選択します。
#### 3. ID プロバイダーを構成
ID プロバイダーで次を設定する必要があります:
* **エンティティ ID**: Twenty が提供
* **ACS URL**: 認証用のコールバック URL
* **証明書**: セキュアな通信のため
#### 4. Twenty にプロバイダーの詳細を入力
* **SSO URL**: プロバイダーのログイン URL
* **エンティティ ID**: プロバイダーの識別子
* **証明書**: プロバイダーの X.509 証明書
#### 5. テストして有効化
1. セットアップを確認するには **構成をテスト** をクリック
2. テストが成功したら SSO を有効化します
3. ユーザー プロビジョニングの設定を行います
## ユーザー プロビジョニング
### ジャストインタイム(JIT)プロビジョニング
* 初回ログイン時にユーザーが自動作成されます
* ユーザーにはデフォルトの役割が自動的に割り当てられます
* 手動でユーザーを作成する必要はありません
### 手動プロビジョニング
* ログイン可能になる前にユーザーを招待します
* 特定のロールを事前に割り当てます
* 誰がワークスペースにアクセスできるかをより詳細に制御します
## SSO ユーザーの管理
### ロールの割り当て
SSO ユーザーには、通常のユーザーと同様にロールを割り当てられます:
1. **設定 → メンバー** に移動
2. ユーザーを見つけます
3. 必要に応じてロールを変更します
### アクセスの取り消し
SSO ユーザーのアクセスを削除するには:
* ID プロバイダーから削除する、または
* Twenty のワークスペースから削除します
## ベストプラクティス
### セキュリティ
* **SSO を必須にする**: SSO ユーザーのパスワードログインを無効化
* **定期的な監査**: 定期的にアクセスを見直す
* **強力な IdP ポリシー**: ID プロバイダーで MFA を強制
### ユーザー管理
* **明確な命名**: ディレクトリで一貫した命名を使用
* **グループ マッピング**: IdP のグループを Twenty のロールにマッピング(可能な場合)
* **オフボーディング プロセス**: デプロビジョニングのワークフローに Twenty を含める
## トラブルシューティング
### 一般的な問題
* **証明書エラー**: 証明書の有効期限が切れていないことを確認してください
* **URLの不一致**: ACSのURLが一致していることを確認してください
* **ユーザーが見つからない**: JIT プロビジョニングの設定を確認
### サポートを受ける
問題が発生した場合は、次の情報を添えてサポートにお問い合わせください:
* 受信したエラーメッセージ
* 使用している ID プロバイダー
* 構成の詳細(機微なデータを除く)
<Tip>
組織向けに SSO の設定が必要ですか? SSO とアイデンティティのセットアップを専門とする[認定済みの Twenty パートナーを探す](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-sso)。 *(Twenty に直接相談したい場合は、 [contact@20y.com](mailto:contact@twenty.com)*
</Tip>