管理

Phraseアイデンティティ管理

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

プラットフォームのシングルログイン

Phraseローカリゼーションプラットフォームは、単一のログインまたはサインアップページを通じて、さまざまなPhrase製品へのシングルログインをサポートしています。https://eu.phrase.com(EUの群用)またはhttps://us.phrase.com(米国のデータセンター用)にアクセスし、プラットフォーム経由でサインアップまたはログインしてください。

プラットフォームにサインアップする新規ユーザーおよび既存のPhraseユーザーは、各製品で個別に認証を行うことなく、プラットフォームダッシュボード内の利用可能なすべての製品間を移動できます。

プラットフォームにログインしたら、左上隅にあるダッシュボードドロップダウンメニューを選択して、必要に応じてサブスクライブしているすべての製品を切り替えます。製品スイッチャーは、プラットフォームユーザープロファイルを持つすべてのユーザー向けに、各製品インターフェース内でも利用できます。

製品へのアクセス要件

  • 製品へのアクセスは、購入したプランによって定義されます

  • Phrase TMSとPhrase Strings

  • Phrase Orchestrator

    • TMSまたはStringsへのアクセス

  • Phrase Custom AI、Phrase Language AI、およびPhrase Analytics

備考

プラットフォームのプラン、各プランで利用可能な機能、および使用制限の詳細については、Phraseの料金ページをご覧ください。

既存のTMSまたはStringsユーザーは、ユーザー名とパスワードを入力するか、による認証を使用して、プラットフォームのログインページからログインできます。

注意

SSOが有効な場合、UIでのユーザーのメールアドレス変更はサポートされていません。SCIMで管理されているユーザーの場合、メールアドレスの変更はIDプロバイダーを通じて行われます。

IDメンバーシップステータス

ユーザーは、異なる複数のPhrase組織のメンバーになることができ、必要に応じてそれらの組織を切り替えることができます。データ保持ポリシーを遵守するため、組織のメンバーでありながらどの製品にもアクセス権を持たないユーザー(オーナーを除く)の個人データ(名前やメールアドレスなど)は、12か月間アクティビティがないと自動的に匿名化されます。

Phrase Platformの各ユーザーは、アカウントの作成方法と管理組織に基づいて、内部または外部のいずれかのIDメンバーシップステータスを持ちます。

  • 内部ユーザー

    組織内で直接作成された、またはSSO/SCIMを通じてプロビジョニングされたユーザー。内部組織(ホーム組織)は、プロファイル情報やログイン設定を含むユーザーのIDを完全に管理します。

  • 外部ユーザー

    別の組織に内部ユーザーとして所属しており、追加の組織でのコラボレーションに招待されたユーザー。外部組織はタスクを割り当てることはできますが、ユーザーのプロファイルやログイン資格情報を編集することはできません。

ユーザーは一度に1つの組織(または同じ組織グループ内であれば複数)で内部ユーザーとなることができ、他の組織では外部ユーザーとして表示される場合があります。

メンバーシップステータスは、プラットフォームダッシュボードのユーザーページに表示されます。

ログインに関する問題のトラブルシューティング

ログインに問題がある場合は、以下のトラブルシューティング手順を試してください。

  1. シークレットモードを試す

    最初のステップとして、シークレットウィンドウ(ブラウザの匿名モード)を開き、ログインを試みてください。ログインできた場合は、Phraseサイトに関連するブラウザのキャッシュ、Cookie、閲覧履歴を消去してください。

  2. 資格情報を確認する

    Cookieとキャッシュを消去しても解決しない場合は、正しいログイン資格情報が使用されていることを確認してください。

    • Phraseに複数のアカウントが存在する場合は、メールアドレスの代わりにユーザー名を入力してください。

    • の中から正しいデータセンターにログインしていることを確認してください。

  3. パスワードをリセットする

    パスワードを忘れた場合は、ログインページのパスワードをお忘れですか?をクリックし、パスワードリセットの手順に従ってください。

    パスワードをリセットした後、ブラウザが古い認証情報でログインフィールドを自動入力しないようにしてください。認証情報の誤入力を避けるため、キーボードが正しい言語に設定されていることを確認してください。

    パスワード復旧ページのreCAPTCHAは、地域のネットワーク制限により読み込まれない場合があります。この問題が発生した場合は、VPNやモバイルデータなど、別のネットワーク接続を試してください。それでもreCAPTCHAが読み込まれない場合は、Phraseサポートにお問い合わせください。

  4. 組織の切り替え(該当する場合)

    1つのアカウントが複数の組織に関連付けられている場合があります。誤った組織にログインしている場合は、組織を切り替えてください。

  5. 信頼できるIPアドレスの制限を確認する

    管理者は、設定 → アクセスとセキュリティ → ユーザーアクセスにある信頼できるIPアドレス設定を有効にすることで、Phrase TMSへのアクセスを制限し、許可されたIP範囲のリストにログインを限定できます。そのリスト外のネットワークから接続しているユーザーは、正しい認証情報を使用しても、ブロックされたり接続エラーが発生したりします。

    正しい認証情報を使用してもログインが継続的に失敗する場合は、現在のネットワークまたはIPアドレスが許可リストに含まれているかどうかを組織の管理者に確認してください。

プラットフォームのソーシャルログイン

Phraseプラットフォームは、以下のソーシャルプロバイダー経由のソーシャルログインをサポートしています。

  • Google

  • Microsoft

  • GitHub

https://eu.phrase.comまたはhttps://us.phrase.comにアクセスし、希望するソーシャルアカウントを接続してサインアップまたはログインしてください。従来のTMSまたはStringsのソーシャルアカウントを使用してPhraseプラットフォームにログインすることも可能です。

ログイン済みのユーザーは、ユーザープロファイル設定で、Phraseプロファイルを利用可能なソーシャルプロバイダーのいずれかと連携させたり、連携を解除したりできます。

ソーシャルサインアップまたはログインは、Phrase組織に参加するよう招待されたユーザーには利用できません:

  • 新規ユーザーは、Phraseプラットフォームのサインアップページで、ユーザー名とパスワードを入力するか、SSOを使用してサインアップできます。

    ログイン後、プラットフォームのユーザープロファイル設定に移動し、希望するソーシャルプロバイダー経由のソーシャルログインを有効にしてください。

  • 別のPhrase組織への参加に招待された既存のユーザーは、招待を承諾するためにパスワードを再設定する必要があります。

    パスワードを再設定したら、連携済みのソーシャルアカウントを使用してログインしてください。

プラットフォームSSO

シングルサインオン(SSO)を使用すると、プラットフォームユーザーはサードパーティアプリケーション経由でログインできます。Phraseプラットフォームは、SCIM 2.0およびSAML 2.0プロトコル(Microsoft Entra ID、Okta、Google Workspaceなど)に準拠したIDプロバイダー(IdP)との統合を可能にします。

ユーザーは、組織のIdPシステムにログインしている限りアクセスできます。

デフォルトでは、ユーザーはSSOと既存のユーザー名およびパスワードの認証情報の両方を使用してPhraseプラットフォームにログインできます。必要に応じて、SSOの使用を強制し、ユーザー名とパスワードを使用したログイン機能を制限することができます。

uniqueIDパラメータ

SSOログインページは、ユーザーの固有グローバル識別子を事前入力するuniqueIdURLパラメータをサポートしています。このパラメータに文字列を指定すると、ユーザーの固有識別子フィールドにその文字列が事前入力されます。

例:

https://eu.phrase.com/idm-ui/signin/sso?uniqueId=YOUR_ID

お客様は、このパラメータを含むURLをブラウザにブックマークすることで、SSOログインを開始する際にこのID値を記憶しておく必要がなくなります。

SAML 2.0を使用したSSOの有効化

SSOの設定は、選択したIdPへの管理者アクセス権を持つIT管理者が行う必要があります。PhraseでSSO設定を構成できるのは、プラットフォームオーナーのみです。

SAMLログイン時、SAMLログインリクエストにそれぞれの属性が含まれている場合、Phrase組織のユーザープロファイル内のユーザーのfirst_nameおよびlast_nameは、常にお客様のIdPに存在する値と一致するように更新されます。これを回避するには、SAMLログインリクエストからこれらの属性を削除することをお勧めします。

SSOを設定するには、以下の手順に従ってください。

  1. プラットフォームダッシュボードの左側ナビゲーションメニューから組織設定を選択します。

    組織設定ページが開き、SSOタブが表示されます。

  2. SSOタブを選択し、SSOを有効にするをクリックします。

    SSO設定ページが表示されます。

  3. SSOを承認セクションの項目を入力します:

    • グローバルに一意の識別子フィールドに一意の識別子(組織名やランダムな文字列など)を入力します。

      組織のユーザーは、Phraseプラットフォームにログインする際、この一意の識別子を使用する必要があります。

    • 識別子の種類ドロップダウンから必要なオプションを選択します:

      ユーザー名:

      プラットフォームユーザーは、ユーザー名によってIdPのユーザー識別情報と照合されます。NameIDの形式属性を使用してユーザーを照合します:

      urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified

      メールアドレス:

      プラットフォームユーザーは、メールアドレスによってIdPのユーザー識別情報と照合されます。NameIDの形式属性を使用してユーザーを照合します:

      urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

  4. IdPから提供された情報を使用してPhraseでSAMLを設定セクションの必須フィールドに入力し、保存をクリックします。

    IDプロバイダーにPhraseを追加セクションのフィールドは自動的に入力されます。

  5. IDプロバイダーにPhraseを追加セクションに記載されているリンクをコピーし、IdPのSAML設定に入力します。

備考

プラットフォームSSOを正常に設定するには、SAMLレスポンスへの署名が必要です。

詳細については、各IdP固有のドキュメント(Microsoft Azure ADのCertificate signing optionsなど)を参照してください。

備考

Phraseでは、SAMLクレームで属性名firstname、lastname、usernameを使用する必要があります。一部のIDプロバイダーでは、これらの値が異なるデフォルトのクレーム名で送信されます。例えば、IDプロバイダーはデフォルトで、ユーザーの名と姓をそれぞれクレーム名givennameおよびsurnameで送信しますが、usernameクレームは送信しません。これらは、Phraseが想定する属性名に自動的にマッピングされません。クレームマッピングが更新されない場合、招待を承諾したユーザーは「missing required attributes」エラーを受け取り、ログインできなくなります。

これを防ぐには、IdPでPhraseアプリケーションのSAMLクレームマッピングを次のように設定してください。

  • ユーザーの名が含まれる送信クレームをfirstnameに再マッピングします。

  • ユーザーの姓が含まれる送信クレームをlastnameに再マッピングします。

  • usernameクレームを追加します(例:ユーザープリンシパル名にマッピング)。

Phraseは、SAML属性の名前がfirstname、lastname、およびusernameであることを想定しています。一部のIDプロバイダーは、自動的にマッピングされない異なるデフォルト名(例:givennameやsurname)を使用するため、それらを送信する場合はIDプロバイダーでクレームマッピングを更新してください。

メールアドレスは常にSAML NameIDから取得されます。既存のユーザーはこの値で照合され、ログイン時に他の属性はチェックされません。招待を承諾する既存のユーザーには、属性は必要ありません。その他の属性は、以下の場合にのみ必要となります。

  • 招待を承諾する新規ユーザー:firstnameおよびlastname。usernameが送信されない場合、Phraseはメールアドレスからユーザー名を生成します。

  • JITプロビジョニング:firstname、lastname、およびusername。

  • SCIMユーザー作成:username。

必須属性が不足している場合、ユーザーには「missing required attributes」エラーが表示されます。SAMLログイン時、姓名の両方が送信された場合にのみ、ユーザープロファイルの姓名が更新されます。既存のプロファイルの上書きを避けるには、SAMLリクエストから両方の属性を削除してください。

SSOを強制する

ユーザーにSSOでのサインインを必須にするを選択すると、ユーザーはSSOを使用してサインインする必要があります。

SSOでのサインインを必須にすると、以前にSSO経由でログインしていないユーザーは組織にアクセスできなくなります。

外部のコラボレーターがSSO以外でのアクセスを必要とする場合は、指定したドメインでSSOログインを必須にするオプションを選択してください。

オプション:

  • すべてのログイン方法を許可

  • すべてのユーザーにSSOログインを要求

  • 指定のドメインにSSOログインを要求

    識別子と識別子の種類を入力し、保存をクリックします。

SSOでのサインインが必須のすべてのユーザーは、プラットフォームダッシュボードのユーザーページに表示されます。

ユーザーの自動プロビジョニング

ユーザーの自動プロビジョニングは、Phrase内の会社管理ユーザーのみを対象とし、自己登録ユーザーは対象外です。

Phraseプラットフォームは、SAML/SSO機能を使用してプラットフォームアプリケーションへのアクセスを自動化する、2種類のユーザープロビジョニングをサポートしています。

  • Just-in-Time (JIT)

  • SCIM

選択したIDプロバイダー(IdP)でPhraseへのアクセスがプロビジョニングされると、Platform組織内に新しいユーザーが自動的に作成されます。

すべての新規ユーザーは、関連するPlatform組織のメンバーとして作成され、デフォルトではどの製品にもアクセスできません。Platform組織の所有者または管理者が、別途必要な製品に招待する必要があります。

必要に応じて、Platform組織設定で自動プロビジョニングを設定する際に、デフォルトの製品およびロールの割り当てを変更できます。

作成されたユーザーは、組織への紐付けを確認する必要があります。組織への紐付けを確認するため、プロビジョニングされたユーザーに確認用リンクを記載したメールが送信されます。確認が完了するまで、ユーザーはSSOを使用してログインすることはできません。

備考

紐付けの確認をスキップするには、担当のカスタマーサクセスマネージャーにお問い合わせください。

プロビジョニングされたユーザーは、Phraseの認証情報がIdPで管理されているため、変更できません。

ユーザーがIdPを通じてプロビジョニング解除され、その結果Phrase内で所属する最後の組織から削除されると、アカウントの削除までの30日間の自動保持期間が始まります。この猶予期間中、ユーザーのアイデンティティはすぐには削除されないため、誤って削除された場合に復元できます。

自動プロビジョニングの設定

自動プロビジョニングを有効または無効にするには、適切な構成を確保し、重複アカウントや未割り当てユーザーなどの潜在的な問題を回避するために、Phraseテクニカルサポートとの連携が必要です。

円滑なセットアップと継続的なユーザー管理のために、以下のベストプラクティスが推奨されます。

  1. 小規模なテストから始めてください。

    組織全体に自動プロビジョニングを展開する前に、少人数のユーザーグループをプロビジョニングして、すべてが正しく機能していることを確認することをお勧めします。

  2. すべてのユーザーをIDプロバイダー(IdP)経由で割り当てます。

    テストが成功したら、IdPを通じてすべてのユーザーをPhraseアプリケーションに割り当てます。その後、SCIMによって組織全体のプロビジョニングとユーザー情報の更新が自動化されます。

  3. 既存のユーザーを会社管理ユーザーに変換します。

    現在のユーザーを会社管理ユーザーに変換するには、Phraseテクニカルサポートにお問い合わせください。SCIMでは会社管理ユーザーとしてマークされたユーザーしか更新・削除できないため、このステップは不可欠です。

    変換する前に、Phraseに登録されている各ユーザーのメールアドレス、ユーザー名、名、姓が、IDプロバイダーに登録されている対応する値と完全に一致していることを確認してください。属性が一致しないと、SCIMがユーザーのアイデンティティを正しく紐付けたり更新したりできなくなります。

  4. SCIM導入前に追加されたユーザーをIdP経由で組織に割り当てます。

    SCIM自動プロビジョニングを有効にする前に追加されたユーザーは、IdPを通じて組織に割り当てる必要があります。これらのユーザーを割り当てないと、SCIM同期中に削除される可能性があります。

Just-in-Time (JIT) プロビジョニング

Just-in-Time (JIT) プロビジョニングは、SAML SSOを通じてアプリケーションに初めてログインする際にユーザーを作成するために使用される、SAMLプロトコルに基づく方式です。これにより、ユーザーのプロビジョニングやユーザーアカウントの手動作成が不要になり、作成されたすべてのユーザーは、その組織の製品に自動的にアクセスできるようになります。

JITプロビジョニングの設定は、選択したIdPへの管理者アクセス権を持つIT管理者が行う必要があります。

SAML SSOを介したJITプロビジョニングを設定するには、以下の手順に従ってください。

  1. プラットフォームダッシュボードの左側のナビゲーションメニューから組織設定を選択します。

    組織設定ページが開き、SSOタブが表示されます。

  2. SSOタブを選択します。

    SSO設定ページが表示されます。

  3. 自動プロビジョニング設定までスクロールし、サポートに連絡を選択して設定を有効にします。

    備考

    SAML自動プロビジョニングとSCIMを同時に有効にすることはできません。

  4. 設定が有効になったら、自動プロビジョニングドロップダウンからSAML自動プロビジョニング(Just in time)を選択します。

  5. ロール管理のタイプを選択します。

    • デフォルトでは、プロビジョニング時に、デフォルトのロールを使用してすべてのPhrase製品へのアクセス権を付与します。

    • カスタムでは、プロビジョニング時にすべての新規ユーザーに適用される、特定のPhrase製品のロールを選択できます。

      ユーザーロールが空の場合、ユーザーはその製品にプロビジョニングされません。

  6. 属性ステートメントテーブルの属性を使用して、IdPの属性をPhraseのデータにマッピングします。

    これは、2つのシステム間でユーザーデータを確実に一致させるために必要です。

  7. 保存をクリックします。

    設定が保存されます。

SCIMプロビジョニング

SCIMプロトコルは、ドメイン間でのIDデータの安全な管理と交換を可能にするアプリケーションレベルの標準です。

サポートされているSCIM機能:

  • 会社管理ユーザーの作成

    • ユーザーは、プラットフォーム組織でアクティブなすべてのアプリケーションにプロビジョニングされます。

    • ユーザーには、Phrase TMSのLinguistロールとPhrase StringsのTranslatorロールが割り当てられます。

      必要に応じて、プラットフォーム組織の設定で自動プロビジョニングを設定する際に、デフォルトの製品およびロールの割り当てを変更できます。

    • SCIMで作成されたユーザーIDを既存のIDと統合することはできません。新規のIDのみがサポートされています。

    • SCIMでプロビジョニングされたIDは、2番目の組織が同じ顧客に属していない限り、同じメールアドレスで別の組織に参加することはできません。その場合は、Phraseサポートに連絡して組織グループの設定を依頼してください。設定が完了すると、SCIMでそのグループ内の任意の組織にユーザーIDをプロビジョニングできるようになります。2番目の組織が別の顧客に属している場合は、別のメールアドレスまたは元のメールアドレスのエイリアスに招待を送信し、新しい組織用に別のプロファイルを作成してください。

  • 会社管理ユーザーの属性を編集

    IdPでの属性の編集は、Phraseプラットフォームに反映されます。

  • 会社管理ユーザーの削除

    • IdPからユーザー削除リクエストが送信されると、そのユーザーのメンバーシップはPhrase組織から削除されます。削除対象の組織がそのユーザーの最後の所属先である場合、アカウントは30日間の保持期間を経て完全に削除されます。

    • SCIM管理ユーザーが複数の組織のメンバーである場合、1つの組織からの削除リクエストはその組織からのメンバーシップのみを削除します。メンバーである最後の組織から削除リクエストを受け取った後にのみ、30日間の削除カウントダウンが開始されます。

SCIMプロビジョニングの設定

備考

継続的な改善が行われているため、ユーザーインターフェイスは動画で紹介されているものと完全に同じではない可能性があります。

SCIMの設定は、選択したIdPへの管理者アクセス権を持つIT管理者が行う必要があります。

SCIMプロパティを設定するには、以下の手順に従ってください。

  1. プラットフォームダッシュボードの左側ナビゲーションメニューから組織設定を選択します。

    組織設定ページが開き、SSOタブが表示されます。

  2. SSOタブを選択します。

    SSO設定ページが表示されます。

  3. 自動プロビジョニング設定までスクロールし、サポートに連絡を選択して設定を有効にします。

    備考

    SAML自動プロビジョニングとSCIMを同時に有効にすることはできません。

  4. 設定を有効にしたら、自動プロビジョニングドロップダウンからSCIMを選択します。

    SCIM設定の詳細が表示されます。

  5. 以下に記載されている通りに認証を設定してください。

  6. SCIM v2 base URLと生成された認証情報をコピーします。これらはIdP設定で使用されます。

  7. ロール管理のタイプを選択します。

    • デフォルトは、プロビジョニング時にすべてのPhrase製品へのアクセス権をデフォルトのロールで割り当てます。

    • カスタムでは、プロビジョニング時にすべての新規ユーザーに適用される、特定のPhrase製品のロールを選択できます。

    • SCIMを使用すると、プロビジョニング時にIdPで設定された情報に基づいて、ユーザーごとの製品アクセスとロールの設定が可能になります。

  8. 削除ポリシーのタイプを選択します。

    • ユーザーの無効化

    • 完全削除

  9. 保存をクリックします。

    設定が保存されます。

SCIM認証

Phraseは、アイデンティティプロバイダー(IdP)からのSCIMリクエストに対して3つの認証オプションをサポートしています。組織設定 > SSO > 自動プロビジョニング設定 > SCIM認証で1つ選択します。

SCIM_authentication_options.png

オプション

使用する場合

OAuth2(推奨)

IdPがOAuth 2.0のクライアント資格情報グラントをサポートしている場合(例:Okta OAuth 2やMicrosoft Entra ID OAuth2 Client Credentials Grant)。OAuth2は短期間有効なアクセストークンを使用し、シークレットがSCIMリクエストと共に送信されることはありません。

Bearer v2

IdPは静的ベアラートークン(HTTP HeaderまたはSecret Token)のみをサポートしています。

Legacy

既存の設定でのみ利用可能です。OAuth2またはBearer v2へ移行してください。

注意

Bearer v2またはOAuth2の認証情報を生成すると、レガシーSCIMエンドポイントはその組織に対するリクエストを受け付けなくなります。IdPの設定を直ちに更新してください。レガシーへの切り替えはできません。

OAuth2のセットアップ

OAuth2をセットアップするには、以下の手順に従ってください。

  1. SSOが有効であり、SCIMプロビジョニングがオンになっていることを確認してください(SCIMを有効にするにはPhraseサポートにお問い合わせください)。

  2. SCIM認証で、OAuth2を選択し、認証情報を生成をクリックします。

  3. クライアントIDとクライアントシークレットをコピーします。

    クライアントシークレットは一度しか表示されません。安全に保管してください。

  4. SCIM v2ベースURL(例:https://eu.phrase.com/idm/scim/v2/<id>)をコピーします。

  5. IdPで、以下の値を使用してSCIMアプリケーションを設定します。

    • SCIMコネクタベースURL:ステップ3のSCIM v2ベースURL

    • 認証モード:OAuth 2.0クライアント認証情報

    • トークンエンドポイントURL:EUデータセンターの場合はhttps://eu.phrase.com/idm/oauth/token、USデータセンターの場合はhttps://us.phrase.com/idm/oauth/token

    • クライアントIDおよびクライアントシークレット:ステップ2の値。リクエストボディで送信されます(client_secret_post)

    • スコープ:空白のままにします

  6. Phraseで保存をクリックし、IdPで接続をテストします。

アクセストークンの有効期間は4時間です。現在のトークンの有効期限が切れると、IdPはクライアントIDとクライアントシークレットを使用して新しいトークンを要求します。

備考

Phraseはリフレッシュトークンを発行しません。

Bearer v2のセットアップ

Bearer v2をセットアップするには、以下の手順に従ってください。

  1. SSOが有効であり、SCIMプロビジョニングがオンになっていることを確認してください(SCIMを有効にするにはPhraseサポートにお問い合わせください)。

  2. SCIM認証で、Bearer v2を選択し、認証情報を生成をクリックします。

  3. 生成されたトークンとSCIM v2ベースURLをコピーします。

    トークンは一度しか表示されません。安全に保管してください。

  4. IdPで、SCIM v2ベースURLを入力し、認証方法としてHTTP HeaderまたはBearer tokenを選択し、コピーしたトークンを入力します。

  5. 保存をクリックします。

認証情報のローテーションまたは変更
  • 認証情報を生成を再度クリックすると、新しい認証情報が作成され、以前の認証情報は直ちに無効になります。重複期間はありません。プロビジョニングの失敗を避けるため、再生成の直後にIdPを更新してください。

  • Bearer v2とOAuth2を切り替えると、以前の認証方法の認証情報とアクティブなアクセストークンが無効になります。

  • SCIMを無効にしても認証情報は保持されますが、SCIMが再度有効になるまでPhraseはすべてのSCIMリクエストを拒否します。

トラブルシューティング
  • SCIMリクエストで401 “Not valid authorization token.”が発生する場合。

    考えられる原因:

    • 認証情報が正しくないか、再生成されています。

    • アクセストークンの有効期限が切れています。

    • ベースURLが別の組織のものです。

    • SCIMまたはSSOが無効になっています。

  • トークンエンドポイントからの400 invalid_client:クライアントIDまたはクライアントシークレットが正しくないか、認証情報が再生成されました。

備考

一般的なSCIMプロビジョニングエラーは、いくつかのカテゴリに分類されます。

SCIMではなく手動またはユーザー同期によって作成されたユーザーアカウントを、後からSCIMで引き継ぐことはできません。IDプロバイダーの更新リクエストは、「Identity is not managed by organization(IDが組織によって管理されていません)」といったエラーで拒否されます。このような既存のアカウントをSCIM管理下に置くには、サポートされている移行手順が必要です。アカウントは、後のSCIM更新だけで引き継ぐことはできません。

SCIMでプロビジョニングされたIDは、組織が同じ顧客に属し、組織グループとして設定されている場合を除き、特定のメールアドレスに対して1つの組織にのみプッシュできます。同じ人物が同じメールアドレスで2つの異なる組織に無関係なアカウントを持っている場合、一方または両方の組織からのSCIMプッシュリクエストは失敗します。異なる顧客に属する組織の場合、各人は組織ごとに個別のメールアドレスまたはエイリアスを使用して、組織ごとに別々のアカウントを持つ必要があります。同じグループ内の組織の場合は、Phraseサポートに連絡して組織グループとして構成してもらい、単一のIDをそれらすべてにプロビジョニングできるようにしてください。

SCIMは、組織内のユーザーのホーム(内部)アカウントのみを管理します。外部メンバーシップ(アカウントのホーム組織がSCIMプッシュを実行する組織と異なる場合)は、その組織のSCIM設定によって更新または管理することはできません。

SCIMロール管理を設定する

SCIMを使用する場合、ロールの割り当てと製品へのアクセスは、roles属性を使用してIdPプロビジョニングリクエスト内で直接定義できます。

SCIMのUser Createリクエストのroles配列内の各エントリには、以下を含める必要があります。

  • type(対象製品を示す。phrase__で始まる必要がある)

  • value(その製品の正確なロール名を指定する)

SCIMリクエストの例

"roles": [
  { "type": "phrase__platform", "value":"MEMBER" },
  { "type": "phrase__tms", "value":"ADMIN" },
  { "type": "phrase__strings", "value": "none" }
]
  • phrase__platformロールは必須です。

  • 製品へのアクセスを除外するにはnoneを使用します。

  • すべてのロールは、関連するPhrase製品で設定され、で利用可能なロールと一致する必要があります。Phrase Portalロールは設定不可であり、ユーザーのTMSロールから自動的に推論されます。

  • ロール名は大文字と小文字を区別します。大文字での表記を推奨します。

  • 必須フィールドが欠落しているリクエストや、無効なロールが含まれているリクエストは失敗します。

SCIMロールベースのプロビジョニングの設定や設定エラーのトラブルシューティングでサポートが必要な場合は、担当のソリューションアーキテクトにお問い合わせください。

Oktaでの設定例

OktaでSCIMロールプロビジョニングを設定するには、以下の手順に従ってください。

  1. 各Phrase製品のカスタム属性を作成します。

    • phrase__platform

    • phrase__tms

    • phrase__strings

  2. 各属性の有効なロール値を定義します。

  3. これらの属性をOktaのSCIMアプリにマッピングします。

  4. 必要に応じて条件付きロジックを使用し、ユーザープロファイルやグループメンバーシップに基づいてロールを動的にマッピングします。

  5. マッピングはユーザー作成時にのみ適用します。

    備考

    SCIMを介した既存のユーザーロールの更新はサポートされていません。

製品ごとのサポートされているロール値

ロール値は大文字と小文字を区別します。IdPから送信される値は、大文字と小文字の区別を含め、以下と完全に一致する必要があります。phrase__<product>プレフィックス自体は、大文字と小文字を区別しません。

  • プラットフォーム(phrase__platform):MEMBER、ADMIN

  • TMS(phrase__tms):LINGUIST, PROJECT_MANAGER, ADMIN, GUEST, SUBMITTER, PORTAL_MEMBER

  • Strings(phrase__strings):Owner, Admin, ProjectManager, Developer, Designer, Translator, Guest

  • Studio(phrase__studio):OWNER, ADMIN, MEMBER

レガシーSSOからの移行

注意

2025年3月4日をもって、TMSおよびStringsのレガシーSSOログインページは非推奨となります。Phrase製品への継続的なアクセスを確保するため、レガシーSSOを使用しているすべての組織は、プラットフォームSSOに移行する必要があります。

プラットフォームSSOへの移行には、IDプロバイダー(IdP)への管理者アクセス権が必要です。IdPで新しいプラットフォームSSO統合を構成するには、ITチームとの連携が不可欠です。

各Phrase組織は、1つのIdPとのみ統合できます。複数のIdPを使用している場合は、移行前にプラットフォームSSO設定用に1つを選択してください。

移行手順

  1. IdP(Okta、Azure、TrustBuilderなど)でを設定します。

    • ユーザーの混乱を避けるため、プラットフォームSSOのグローバル一意識別子を、レガシーSSOで使用されているものと一致するように設定してください。

  2. レガシーSSO統合の既存のユーザーとグループを、IdP内の新しいプラットフォームSSO統合に招待してください。

  3. ログインフローの変更について通知します:

    • ユーザーはプラットフォームのログインページを使用する必要があります:

    • IdPダッシュボードのアイコンからログインする場合、ユーザーは更新されたプラットフォームSSOアイコンを選択する必要があります。

    • ユーザーの資格情報(メールアドレス/ユーザー名)に変更はありません。

移行が完了しても、Phrase TMSとPhrase Stringsの既存のコンテンツとユーザーロールはすべてそのまま維持されます。

複数のアカウントで同じメールアドレスが使用されている場合のSSOログインの解決

メール識別子が使用されている場合、Phraseは、IDプロバイダーから送信されたメールアドレスを、そのSSO設定が使用されている組織のアクティブなメンバーであるアカウントと照合します。他の組織で同じメールアドレスを持つアカウントは考慮されません。

一致するアカウントがちょうど1つ見つかった場合は、そのアカウントでログインします。一致するアカウントが見つからない場合、組織でジャストインタイム(JIT)プロビジョニングが有効になっていない限り、「identity not found(IDが見つかりません)」というエラーでログインに失敗します。同じ組織内で一致するアカウントが複数見つかった場合、その組織内でメールアドレスが一意ではないため、ログインに失敗します。

異なる組織で同じメールアドレスを持つアカウントは競合しません。

推奨される設定:

  • 組織ごとに1つのアカウント、同じメールアドレス:そのまま機能します。メール識別子を使用してください。IDプロバイダー側で変更を行う必要はありません。

  • 組織ごとに異なるメールアドレス:組織ごとにエイリアスを使用し、対応するアプリケーションに対してそのエイリアスを送信するようにIDプロバイダーを設定してください。Phrase内のメールアドレスは、IDプロバイダーが送信する内容と完全に一致している必要があります。

  • 同一組織内に2つのアカウント(例:管理者アカウントとプロジェクトマネージャーアカウント)がある場合、アカウントごとに個別のIDプロバイダーユーザーを使用するか、アカウントごとに異なるユーザー名を持つユーザー名識別子を使用してください。

すべての組織で単一のアカウントと単一のログインをご希望の場合は、Phraseサポートまでお問い合わせください。異なる組織に所属する同一人物のアカウントは、それらすべてに所属する1つのアカウントに統合できます。SCIMで作成されたIDについては、統合を利用できません。

組織でJITプロビジョニングが有効になっており、SSOログインを試行しているユーザーがまだその組織のメンバーではない場合、SSOは提供されたメールアドレスを使用して新しいアカウントを作成します。意図しないアカウント作成を避けるため、SSOを有効にする前に既存のメンバーを組織に招待してください。

この記事は役に立ちましたか?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.