Tutorial: Configurar o Smartsheet para provisionamento automático de usuários
O objetivo deste tutorial é demonstrar as etapas a serem executadas no Smartsheet e no Microsoft Entra ID para configurar o Microsoft Entra ID para provisionar e desprovisionar automaticamente usuários e/ou grupos para o Smartsheet. Para obter detalhes importantes sobre o que esse serviço faz, como funciona e perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.
Capacidades suportadas
- Criar usuários no Smartsheet
- Remover usuários no Smartsheet quando eles não precisarem mais de acesso
- Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o Smartsheet
- Logon único no Smartsheet (recomendado)
Pré-requisitos
O cenário descrito neste tutorial pressupõe que você já tenha os seguintes pré-requisitos:
- Um locatário do Microsoft Entra.
- Uma conta de usuário no Microsoft Entra ID com permissão para configurar o provisionamento (como Administrador de Aplicativos, Administrador de Aplicativos na Nuvem ou Proprietário de Aplicativos).
- Um locatário do Smartsheet.
- Uma conta de usuário em um plano Smartsheet Enterprise ou Enterprise Premier com permissões de administrador do sistema.
- Administradores de sistema e um administrador de TI podem configurar o Ative Directory com o Smartsheet
Etapa 1: Planejar a implantação do provisionamento
- Saiba como funciona o serviço de aprovisionamento.
- Determine quem vai estar no âmbito do aprovisionamento.
- Determine quais dados mapear entre o Microsoft Entra ID e o Smartsheet.
Etapa 2: Configurar o Smartsheet para dar suporte ao provisionamento com o Microsoft Entra ID
Antes de configurar o Smartsheet para provisionamento automático de usuários com o Microsoft Entra ID, você precisará habilitar o provisionamento SCIM no Smartsheet.
Faça login como administrador do sistema no portal do Smartsheet e navegue até o Centro de administração da conta>.
Na página Centro de Administração, clique na opção Menu para expor o painel Menu.
Navegue até Menu > Configurações > Domínios & Provisionamento Automático do Usuário.
Para adicionar um novo domínio, clique em Adicionar domínio e siga as instruções. Depois que o domínio for adicionado, certifique-se de que ele também seja verificado.
Gere o Token Secreto necessário para configurar o provisionamento automático de usuários com o Microsoft Entra ID navegando no portal do Smartsheet e, em seguida, navegando até Aplicativos e integrações de conta>.
Escolha API Access. Clique em Gerar novo token de acesso.
Defina o nome do token de acesso à API. Clique em OK.
Copie o token de acesso à API e salve-o, pois esta será a única vez que você poderá visualizá-lo. Isso é necessário no campo Token secreto no ID do Microsoft Entra.
Etapa 3: Adicionar o Smartsheet da galeria de aplicativos do Microsoft Entra
Adicione o Smartsheet da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento no Smartsheet. Se você configurou anteriormente o Smartsheet para SSO, poderá usar o mesmo aplicativo. No entanto, é recomendável criar uma aplicação separada ao testar a integração inicialmente. Saiba mais sobre como adicionar uma aplicação a partir da galeria aqui.
Etapa 4: Definir quem estará no escopo do provisionamento
O serviço de provisionamento do Microsoft Entra permite definir o escopo de quem será provisionado com base na atribuição ao aplicativo e/ou com base nos atributos do usuário/grupo. Se optar por determinar quem vai ser aprovisionado na sua aplicação com base na atribuição, pode utilizar os seguintes passos para atribuir utilizadores e grupos à aplicação. Se escolher determinar quem vai ser aprovisionado com base apenas em atributos do utilizador ou grupo, pode utilizar um filtro de âmbito conforme descrito aqui.
Comece pequeno. Teste com um pequeno conjunto de utilizadores e grupos antes de implementar para todos. Quando o âmbito do aprovisionamento está definido para os utilizadores e os grupos atribuídos, pode controlar isto ao atribuir um ou dois utilizadores ou grupos à aplicação. Quando o âmbito está definido para todos os utilizadores e grupos, pode especificar um filtro de âmbito baseado em atributos.
Para garantir a paridade nas atribuições de função de usuário entre o Smartsheet e o Microsoft Entra ID, é recomendável utilizar as mesmas atribuições de função preenchidas na lista completa de usuários do Smartsheet. Para recuperar essa lista de usuários do Smartsheet, navegue até Gerenciamento de usuários de administrador > de > conta Mais ações > Baixar lista de usuários (csv).
Para acessar determinados recursos no aplicativo, o Smartsheet exige que o usuário tenha várias funções. Para saber mais sobre tipos de usuário e permissões no Smartsheet, vá para Tipos e permissões de usuário.
Se um usuário tiver várias funções atribuídas no Smartsheet, você DEVE garantir que essas atribuições de função sejam replicadas no ID do Microsoft Entra para evitar um cenário em que os usuários possam perder o acesso aos objetos do Smartsheet permanentemente. Cada função exclusiva no Smartsheet DEVE ser atribuída a um grupo diferente no Microsoft Entra ID. O usuário DEVE então ser adicionado a cada um dos grupos correspondentes às funções desejadas.
Se precisar de funções adicionais, você pode atualizar o manifesto do aplicativo para adicionar novas funções.
Etapa 5: Configurar o provisionamento automático de usuários para o Smartsheet
Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e/ou grupos no Smartsheet com base em atribuições de usuário e/ou grupo na ID do Microsoft Entra.
Para configurar o provisionamento automático de usuários para o Smartsheet no Microsoft Entra ID:
Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
Navegue até Aplicativos de identidade>>Aplicativos corporativos
Na lista de aplicativos, selecione Smartsheet.
Selecione o separador Aprovisionamento.
Defina o Modo de Aprovisionamento como Automático.
Na seção Credenciais de administrador, insira a URL base do SCIM 2.0 e o valor do Token de acesso recuperados
https://scim.smartsheet.com/v2anteriormente do Smartsheet no Token secreto, respectivamente. Clique em Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao Smartsheet. Se a conexão falhar, verifique se sua conta do Smartsheet tem permissões SysAdmin e tente novamente.
No campo Email de notificação, digite o endereço de e-mail de uma pessoa ou grupo que deve receber as notificações de erro de provisionamento e marque a caixa de seleção - Enviar uma notificação por e-mail quando ocorrer uma falha.
Clique em Guardar.
Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra com o Smartsheet.
Analise os atributos de usuário sincronizados do ID do Microsoft Entra para o Smartsheet na seção Mapeamento de Atributos. Os atributos selecionados como Propriedades correspondentes são usados para corresponder às contas de usuário no Smartsheet para operações de atualização. Selecione o botão Salvar para confirmar as alterações.
Atributo Type Suportado para filtragem nome de utilizador String ✓ active Boolean title String name.givenName String name.familyName String phoneNumbers[type eq "work"].value String phoneNumbers[type eq "mobile"].value String phoneNumbers[digite eq "fax"].value String emails[type eq "work"].value String externalId String funções String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager String Para configurar filtros de âmbito, veja as instruções seguintes disponibilizadas no Tutorial de filtro de âmbito.
Para habilitar o serviço de provisionamento do Microsoft Entra para o Smartsheet, altere o Status de provisionamento para Ativado na seção Configurações.
Defina os usuários e/ou grupos que você gostaria de provisionar para o Smartsheet escolhendo os valores desejados em Escopo na seção Configurações.
Quando estiver pronto para aprovisionar, clique em Guardar.
Esta operação inicia a sincronização inicial de todos os usuários e/ou grupos definidos em Escopo na seção Configurações. A sincronização inicial leva mais tempo para ser executada do que as sincronizações subsequentes, que ocorrem aproximadamente a cada 40 minutos, enquanto o serviço de provisionamento do Microsoft Entra estiver em execução.
Etapa 6: Monitorar sua implantação
Depois de configurar o aprovisionamento, utilize os seguintes recursos para monitorizar a sua implementação:
- Utilize os registos de aprovisionamento para determinar quais os utilizadores que foram aprovisionados com ou sem êxito
- Verifique a barra de progresso para ver o estado do ciclo de aprovisionamento e quão próximo está da conclusão
- Se a configuração de aprovisionamento parecer estar num mau estado de funcionamento, a aplicação vai entrar em quarentena. Saiba mais sobre os estados de quarentena aqui.
Limitações do conector
- O Smartsheet não suporta exclusões suaves. Quando o atributo ativo de um usuário é definido como False, o Smartsheet exclui o usuário permanentemente.
Registo de alterações
- 16/06/2020 - Adicionado suporte para os atributos de extensão empresarial "Centro de Custo", "Divisão", "Gerente" e "Departamento" para usuários.
- 02/10/2021 - Adicionado suporte para atributos principais "emails[type eq "work"]" para usuários.
- 02/12/2022 - Adicionada URL de base/locatário SCIM para integração do SmartSheet na seção Credenciais de
https://scim.smartsheet.com/v2administrador.
Recursos adicionais
- Gerir o aprovisionamento de contas de utilizador para Aplicações Empresariais
- O que é acesso ao aplicativo e logon único com o Microsoft Entra ID?