ロールと権限

人やサービスに業務上必要な権限を付与し、ロール、リソースへの権限付与、利用資格の関係を理解しましょう。

ローカライゼーションエンジンの設定を閲覧する同僚に、設定の変更、そのエンジンでの翻訳、出力の承認まで許可する必要があるとは限りません。権限を使えば、こうした役割を分けられます。実際のアクセス範囲は、メンバー資格、ロールの権限、リソースへの権限付与、機能の利用資格、そして操作自体で行われるチェックの組み合わせで決まります。

ロールと権限付与は、権限を追加する仕組みです。すべてのローカライゼーションエンジンへのアクセスを許可するロールがすでにある場合、特定のエンジンへのアクセスを付与しても、そのロールの権限は制限されません。まず担当すべき業務を明確にし、その業務に関わる権限がどこから付与されているかをすべて確認してください。

権限一覧 #

分野権限
組織管理org:manage_team, org:manage_billing, org:manage_settings, org:manage_api_keys, org:manage_integrations, org:delete, org:view_audit_logs
判定プールorg:manage_decision_pools
ローカライゼーションエンジンとレビューengine:read, engine:translate, engine:create, engine:edit, engine:delete, engine:review_translations, org:manage_reviews
用語集org:glossary:read, org:glossary:edit
ブランドボイスorg:brandvoice:read, org:brandvoice:edit
ルールセットorg:ruleset:read, org:ruleset:edit
提案org:suggestion:read, org:suggestion:edit

提案の閲覧と判定 #

ロールを通じて提案を閲覧できるようにするには、そのロールにorg:suggestion:readと、対象のローカライゼーションエンジンへの閲覧権限を付与します。提案を適用または却下できるようにするには、org:suggestion:editと、対象エンジンへの編集権限を付与します。エンジンの権限だけでは、提案に対する権限は得られません。

エンジンへの権限を明示的に付与された組織メンバーは、ロールに提案の権限がなくても、そのエンジンの提案を閲覧し、判定できます。この権限付与は対象のエンジンにのみ適用され、組織内のすべてのエンジンへのアクセスを許可するものではありません。組織のメンバーであることは引き続き必要です。

翻訳のレビュー #

人によるレビューで判定を行うには、ユーザーを識別できること、組織のメンバーであること、対象エンジンの翻訳をレビュー(engine:review_translations)権限を持つことが必要です。ユーザーの識別には、ログイン中のユーザー情報または個人用APIキーを使用できます。レビュー履歴の閲覧権限があっても、判定権限があるとは限りません。

プランの利用条件は、新しいレビュー作業の開始時に確認されます。レビュー権限を持つユーザーは、プランのダウングレード後も、既存のドキュメントレビューを閲覧し、判定できます。レビューがブロックされる原因を調べるには、機能へのアクセスを参照してください。

レビュー権限を付与しても、すべての翻訳が人による対応を待つようになったり、レビュー済みの文言が後続の段階でも維持されたりするわけではありません。これらはレビューポリシーの設定で決まります。

判定プールの作成、編集、アーカイブには、判定プールを管理(org:manage_decision_pools)権限が必要です。内部プールへの所属によってレビュー通知の受信対象が決まりますが、翻訳をレビュー権限が付与されるわけではありません。必要な条件の詳細は、プランと権限を参照してください。

カスタムロールの作成と管理 #

オーナーはプラットフォームが管理するシステムロールで、編集や削除はできません。カスタムロールは組織に属し、その管理にはロールベースのアクセス制御の利用資格とorg:manage_teamが必要です。操作の実行者は、自身が実際に持つ権限を超える権限を作成したり、付与したりすることはできません。

設定 → ロールで新しいロールを選択し、名前と説明を入力して権限を選び、ロールを作成を選択します。次に設定 → チームを開き、メンバーにある対象メンバーのロール選択欄からロールを選びます。メンバーに利用を依頼する前に、割り当てが保存されていることを確認してください。

オーナー権限を付与または解除できるのは、オーナーだけです。また、最後のオーナーを降格させたり、削除したりすることはできません。責任者が不在になるような所有権の変更を行う前に、後任をオーナーに昇格させ、正しく反映されていることを確認してください。

カスタムロールを編集する前に、そのロールを使用しているメンバーとサービスキーを確認してください。認証情報を差し替えなくても、アクセス権が変わる可能性があります。ロールを削除する前には、そのロールを参照するサービスキーを別のロールに割り当て直すか、失効させてください。参照が残っていると削除できません。

メンバーに割り当てられたカスタムロールを削除すると、ロールへの参照が解除されますが、別の名前付きロールが割り当てられるわけではありません。そのメンバーには、リソースへの権限付与が残っている場合があります。そのため、ロールが空欄でも、アクセス権がないとは限りません。

リソースへの権限付与 #

リソースへの権限付与により、選択したローカライゼーションエンジン、用語集、ブランドボイス、ルールセットへとメンバーの権限を拡張できます。ただし、組織のメンバーであることは引き続き必要です。権限付与の情報が保存されていても、非メンバーが組織のメンバーになるわけではありません。ローカライゼーションエンジンの閲覧によって、その設定を理解するために必要な関連コンテンツも閲覧できる場合があります。

アクセス対象を限定するには、権限範囲を絞ったロールと、必要なリソースへの権限付与を組み合わせます。ロールがすでにすべてのローカライゼーションエンジンへのアクセスを許可している場合、特定のエンジンへの権限付与を追加しても、範囲は狭まりません。アクセスを制限したい場合は、ロールの広範な権限を取り除いてください。

きめ細かな権限付与には、ダッシュボードからの操作ではなく、APIやMCP操作が必要になる場合があります。ユーザーであるメンバーへの権限付与とサービスキーのスコープは別のものなので、それぞれ個別に確認してください。

個人用と組織用のサービスキーは、すべてのプランで利用できます。ロールベースのアクセス制御を利用しない場合、サービスキーは組織内のすべてのローカライゼーションエンジンを閲覧し、それらを使って翻訳できますが、編集、削除、レビュー、管理はできません。カスタムロールとリソース単位の制限には、Enterpriseのロールベースのアクセス制御が必要です。

アクセス権の変更 #

ロールベースのアクセス制御の利用資格が有効から無効、または無効から有効に切り替わると、メンバーと保留中の招待のロールがオーナーにリセットされます。これにより、以前に選択していたロールよりもアクセス範囲が広がる可能性があります。請求に関する変更は関係者と調整し、変更後にすべてのメンバーと保留中の招待を確認して、必要に応じて意図したロールに戻してください。

メンバーが組織を離れる際は、メンバー資格と認証情報を別々に確認してください。組織用サービスキーは、特定のメンバーが組織に在籍し続けるかどうかに依存しません。進行中の業務に必要なアクセス権を削除する前に、別のオーナーを確保し、呼び出し元に依存している箇所を別の呼び出し元に切り替えてください。

機能へのアクセスは、利用資格による問題と権限による問題の切り分けに役立ちます。監査ログでは記録された変更を確認できますが、今どの操作が許可されるかは、現在のロール、権限付与、操作自体によって決まります。