Solução de problemas de falhas na atualização do perfil SCIM do Okta

Garanta que os usuários possam ser provisionados e atualizados com sucesso no Workvivo via Okta SCIM, confirmando se todos os atributos de usuário necessários estão sendo enviados corretamente e se as solicitações de reativação são suportadas.

Mensagem de erro

Se um administrador se deparar com o erro:

“Ocorreu um erro ao enviar uma atualização de perfil para este aplicativo”

Durante o provisionamento de usuários, isso normalmente indica um problema com o payload SCIM do Okta, e não uma interrupção da plataforma Workvivo.

Na maioria dos casos, esse erro ocorre quando o Okta tenta enviar uma atualização de perfil inválida ou incompleta para o Workvivo.

Onde ocorre o problema

Esse erro é gerado durante o fluxo de provisionamento SCIM do Okta, depois que o Okta tenta enviar uma atualização de perfil de usuário para o Workvivo.

A solicitação chega ao Workvivo, mas a carga útil não pode ser processada com sucesso, fazendo com que a atualização falhe.

Causas comuns

Na maioria dos casos, o problema é causado por um dos seguintes fatores:

• Um atributo obrigatório está sendo enviado como null ou vazio na carga útil SCIM.

• O Okta está tentando reativar um usuário previamente desativado, mas o método ou os parâmetros da solicitação não são suportados.

• O mapeamento de atributos de usuário no Okta está configurado incorretamente ou incompleto.

• A solicitação SCIM não atende ao formato esperado para uma operação POST ou PATCH.

Como investigar o problema

Okta Side

O administrador do Okta deve:

1. Abra o Console de Administração do Okta

2. Navegue até:

   • Aplicações > Workvivo > Provisionamento

3. Análise:

   • Mapeamentos de atributos do usuário

   • Campos obrigatórios sendo passados para o Workvivo

4. Confirme que:

   • Nenhum atributo obrigatório foi mapeado para null

   • Os valores dos atributos estão presentes para os usuários afetados.

5. Tentar novamente o provisionamento do usuário sob demanda

Workvivo Side

A equipe de suporte da Workvivo pode precisar:

• Analise os registros SCIM no banco de dados.

• Identifique qual atributo causou a falha.

• Confirme se a solicitação:

  • Continha um valor nulo, ou

  • Tentativa de reativação usando um tipo de solicitação não compatível.

Essas informações ajudam a determinar se é necessária uma alteração de configuração no Okta.

Como resolver o problema

Dependendo da causa raiz, uma das seguintes ações pode ser necessária:

• Atualize os mapeamentos de atributos do Okta para garantir que todos os campos obrigatórios contenham valores válidos.

• Modifique as configurações de provisionamento para suportar fluxos de reativação (se aplicável).

• Tente novamente a solicitação de provisionamento após corrigir a carga útil.

• Reaprovisione o usuário após remover os mapeamentos inválidos.

Após a correção, tente novamente a atualização do perfil no Okta.

Informações adicionais

• Este erro é gerado pelo Okta, não diretamente pelo Workvivo.

• A Workvivo não controla os mapeamentos de atributos do Okta.

• As cargas úteis SCIM devem conter valores válidos para os campos obrigatórios.

• O comportamento de reativação pode variar dependendo da configuração do SCIM.

Ainda com problemas?

Se o problema persistir após revisar os mapeamentos de atributos e tentar o provisionamento novamente, entre em contato com o Suporte da Workvivo através dos seguintes canais:

• O e-mail do usuário afetado

• Data e hora aproximadas do erro

• Confirmação de que o problema ocorre durante o provisionamento SCIM.

A equipe de suporte poderá então analisar os registros do SCIM e orientar sobre os próximos passos.