Okta SCIMプロファイル更新失敗のトラブルシューティング

必要なすべてのユーザー属性が正しく送信されていること、再アクティベーションリクエストがサポートされていることを確認することで、Okta SCIMを通じてユーザーが正常にプロビジョニングおよび更新できるようにしてください。

エラーメッセージ

管理者がエラーに遭遇した場合:

「このアプリにプロファイルの更新をプッシュ中にエラーが発生しました」

ユーザープロビジョニング時には、これはWorkvivoプラットフォームの障害ではなく 、Okta SCIMペイロードの問題を示すことが多いです。

ほとんどの場合、このエラーはOktaがWorkvivoに無効または不完全なプロファイル更新を送信しようとした際に発生します。

問題が発生する場所

このエラーは、Oktaがユーザープロファイルの更新をWorkvivoにプッシュしようとした際に発生するSCIMプロビジョニングフロー中に発生します。

リクエストはWorkvivoに届きますが、ペイロードが正常に処理できず、更新が失敗します。

一般的な原因

ほとんどの場合、問題は以下のいずれかによって引き起こされます。

• 必要な属性がSCIMペイロードで null または空として送信されています

• Oktaは以前に非アクティブ化されたユーザーの再アクティベートを試みていますが、リクエストメソッドやパラメータはサポートされていません

• Oktaのユーザー属性マッピングが誤って設定されているか、不完全です

• SCIMリクエストはPOSTやPATCH操作の期待される形式を満たしていません

問題の調査方法

オクタ側

オクタ管理者は以下のことをすべきです:

1. Okta管理コンソールを開きます

2. ナビゲーション:

   • Workvivo> >プロビジョニングのアプリケーション

3. レビュー:

   • ユーザー属性マッピング

   • 必要項目がWorkvivoに渡される

4. 次の点を確認します。

   • 必要な属性は にマッピングされません null

   • 影響を受けたユーザーには属性値が存在します

5. オンデマンドでユーザープロビジョニングを再試してみてください

Workvivo側

Workvivoサポートには以下のようなものが必要となる場合があります:

• データベース内のSCIMログの確認

• どの属性が故障を引き起こしたかを特定する

• リクエストが以下の通りであるか確認してください:

  • null 値を含む、または

  • サポートされていないリクエストタイプで再アクティベーションを試みました

この情報は、Oktaで設定変更が必要かどうかを判断するのに役立ちます。

問題の解決方法

根本原因によっては、以下のいずれかの措置が必要となる場合があります。

• Okta属性マッピングを更新し、すべての必要項目に有効な値を含ませるようにしてください

• 再アクティベーションフローをサポートするためにプロビジョニング設定を変更してください(該当する場合)

• ペイロードを修正した後、プロビジョニングリクエストを再試行します

• 無効なマッピングを削除した後、ユーザーを再プロビジョニングします

修正が完了したら、Oktaからのプロファイル更新を再度試してください。

追加情報

• このエラーはWorkvivoが直接発生させるのではなく、Oktaによって生成されています

• WorkvivoはOktaの属性マッピングを管理しません

• SCIMペイロードは必要なフィールドに対して有効な値を含んでいなければなりません

• 再活性化の挙動はSCIM構成によって異なる場合があります

問題が解決しない場合

属性マッピングを確認し、再試行した後も問題が解決しない場合は、 以下でWorkvivoサポート に連絡してください:

• 影響を受けたユーザーのメールアドレス

• 誤差のおおよそのタイムスタンプ

• SCIMプロビジョニング中に問題が発生する確認

サポートはSCIMログを確認し、次のステップを助言します。