SAML SSO Okta:ユーザー & グループのプロビジョニング
要するに
SCIM プロビジョニングを設定して、Okta から Wrike のユーザーとグループを自動的に作成、更新、無効化します。 承認済みドメインを追加し、Wrike SCIM URL と OAuth トークンを取得し、Okta で API 統合を有効にした後、属性マッピング、カスタムフィールド、および Group Push を設定します。 注: 「Import Groups」を有効にしないでください。SCIM でプロビジョニングされたメンバーは直ちに課金対象になります。
| Availability: Legacy Enterprise.; Unavailability: Legacy Free, Legacy Professional, Legacy Business.; |
SCIM プロトコルを使用すると、管理者は Okta を介して Wrike のユーザーおよびグループの自動プロビジョニングとデプロビジョニングを設定できます。
System for Cross-domain Identity Management (SCIM) 標準で Wrike を設定すると、Okta のステータスに基づいてユーザーの自動プロビジョニング/デプロビジョニング、対応するユーザー属性の同期、ユーザーグループのプロビジョニング、グループメンバーシップの変更管理を行えます。
Wrike は現在、Okta との SCIM プロビジョニングで次の機能をサポートしています:
- 自動プロビジョニング: Oktaユーザーは自動的にWrikeにプロビジョニングされます。
- 同期されるユーザー属性: サポートされているユーザー属性は Okta で更新されると Wrike でも自動的に更新されます。
- カスタムユーザー属性のプロビジョニング: サポートされているカスタムユーザー属性を Okta から Wrike のユーザーカスタムフィールドにマッピングできます。
- 自動無効化: Okta で無効化されると Wrike のユーザーも自動的に無効化されます。
- グループのプロビジョニング: Okta のグループを Wrike のユーザーグループとしてプロビジョニングでき、メンバーシップの更新も含まれます。
注
アカウント管理者のユーザー属性を正しく更新するには、API トークンを発行したアカウント管理者が、管理者権限を付与/取り消す権利を有効にしている必要があります。
Wrike は次の Okta プロビジョニング機能をサポートしていません:
- グループのインポート
注
Okta で Wrike アプリケーションを設定する際は、Import Groups のチェックボックスを有効にしないでください。
このページでは、Wrike を Okta SCIM と統合する方法について説明します。 Okta 経由で Wrike に SAML SSO を設定する方法については、こちらのページをご覧ください。
注
SCIM で追加されたメンバーは、プロビジョニングされるとすぐに課金対象になります。
Okta SCIM で Wrike をセットアップするには、Wrike で 高度なセキュリティ設定を構成 する権限があり、かつ Okta 管理者である必要があります。 最初に Okta で SAML SSO を設定することをお勧めします。
- Wrikeの作業スペースを開きます。
- ビューの右上隅にあるプロフィール画像をクリックします。
- アプリ & 統合を選択します。
- アプリの一覧から Okta を探し(Identity management and single sign-on via Okta を選択し、Okta via Wrike Integrate を選択しないように注意)、アプリをクリックして SCIM タブに切り替えます。
- 最下部までスクロールし、SCIM URL をコピーします。 このURLは後の手順で使用します。
- Okta のポップアップを閉じ(Wrike にはとどまったまま)、ステップ3に進みます。
- Apps & Integrations ページの左側から API をクリックします。
- App name フィールドに名前を入力します(Okta SCIM を推奨)。
- 新規作成 をクリックします。
- (オプション)アプリの説明を追加します。
- ページの最下部までスクロールし、Create Token をクリックします。
- パスワードを入力し、Obtain token をクリックします。
-
トークンをコピーして、どこかに保存しておきます。 この情報を Okta に入力する必要があります。
重要
トークンは一度しか表示されないため、次の手順に進む前に必ず保存してください。
- 保存 をクリックします。
- <yourorganization>.okta.com で Okta ドメインにサインインします。
- Admin をクリックします。
- Applications をクリックします。
- Wrike を見つけて選択します。
- Provisioning タブに切り替えます。
- 左側のパネルで Integration を選択します。
- Integration ラベルの右側にある Edit をクリックします。
- Enable API integration の横にあるチェックボックスをオンにします。
-
次の情報を追加します:
- Base URL フィールドに、ステップ2で取得した URL を入力します。
- API Token フィールドに、ステップ3で取得したトークンを入力します。
- Test API Credentials をクリックして、アクセスが正しく機能しているか確認します。
- 保存 をクリックします。
- 左側のパネルで To app を選択します。
- Provisioning to app ラベルの右側にある Edit をクリックします。
- 次の同期をすべて、またはいくつか有効にします:Create Users、Update User Attributes、Deactivate Users。
- 保存 をクリックします。
- Assignments タブに切り替えます。
- 特定のユーザーまたはグループ、またはすべてのユーザーに対して Wrike を有効にします。
次の属性が Okta から Wrike に同期されます:
- ユーザー名
- 名
- 姓
-
主メールアドレス
注
この属性が Okta から同期されても、Wrike の 主メールアドレス は変更されません。
- タイトル
- 主電話番号
- 組織
- 部署
- Wrike ユーザータイプ
注
Wrike のユーザータイプ(Regular Users、External Users、Collaborators、Contributors または Viewers)を指定することはカスタム属性です。 デフォルトでは、Regular Users が作成されます。
ユーザーの特定の属性(例:電話番号、部署、またはセカンダリメール)が Wrike で入力されていて Okta には存在しない場合でも、ユーザープロビジョニング後もその情報は Wrike に残ります。
ユーザーがプロビジョニングまたはデプロビジョニングされない場合:
-
Okta 管理ポータルの System Log を確認し、SCIM プロビジョニングが試行された記録があるか確認します。
- 記録がない場合は、Okta でユーザーが Wrike アプリケーションに正しく割り当てられているか確認してください。
- エラーが表示された場合は、サポートチームにお問い合わせいただき、エラーの詳細をお知らせください。
ステップ1: Wrike でユーザーカスタムフィールドを作成する
- アクセス先:https://www.wrike.com/accounts.htm#account/groups
- 新しいユーザーカスタムフィールドを作成するには + をクリックします。
- フィールドを保存します。
ステップ2: カスタムフィールドIDを取得する
Wrike 公開 API を呼び出します:
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
タイトルを正規化:
- スペースを _ に置き換える
- 特殊文字を削除する
- Okta 管理コンソールにログインします。
- 次に移動します:Applications → Applications
- Wrike アプリケーションを選択します。
- Provisioning タブに移動します。
- To App の下で、Go to Profile Editor をクリックします。
- Attributes セクションで、Add Attribute をクリックします。
-
属性を設定します:
- Display name: Completed Induction
- Variable name: IEAGWMBBJUAK4G7J_Completed_Induction
- External name: urn:ietf:params:scim:schemas:extension:wrike:2.0:User:IEAGWMBBJUAK4G7J_Completed_Induction
- Data type: String(または Wrikeフィールドタイプに合わせる)
- 保存をクリックします。
Okta では、カスタム SCIM 属性をマッピングおよびプロビジョニングできるようにする前に、アプリケーションプロファイルに手動で追加する必要があります。 (developer.okta.com)
- 次に移動します:Applications → Wrike → Provisioning
- To App タブを選択します。
- Attribute Mappings → Okta to Wrike までスクロールします。
- 属性の横にある Edit をクリックします。
-
マッピングを設定します:
-
Okta プロファイルからマッピング: このフィールドに入力する Okta 属性を選択します。
- 例: user.employeeType
- Target attribute: urn:ietf:params:scim:schemas:extension:wrike:2.0:User:IEAGWMBBJUAK4G7J_Completed_Induction
-
- Save Mappings をクリックします。
属性マッピングにより、プロビジョニング時にどのユーザープロファイル属性が同期されるかが決まります。 (help.okta.com)
Okta は Group Push を使用してグループをプロビジョニングし、Okta と対象アプリケーション間でグループを作成して同期します。
Group Push を設定する
- 次に移動します:Applications → Wrike
- Push Groups タブを選択します。
- Push Groups をクリックします。
-
次のオプションのいずれかを選択します:
- 名前でグループをプッシュ
- ルールでグループをプッシュ
- プロビジョニングする Okta グループを選択します。
- 保存 をクリックします。
グループ同期の動作
設定後、Okta はグループとメンバーシップを自動的に同期します。
一般的な動作:
| Okta でのアクション | Wrike での結果 |
| グループがプッシュされる | Wrike でグループが作成される |
| ユーザーがグループに追加される | メンバーシップが追加される |
| ユーザーがグループから削除される | メンバーシップが削除される |
| グループのリンク解除 | グループが削除または無効化される |
次のプロビジョニングサイクルでプロビジョニングが自動的に実行されます。