snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ja/user-guide/permissions-access/capabilities/permissions.mdx

@@ -0,0 +1,213 @@
+---
+title: 権限
+description: ロールベースの権限でオブジェクト、フィールド、設定へのアクセスを制御します。
+---
+
+Twentyの権限システムにより、3つの主要な領域へのアクセスを制御できます:
+
+* **オブジェクトとフィールド**: レコードと個々のフィールドを表示、編集、削除できる人を制御する
+* **設定**: ワークスペースの構成および管理機能へのアクセスを管理する
+* **アクション**: データのインポートやメールの送信など一般的なワークスペースアクションを制御する
+
+## ロールの作成
+
+新しい役割を作成するには:
+
+1. **設定 → メンバー → 役割** に移動します
+2. **すべての役割** で、 **+ 役割を作成** をクリック
+3. 役割名を入力
+4. デフォルトの**権限**タブで、[権限を設定](#customize-permissions)
+5. **保存**をクリックして完了します
+
+## 役割を削除する
+
+役割を削除するには:
+
+1. **設定 → メンバー → 役割** に移動します
+2. 削除したい役割をクリック
+3. **設定** タブを開き、 **役割を削除** をクリック
+4. モーダルで **確認** をクリック
+
+<Note>
+ロールが削除されると、そのロールに割り当てられていたワークスペースメンバーは自動的にデフォルトのロールに再割り当てされます。 **管理者** ロール以外のすべてのロールは削除できます。 **管理者** 役割には常に少なくとも1人のメンバーが割り当てられている必要があります。
+</Note>
+
+## メンバーに役割を割り当てる
+
+### 現在の割り当てを表示
+
+* **設定 → メンバー → 役割** に移動します
+* すべての役割と各役割に割り当てられているメンバー数を確認
+* どのメンバーがどの役割を持っているかを表示
+
+### メンバーに役割を割り当てる
+
+1. **設定 → メンバー → 役割** に移動します
+2. 割り当てたい役割をクリック
+3. **割り当て** タブを開く
+4. **+ メンバーに割り当てる** をクリック
+5. リストからワークスペースメンバーを選択
+6. 割り当てを確認する
+
+### デフォルトの役割を設定する
+
+1. **設定 → メンバー → 役割** に移動します
+2. **オプション** セクションで **デフォルトの役割** を見つける
+3. 新しいメンバーが自動的に受け取る役割を選択
+4. 新しいワークスペースメンバーが参加するとき、この役割が割り当てられます
+
+<Note>
+ロールは既存のワークスペースメンバーにのみ割り当てできます。 新しいメンバーを招待するには、[メンバー管理](/l/ja/user-guide/settings/capabilities/member-management)を使用します。
+</Note>
+
+## 権限をカスタマイズする
+
+権限は、ワークスペースのオブジェクト、レコード、設定、アクションなど、ワークスペース内で各ロールにアクセスまたは変更できるものを決定します。
+
+### オブジェクトの権限
+
+**オブジェクト**セクションでは、このロールがワークスペース全体のレコードに対して何ができるかを制御します。
+
+#### デフォルトの権限を設定（すべてのオブジェクト）
+
+まず、デフォルトで**すべてのオブジェクト**に適用されるベースライン権限を設定します。
+
+| 権限                    | 説明                  |
+| --------------------- | ------------------- |
+| **全オブジェクトでレコードを表示する** | リストおよび詳細ページでレコードを表示 |
+| **全オブジェクトでレコードを編集する** | 既存のレコードを変更          |
+| **全オブジェクトでレコードを削除する** | レコードをソフト削除（復元可能）    |
+| **全オブジェクトでレコードを破棄する** | レコードを完全に削除          |
+
+このロールのデフォルトの動作にすべき内容に基づいて選択または選択解除します。
+
+<Note>
+**例 — インターン ロール**: インターンは、デフォルトではすべてのオブジェクトを閲覧できるが編集はできないようにします。 "すべてのオブジェクトでレコードを表示"を有効にし、"すべてのオブジェクトでレコードを編集"は未選択のままにします。
+</Note>
+
+#### オブジェクトレベルの例外を追加
+
+デフォルトを設定したら、**オブジェクトレベル**のサブセクションで特定のオブジェクトに対してデフォルトを上書きするルールを追加します。
+
+**+ ルールを追加**をクリックし、オブジェクトを選択して例外を作成します。
+
+**インターン ロールのルール例:**
+
+| ルール                           | 効果                                    |
+| ----------------------------- | ------------------------------------- |
+| Opportunities → "レコードを表示"を無効化 | インターンはOpportunitiesオブジェクトをまったく閲覧できません |
+| People → "レコードを編集"を有効化        | インターンはPeopleのレコードを編集できます（他のオブジェクトは不可） |
+
+### 行レベルの権限
+
+<Note>
+行レベルの権限は、**プレミアム機能**であり、（クラウド版およびセルフホスト版の）**Organization**プランで利用できます。
+</Note>
+
+行レベルの権限を使用すると、動的な条件に基づいて、あるロールが閲覧または編集できる個々のレコードを制限できます。 オブジェクト権限（オブジェクト種別全体に適用される）とは異なり、行レベルの権限は各レコードを個別に評価します。
+
+**ユースケース例:**
+
+* 営業担当者は自分の商談のみを閲覧できる
+* マネージャーは自分の担当地域内のすべてのレコードを閲覧できる
+* サポート担当者は自分に割り当てられたチケットのみを閲覧できる
+
+行レベルの権限を設定するには、ロールを開き、**Objects**タブに移動して、**Row-Level**セクションで特定のオブジェクトに対するフィルター条件を定義します。
+
+### フィールドの権限
+
+各オブジェクトレベルのルール内で、さらに踏み込んで特定のフィールドへのアクセスを制御するための**フィールドレベルの権限**を設定できます。
+
+| 権限           | 説明           |
+| ------------ | ------------ |
+| **フィールドを表示** | フィールド値を表示    |
+| **フィールドを編集** | フィールド値を変更    |
+| **アクセス不可**   | フィールドは完全に非表示 |
+
+**例 — 機微なフィールドの制限:**
+
+Peopleの編集権限を持つインターン ロールでは、特定のフィールドを制限したい場合があります。
+
+* People → Email → **フィールドを表示**のみ（編集不可）
+* People → Address → **アクセス不可**（完全に非表示）
+
+これにより、インターンはPeopleのほとんどのフィールドを編集できる一方、機微情報は保護されます。
+
+### 権限の継承のしくみ
+
+権限は一般から個別へと段階的に適用されます。
+
+1. **すべてのオブジェクト** → すべてのオブジェクトに対するベースラインを設定
+2. **オブジェクトレベルのルール** → 特定のオブジェクトのベースラインを上書き
+3. **フィールドレベルのルール** → 特定のフィールドについてオブジェクトの設定を上書き
+
+より具体的な設定が常に優先されます。
+
+### 権限オーバーライドを管理する
+
+継承された権限を上書きするには:
+
+1. 継承されたルールを削除するには **X** をクリック
+2. 必要な特定の権限を選択
+3. 変更を元に戻すには、オレンジ色の **元に戻す** アイコン（円形の矢印）をクリック
+
+完了したら、役割ページにリダイレクトされたら **終了** をクリックし、**保存** をクリック。
+
+### ワークスペース設定の権限
+
+ワークスペース設定へのアクセスを2つの方法で制御する:
+
+* **すべてのアクセスを設定** を切り替えて完全アクセスを許可する
+* あるいは、特定の権限（例えば、APIキー生成、ワークスペース設定、役割割り当て、データモデル構成、セキュリティ設定、ワークフロー管理）を有効にする
+
+<Note>
+**現在の制限**: ワークフローを手動でトリガーするには、現在、ワークフロー管理へのアクセスが必要です。 この動作は今後のリリースで変更される可能性があります。
+</Note>
+
+### ワークスペースアクションの権限
+
+一般的なワークスペースアクションへのアクセスを制御する:
+
+* **すべてのアプリケーションのアクセス** を切り替えて完全な権限を与える
+* あるいは、 **メール送信**, **CSVインポート**, **CSVエクスポート** などの個別のアクションを有効にする
+
+## APIキーとAIエージェントにロールを割り当てる
+
+ワークスペースメンバー以外にも、**API キー**や**AI エージェント**にロールを割り当てることができます。 これは、ワークスペース内で誰が何をできるかを正確に制御したいチーム、特に自動化プロセスや連携を含む場合に有用です。
+
+### API キーとAI エージェントにロールを割り当てる理由
+
+* **セキュリティ**: 自動化プロセスがアクセスまたは変更できる範囲を制限
+* **コンプライアンス**: 連携が必要なデータのみに触れるようにする
+* **制御**: 誤設定された自動化による偶発的なデータ変更を防止
+* **監査可能性**: どの連携またはエージェントがどの操作を実行したかを追跡
+
+### API キーにロールを割り当てる
+
+1. **設定 → メンバー → 役割** に移動します
+2. 割り当てたい役割をクリック
+3. **割り当て** タブを開く
+4. **API キー**セクションで、**+ API キーに割り当て**をクリック
+5. リストからAPI キーを選択
+6. 割り当てを確認する
+
+そのAPI キーは、割り当てたロールで定義されたすべての権限を継承します。 このキーで行われるAPI 呼び出しは、それに応じて制限されます。
+
+<Note>
+ロールが割り当てられていないAPI キーはデフォルトの権限を使用します。 より厳格なセキュリティのため、本番のAPI キーには必ず特定のロールを割り当ててください。
+</Note>
+
+### AI エージェントにロールを割り当てる
+
+1. **設定 → メンバー → 役割** に移動します
+2. 割り当てたい役割をクリック
+3. **割り当て** タブを開く
+4. **AI エージェント**セクションで、**+ AI エージェントに割り当て**をクリック
+5. リストからAI エージェントを選択
+6. 割り当てを確認する
+
+AI エージェントは、割り当てられたロールで許可されたデータへのアクセスと操作のみ実行できます。
+
+<Note>
+ワークフロー内で実行されるAI エージェントについては、ワークフローにより広い権限があっても、意図した範囲外のデータにアクセスまたは変更できないことを保証します。
+</Note>

packages/twenty-docs/l/ja/user-guide/permissions-access/capabilities/sso-configuration.mdx

@@ -0,0 +1,125 @@
+---
+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>

packages/twenty-docs/l/ja/user-guide/permissions-access/how-tos/permissions-faq.mdx

@@ -0,0 +1,120 @@
+---
+title: 権限に関するFAQ
+description: ロールと権限に関するよくある質問。
+---
+
+## 役割
+
+<AccordionGroup>
+<Accordion title="Twenty にはデフォルトでどのようなロールがありますか？">
+デフォルトでは、**管理者** と **メンバー** のロールが20個付いています。 チームのニーズに基づいて、追加のカスタムロールを作成できます（例: 営業担当、マネージャー、閲覧専用ユーザー）。
+</Accordion>
+
+<Accordion title="Admin ロールを削除できますか？">
+いいえ、Admin ロールは削除できません。 Admin ロールには、常に少なくとも1人のメンバーが割り当てられている必要があります。
+</Accordion>
+
+<Accordion title="ロールを削除するとどうなりますか？">
+そのロールに割り当てられているワークスペースメンバーは、自動的にデフォルトのロールに再割り当てされます。
+</Accordion>
+
+<Accordion title="新規メンバーのデフォルトロールはどのように設定しますか？">
+**設定 → メンバー → 役割** に移動し、**Default Role** オプションを見つけ、参加時に新規メンバーに自動的に付与される役割を選択します。
+</Accordion>
+
+<Accordion title="1人のユーザーに複数のロールを割り当てることはできますか？">
+いいえ、各ユーザーが同時に持てるロールは1つだけです。 権限の組み合わせが必要な場合は、カスタムロールを作成してください。
+</Accordion>
+</AccordionGroup>
+
+## 権限
+
+<AccordionGroup>
+<Accordion title="オブジェクト権限とフィールド権限の違いは何ですか？">
+* **オブジェクト権限**: レコード全体へのアクセスを制御します（例: People レコードの閲覧/編集/削除が可能）
+* **フィールド権限**: オブジェクト内の特定のフィールドへのアクセスを制御します（例: Salary フィールドは閲覧のみで編集不可）
+
+フィールド権限により、機密データをより細かく制御できます。
+</Accordion>
+
+<Accordion title="権限のオーバーライドはどのように機能しますか？">
+権限は一般から個別へと段階的に適用されます。
+1. **All Objects** はすべてのオブジェクトの基準を設定します
+2. **Object-Level Permissions** は、特定のオブジェクトに対してグローバル設定を上書きできます
+3. **Field-Level Permissions** は、特定のフィールドに対してオブジェクト設定を上書きできます
+
+より具体的な設定が常に優先されます。
+</Accordion>
+
+<Accordion title="各権限レベルは何を意味しますか？">
+オブジェクトの場合:
+* **See Records**: リストや詳細ページでレコードを閲覧
+* **Edit Records**: 既存のレコードを編集
+* **Delete Records**: レコードをソフト削除（復元可能）
+* **Destroy Records**: レコードを完全に削除
+
+フィールドの場合:
+* **See Field**: フィールド値を閲覧
+* **Edit Field**: フィールド値を編集
+* **No Access**: フィールドは完全に非表示
+</Accordion>
+
+<Accordion title="特定のレコードへのアクセスを制限できますか（行レベル権限）？">
+行レベルの権限は **Organization** プランで利用できます。 これにより、条件に基づいて特定のレコードへのアクセスを制限できます（例: 自分の商談のみを閲覧）。
+</Accordion>
+
+<Accordion title="特定のユーザーに対してフィールドを読み取り専用にするにはどうすればよいですか？">
+1. **設定 → メンバー → 役割** に移動します
+2. ロールを選択
+3. 該当フィールドを含むオブジェクトに移動
+4. フィールド権限を **See Field** に設定します（Edit Field は付与しない）
+</Accordion>
+</AccordionGroup>
+
+## 設定とアクション
+
+<AccordionGroup>
+<Accordion title="設定に関する権限には何がありますか？">
+次の項目へのアクセスを制御できます:
+* API キーの生成
+* ワークスペースの設定
+* ロールの割り当て
+* データモデルの設定
+* セキュリティ設定
+* ワークフロー管理
+
+**Settings All Access** を使ってフルアクセスを付与するか、特定の権限のみを有効にします。
+</Accordion>
+
+<Accordion title="アクションに関する権限には何がありますか？">
+次の項目を制御できます:
+* **Send Email**: Twenty からメールを送信できる
+* **Import CSV**: CSV でデータをインポートできる
+* **Export CSV**: データを CSV にエクスポートできる
+
+**Application All Access** を使ってすべてのアクションを付与するか、必要なものだけを有効にします。
+</Accordion>
+</AccordionGroup>
+
+## SSO
+
+<AccordionGroup>
+<Accordion title="SSO はすべてのプランで利用できますか？">
+いいえ、SSO は **Organization** プランでのみ利用可能なプレミアム機能です。
+</Accordion>
+
+<Accordion title="どのアイデンティティプロバイダーがサポートされていますか？">
+Twenty は次のものをサポートしています:
+* **SAML 2.0**（多くのエンタープライズ向けアイデンティティプロバイダーで動作）
+* **Google Workspace**
+* **Microsoft Entra ID**（旧 Azure AD）
+</Accordion>
+
+<Accordion title="Just-in-Time（JIT）プロビジョニングとは何ですか？">
+JIT プロビジョニングでは、ユーザーが初めて SSO でログインした際に、Twenty にユーザーアカウントが自動作成されます。 デフォルトのロールが自動的に割り当てられます。
+</Accordion>
+
+<Accordion title="すべてのユーザーに SSO を必須にできますか？">
+はい、SSO を設定すると、SSO ユーザーのパスワードログインを無効化し、アイデンティティプロバイダーを通じた認証を強制できます。
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/ja/user-guide/permissions-access/overview.mdx

@@ -0,0 +1,34 @@
+---
+title: 権限とアクセス
+description: ワークスペースのロール、権限、およびアクセス制御を管理します。
+---
+
+Twentyの権限システムは、ワークスペース内のデータに誰がアクセスし、変更できるかを制御できます。 ロールを作成し、権限を割り当て、安全なアクセスのためにSSOを構成します。
+
+## このセクションの内容
+
+<CardGroup cols={2}>
+  <Card title="権限" icon="lock" href="/l/ja/user-guide/permissions-access/capabilities/permissions">
+    ロールを作成し、オブジェクト、フィールド、設定の権限を構成します。
+  </Card>
+  <Card title="SSO構成" icon="key" href="/l/ja/user-guide/permissions-access/capabilities/sso-configuration">
+    アイデンティティプロバイダーでシングルサインオンを設定します。
+  </Card>
+  <Card title="よくある質問" icon="circle-question" href="/l/ja/user-guide/permissions-access/how-tos/permissions-faq">
+    ロール、権限、SSOに関するよくある質問。
+  </Card>
+</CardGroup>
+
+## 主な機能
+
+* **ロールベースのアクセス**: 特定の権限を持つカスタムロールを作成
+* **オブジェクト権限**: レコードを表示、編集、または削除できるユーザーを制御
+* **フィールド権限**: 機微なフィールドへのアクセスを制限
+* **設定権限**: ワークスペースの構成へのアクセスを制御
+* **SSO統合**: エンタープライズセキュリティのためにシングルサインオンを構成（Organization プラン）
+
+## クイックリンク
+
+* [ロールを作成](/l/ja/user-guide/permissions-access/capabilities/permissions#create-a-role)
+* [SSOを構成](/l/ja/user-guide/permissions-access/capabilities/sso-configuration)
+* [チームメンバーを管理](/l/ja/user-guide/settings/capabilities/member-management)