すべての記事

SAML SSO Azure AD / Entra ID:ユーザー & グループのプロビジョニング

最終更新日:

Wrikeドキュメントチーム

Wrikeドキュメントチーム

要するに

Wrike は Azure AD / Microsoft Entra ID と SCIM を使用して、ユーザーの自動プロビジョニング、更新、無効化をサポートします。 設定を行うには、Wrike で承認済みドメインを追加し、SCIM URL をコピーして API トークンを作成・保存し、両方を Azure の Provisioning 設定に入力してプロビジョニングを有効にします。 SCIM を介してプロビジョニングされたユーザーは、直ちに課金対象となります。

テーブル 17. 利用可能性 - レガシープラン

Availability: Legacy Enterprise.; Unavailability: Legacy Free, Legacy Professional, Legacy Business.;

テーブル 18. 利用可能性

利用可能: Pinnacle, Apex. 利用可能ではありません: Free, Team, Business

概要

SCIM プロトコルを使用すると、管理者は Azure Active Directory (Azure AD) / Microsoft Entra ID (Entra ID) を使って Wrike のユーザーを自動的にプロビジョニングおよびプロビジョニング解除することができます。

Wrike をクロスドメイン管理標準(SCIM)でセットアップして、ユーザーを自動でプロビジョニング/解除したり、サポートされているユーザー属性を同期したり、ユーザーグループのプロビジョニングや、Azure AD / Entra ID 上の状態に基づくグループメンバーシップの管理を行います。

Wrike は現在、Entra ID との SCIM プロビジョニングで次の機能をサポートしています:

  • 自動プロビジョニング: Entra ID のユーザーが自動的に Wrike にプロビジョニングされます。
  • 同期されるユーザー属性: サポートされるユーザー属性は Entra ID で更新されると Wrike でも自動的に更新されます。
  • カスタムユーザー属性のプロビジョニング: サポートされるカスタムユーザー属性を Entra ID から Wrike のユーザーのカスタムフィールドにマッピングできます。
  • 自動無効化: Entra ID でユーザーが無効化されると Wrike でも自動的に無効化されます。
  • グループのプロビジョニング: Entra ID のグループを Wrike のユーザーグループとしてプロビジョニングでき、メンバーシップの更新も反映されます。

アカウント管理者のユーザー属性を更新するには、API トークンを発行した管理者に、管理者権限の付与/取り消しを行う権利がある必要があります。

このページでは、Wrike と Azure AD / Entra ID SCIM の統合について説明します。 Azure AD / Entra ID 経由で Wrike に SAML SSO を設定する方法については別ページをご覧ください。

SCIM を通じて追加されたメンバーは、プロビジョニングが完了するとすぐに課金対象になります。

Azure AD / Entra ID SCIM で Wrike を設定する

Wrike で 高度なセキュリティ設定を構成 する権限を持ち、Azure AD / Entra ID の管理者であることが、Wrike と Azure AD / Entra ID SCIM を設定する前提条件です。 まず Azure AD / Entra ID で SAML SSO を設定することを推奨します。

ステップ 1: 承認済みドメインを追加する

承認済みドメインのユーザーのみが Wrike に自動プロビジョニングされます。

ステップ 2: SCIM URL を確認して控える

  1. Wrikeの作業スペースを開きます。
  2. ビューの右上隅にあるプロフィール画像をクリックします。
  3. アプリ & 統合を選択します。
  4. アプリ一覧で Azure AD / Entra ID をクリックし、SCIM タブを開きます。
  5. ポップアップの一番下までスクロールし、SCIM URL をコピーします。 この後の手順で使用します。
  6. Azure AD / Entra ID のポップアップを閉じ(Wrike からは離れずに)、ステップ 3 に進みます。

ステップ 3: OAUTH トークンを取得する

  1. Apps & Integrations ページの左側で API をクリックします。
  2. App name フィールドに名前を入力します(例: Azure AD / Entra ID SCIM)。
  3. 新規作成をクリックします。
  4. (オプション) アプリの説明を追加します。
  5. ページの一番下までスクロールし、Create Token をクリックします。
  6. パスワードを入力して Obtain token をクリックします。
  7. トークンをコピーして、どこかに保管してください。 この情報を Azure AD / Entra ID に入力する必要があります。

    重要

    トークンは一度しか表示されないため、次の手順に進む前に必ず保存してください。

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

ステップ 4: Azure AD / Entra ID で設定を完了する

  1. <yourorganization>.Azure AD / Entra ID.com にサインインします。
  2. 左側で Enterprise applications をクリックします。
  3. Wrike を検索して選択します。
  4. 左側のメニューパネルから Provisioning を選択します。
  5. Provisioning Mode メニューで Automatic を選択します。
  6. Admin Credentials セクションまでスクロールします。
  7. Tenant URL の横のフィールドに、ステップ 2 でコピーしたベース URL を貼り付けます。
  8. Secret Token の横のフィールドに、ステップ 3 でコピーしたトークンを貼り付けます。
  9. Test connection ボタンをクリックして、すべての設定が正しいことを確認します。
  10. テストに成功したら、ウィンドウ上部の Save ボタンをクリックします。 成功しない場合は、設定を再確認するか Wrike サポートチーム にお問い合わせください。
  11. Edit provisioning タブに移動し、Edit provisioning ボタンをクリックします。
  12. Settings セクションまでスクロールします。
  13. Scope ドロップダウンメニューで、Wrike と Azure 間で同期したいイベントを選択します: Sync only assigned users and groups または Sync all users and groups

    該当するすべてのユーザーとグループが Wrike のアプリに割り当てられていることを確認します。

    ほとんどのケースでは Sync all users and groups の選択は推奨されません。これを選択すると、エンタープライズアプリまたはそれに割り当てられたグループへの割り当て有無にかかわらず、ディレクトリ内のすべてのユーザーが Wrike と同期されます。

  14. プロビジョニングステータスを On に設定します。
  15. ウィンドウ上部の Save をクリックしてプロビジョニングサービスを開始します。

同期される属性

次の属性が Azure AD / Entra ID から Wrike に同期されます:

  • ユーザー名
  • プライマリメール
  • 役職
  • 主電話番号
  • 組織名
  • 部署
  • Wrike ユーザータイプ

    Wrike ユーザータイプ(RegularExternalCollaboratorContributorViewer) はカスタム属性です。 デフォルトでは、Regular ユーザーが作成されます。

トラブルシューティング

欠落している属性

電話番号、部署、セカンダリメールなどのユーザー属性が Wrike に入力されており Azure AD / Entra ID には存在しない場合でも、ユーザープロビジョニング後もその情報は Wrike に残ります。

ユーザーのプロビジョニング/プロビジョニング解除

ユーザーがプロビジョニングまたはプロビジョニング解除されない場合:

  • Azure AD / Entra ID 管理ポータルの System Log を確認し、SCIM プロビジョニング試行が記録されているかどうかを確認します。

    • プロビジョニングの試行が記録されていない場合は、ユーザーが Azure AD / Entra ID で Wrike のアプリケーションに正しく割り当てられているか確認してください。
    • エラーが記録されている場合は、サポートチームまでエラー詳細を添えてご連絡ください。

Entra ID の新しいカスタムアプリでの Wrike UserType

新しいカスタム Enterprise Application を設定している場合、ユーザーが正しい Wrike ユーザータイプでプロビジョニングされるよう、以下の SCIM 属性をプロビジョニングの属性マッピングに追加してマッピングしてください。

urn:ietf:params:scim:schemas:extension:wrike:2.0:User:wrikeUserType 

カスタム属性のプロビジョニング

ステップ 1: Wrike でユーザーカスタムフィールドを作成する

  1. 移動先: https://www.wrike.com/accounts.htm#account/groups
  2. + をクリックして、新しいユーザーカスタムフィールドを作成します。
  3. フィールドを保存します。

ステップ 2: カスタムフィールド ID を取得する

curl --location --globoff \
'https://www.wrike.com/api/v4/customfields?applicableEntityTypes=[User]' \
--header 'Authorization: Bearer YOUR_TOKEN'

レスポンス例:

{
  "data": [
    {
      "id": "IEAGWMBBJUAK4G7J",
      "title": "Completed Induction",
...
    }
  ]
}

注:

  • id
  • title

タイトルを正規化:

  • スペースを _ に置換する
  • 特殊文字を削除する

ステップ 3: Entra でスキーマ編集を有効にする

ステップ 4: カスタム属性を追加する

  1. 移動先: Enterprise Applications → Wrike → Provisioning
  2. Attribute Mapping をクリックします
  3. Show Advanced Options
  4. Wrike の属性リストを編集
  5. 新しい属性を追加します(属性を正しくフォーマットするにはセクション 1.1「ユーザーカスタム属性マッピング」を参照してください):
urn:ietf:params:scim:schemas:extension:wrike:2.0:User:IEAGWMBBJUAK4G7J_Completed_Induction

タイプ:

  • String(または Wrikeフィールドタイプに合わせる)

保存します。

ステップ 5: 属性をマッピングする

  1. Add New Mapping に進みます
  2. Source attribute → Entra フィールドを選択(例: extensionAttribute1)
  3. Target attribute → 先ほど追加した SCIM 属性を選択
  4. 保存

プロビジョニングにより値が自動的に送信されます。

グループのプロビジョニング

重要

  • Microsoft Entra ID の公式 Wrike ギャラリーアプリは現在、グループのプロビジョニングをサポートしていません。
  • 現時点でグループを Wrike にプロビジョニングするには、Wrike のギャラリーアプリではなくカスタムの Enterprise Application を作成する必要があります。

カスタム Enterprise Application を作成する

  1. Azure ポータルにログインします: https://portal.azure.com
  2. 移動先: Microsoft Entra ID → Enterprise Applications
  3. New Application をクリック
  4. これで Microsoft Entra App Gallery が開きます。
  5. Wrike を検索する代わりに、左上隅の Create your own application をクリックします。
  6. アプリケーションの名前を入力します

    例: Wrike SCIM Provisioning with Group

  7. ギャラリーに見つからないその他のアプリケーションを統合 (ノンギャラリー) を選択
  8. 作成をクリックします。

これにより、SCIM プロビジョニングをサポートし、グループ を含む カスタムエンタープライズアプリケーション が作成されます。

SCIM プロビジョニングを構成する

  1. 新しく作成したアプリケーションを開きます。
  2. 移動先: プロビジョニング
  3. プロビジョニングモードを自動に設定します
  4. 公式ガイドの手順に従って SCIM 接続を構成します: https://help.wrike.com/hc/en-us/articles/360046791773-SAML-SSO-Azure-AD-Entra-ID-User-Provisioning

これで Entra ID と Wrike 間のプロビジョニング接続が確立されます。

アプリケーションにグループを割り当てる

グループのプロビジョニングは、アプリケーションに割り当てられたグループに対してのみ実行されます。

  1. 移動先: Enterprise Application → Users and Groups
  2. クリック: Add assignment
  3. Wrike にプロビジョニングしたいグループを選択します。
  4. 割り当てをクリック
プロビジョニングを開始する
  1. 戻る: Provisioning
  2. 切り替え: Provisioning Status → On
  3. Save をクリック

プロビジョニングサービスがユーザーとグループの同期を開始します。

一般的な動作:

Entra でのアクション Wrike での結果
グループを割り当て Wrike にグループが作成される
ユーザーがグループに追加される メンバーシップが追加される
ユーザーが削除される メンバーシップが削除される
グループが削除される グループが削除または無効化される

プロビジョニングサイクルは通常 20~40 分ごとに実行されます。

トップ