Tutorial: Configurar o SmartFile para provisionamento automático de usuários

Artigo
03/25/2024

O objetivo deste tutorial é demonstrar as etapas a serem executadas no SmartFile e no Microsoft Entra ID para configurar o Microsoft Entra ID para provisionar e desprovisionar automaticamente usuários e/ou grupos para o SmartFile.

Nota

Este tutorial descreve um conector criado sobre o serviço de provisionamento de usuário do Microsoft Entra. 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.

Pré-requisitos

O cenário descrito neste tutorial pressupõe que você já tenha os seguintes pré-requisitos:

Um locatário do Microsoft Entra.
Um locatário SmartFile.
Uma conta de usuário no SmartFile com permissões de administrador.

Nota

Essa integração também está disponível para uso no ambiente Microsoft Entra US Government Cloud. Pode encontrar esta aplicação na Microsoft Entra US Government Cloud Application Gallery e configurá-la da mesma forma que faz a partir da nuvem pública.

Atribuindo usuários ao SmartFile

O Microsoft Entra ID usa um conceito chamado atribuições para determinar quais usuários devem receber acesso aos aplicativos selecionados. No contexto do provisionamento automático de usuários, somente os usuários e/ou grupos que foram atribuídos a um aplicativo no Microsoft Entra ID são sincronizados.

Antes de configurar e habilitar o provisionamento automático de usuários, você deve decidir quais usuários e/ou grupos no Microsoft Entra ID precisam acessar o SmartFile. Uma vez decidido, você pode atribuir esses usuários e/ou grupos ao SmartFile seguindo as instruções aqui:

Atribuir um usuário ou grupo a um aplicativo corporativo

Dicas importantes para atribuir usuários ao SmartFile

É recomendável que um único usuário do Microsoft Entra seja atribuído ao SmartFile para testar a configuração de provisionamento automático de usuário. Mais usuários e/ou grupos podem ser atribuídos posteriormente.
Ao atribuir um usuário ao SmartFile, você deve selecionar qualquer função válida específica do aplicativo (se disponível) na caixa de diálogo de atribuição. Os usuários com a função Acesso Padrão são excluídos do provisionamento.

Configurar o SmartFile para provisionamento

Antes de configurar o SmartFile para provisionamento automático de usuários com o Microsoft Entra ID, você precisará habilitar o provisionamento SCIM no SmartFile e coletar mais detalhes necessários.

Faça login no console de administração do SmartFile. Navegue até o canto superior direito do SmartFile Admin Console. Selecione Chave do produto.
Para gerar um token de portador, copie a Chave do Produto e a Senha do Produto. Cole-os num bloco de notas com dois pontos entre eles.

Adicionar SmartFile da galeria

Para configurar o SmartFile para provisionamento automático de usuários com o Microsoft Entra ID, você precisa adicionar o SmartFile da galeria de aplicativos do Microsoft Entra à sua lista de aplicativos SaaS gerenciados.

Para adicionar SmartFile da galeria de aplicativos do Microsoft Entra, execute as seguintes etapas:

Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
Navegue até Identity>Applications>Enterprise applications>Novo aplicativo.
Na seção Adicionar da galeria, digite SmartFile, selecione SmartFile na caixa de pesquisa.
Selecione SmartFile no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Configurando o provisionamento automático de usuários para SmartFile

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 SmartFile com base em atribuições de usuário e/ou grupo na ID do Microsoft Entra.

Gorjeta

Você também pode optar por habilitar o logon único baseado em SAML para SmartFile, seguindo as instruções fornecidas no tutorial de logon único do SmartFile. O logon único pode ser configurado independentemente do provisionamento automático do usuário, embora esses dois recursos se complementem

Para configurar o provisionamento automático de usuários para SmartFile 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 SmartFile.
Selecione o separador Aprovisionamento.
Defina o Modo de Aprovisionamento como Automático.
Na seção Credenciais do administrador, insira https://<SmartFile sitename>.smartfile.com/ftp/scim a URL do locatário. Um exemplo seria parecido com https://demo1test.smartfile.com/ftp/scim. Insira o valor do token ao portador (ProductKey:ProductPassword) que você recuperou anteriormente em Secret Token. Clique em Testar Conexão para garantir que o Microsoft Entra ID possa se conectar ao SmartFile. Se a ligação falhar, certifique-se de que a sua conta SmartFile tem permissões de administrador 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 SmartFile.
Analise os atributos de usuário sincronizados do ID do Microsoft Entra para o SmartFile na seção Mapeamento de Atributos. Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no SmartFile para operações de atualização. Selecione o botão Salvar para confirmar as alterações.
Na seção Mapeamentos, selecione Sincronizar grupos do Microsoft Entra com SmartFile.
Analise os atributos de grupo que são sincronizados do Microsoft Entra ID para SmartFile na seção Mapeamento de Atributos. Os atributos selecionados como propriedades correspondentes são usados para corresponder aos grupos no SmartFile para operações de atualização. Selecione o botão Salvar para confirmar as alterações.
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 SmartFile, 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 SmartFile escolhendo os valores desejados em Escopo na seção Configurações.
Quando estiver pronto para provisionar, clique em Salvar.

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. Você pode usar a seção Detalhes da Sincronização para monitorar o progresso e seguir os links para o relatório de atividade de provisionamento, que descreve todas as ações executadas pelo serviço de provisionamento do Microsoft Entra no SmartFile.

Para obter mais informações sobre como ler os logs de provisionamento do Microsoft Entra, consulte Relatórios sobre provisionamento automático de conta de usuário