API SCIM

• Provisionar novos usuários no Wrike

• Provisionar e atualizar atributos de usuário compatíveis

• Provisionar e atualizar atributos personalizados de usuário

• Desativar ou excluir usuários no Wrike

• Criar e atualizar grupos de usuários no Wrike

• Adicionar ou remover membros do grupo

• Funciona somente nos planos de assinatura Legacy Enterprise, Pinnacle e Apex.

• A sincronização é unidirecional – do IdP para o Wrike.

• As senhas dos usuários não são armazenadas no Wrike. Se um usuário for criado via SCIM em uma conta sem SAML SSO, ele precisará usar a página de redefinição de senha para criar uma senha.

• A pesquisa é suportada apenas pelo endereço de e-mail.

• O Wrike usa o endereço de e-mail como nome de usuário. Durante o provisionamento ou integração, o Wrike procurará um e-mail válido em userName ou emails para usar como login.

. Usuários

• Listar usuários integrados - GET {{base_url}}/Users - retorna um JSON com informações sobre os usuários existentes da conta que estão integrados via SCIM. Esses são usuários criados por convite e depois vinculados com a chamada POST /Users, além dos usuários provisionados diretamente via SCIM. Se você criou alguns usuários manualmente e ainda não os integrou com a chamada nº 2, eles não aparecerão no JSON.

  • Obter usuário integrado - GET {{base_url}}/Users/ - adicione o ID do usuário para receber um JSON com as informações desse usuário, por exemplo GET {{base_url}}/Users/KUAH4WFR onde KUAH4WFR é o ID de API do usuário.

  • Pesquisar usuários integrados usando filtro eq - GET {{base_url}}/Users?filter=userName eq "jerome.chef@scim.test" - pesquisa o usuário pelo endereço de e-mail completo primário.

• Criação de usuário - POST {{base_url}}/Users + corpo de requisição devidamente formatado (veja abaixo um exemplo de corpo de requisição com explicação) - cria um usuário com os atributos especificados no corpo da requisição.

• Substituição de atributos de usuário - PUT {{base_url}}/Users/{{user_id}} + corpo de requisição devidamente formatado (veja abaixo um exemplo de corpo de requisição com explicação) - reescreve todos os atributos do usuário de acordo com o corpo da requisição. Essa chamada pode ser usada para atualizar o tipo de usuário e desativar/ativar o usuário.

• Patch de atributos de usuário - PATCH {{base_url}}/Users/{{user_id}} + corpo de requisição devidamente formatado (veja abaixo um exemplo de corpo de requisição com explicação) - quase o mesmo, com a diferença de que o corpo da requisição contém apenas os atributos a serem atualizados e seus novos valores.

• Exclusão de usuário - DELETE {{base_url}}/Users/{{user_id}}.

• Os atributos personalizados de usuário podem ser provisionados e atualizados por meio da extensão SCIM do Wrike como parte das chamadas POST /Users, PUT /Users/{{user_id}} e PATCH /Users/{{user_id}}.

• Listar grupos - GET {{base_url}}/Groups - retorna um JSON com informações sobre os grupos de usuários do Wrike provisionados.

• Obter grupo - GET {{base_url}}/Groups/{{group_id}} - retorna um JSON com informações sobre esse grupo.

• Criação de grupo - POST {{base_url}}/Groups + corpo de requisição devidamente formatado - cria um grupo de usuários do Wrike.

• Patch de grupo - PATCH {{base_url}}/Groups/{{group_id}} + corpo de requisição devidamente formatado - atualiza atributos do grupo e alterações de membros.

• Exclusão de grupo - DELETE {{base_url}}/Groups/{{group_id}}.

• Owner: -1

• Admin: -2

• Regular: -3

• External: -4

• Collaborator: -5

• Viewer: -8

• Contributor: -10

  Nota

  Viewer and Contributor tipos de usuário podem ou não estar habilitados na sua conta. Se estiver em dúvida, entre em contato com seu representante de sucesso do cliente para verificar se eles estão habilitados.

• com o método GET /user_types na API do Wrike.

• a partir da resposta dos métodos CREATE, GET ou PATCH para usuários existentes.

• A equipe de suporte do Wrike pode fornecer os UIDs dos tipos de usuário da sua conta mediante solicitação do proprietário ou administrador da conta.

  Importante

  Observe que o atributo name.formatted não pode ser atualizado usando o método PATCH. Seu valor é gerado automaticamente com base nos atributos de usuário name.familyName e name.givenName.

• Criação automática de grupos de usuários do Wrike com base nos grupos definidos no IdP

• Adicionar e remover membros do grupo

• Exclusão do grupo quando ele for removido do IdP

• Atualizações incrementais contínuas

• API do Wrike