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

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 no SmartFile.

Observação

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 ele funciona e perguntas frequentes, confira 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á tem os seguintes pré-requisitos:

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

Observação

Essa integração também está disponível para uso no ambiente de Nuvem do Governo dos EUA do Microsoft Entra. Você pode encontrar esse aplicativo na Galeria de Aplicativos de Nuvem do Governo dos EUA do Microsoft Entra e configurá-lo da mesma forma que você faz isso na nuvem pública.

Como atribuir 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.

Para configurar e habilitar o provisionamento automático de usuário, decida quais usuários e/ou grupos no Microsoft Entra ID precisam de acesso ao SmartFile. Depois de decidir isso, você poderá atribuir esses usuários e/ou grupos ao SmartFile seguindo estas instruções:

Atribuir um usuário ou um grupo a um aplicativo empresarial

Dicas importantes para atribuir usuários ao SmartFile

Recomendamos que somente um usuário do Microsoft Entra seja atribuído ao SmartFile para testar a configuração de provisionamento automático de usuários. Outros usuários e/ou grupos podem ser atribuídos mais tarde.
Ao atribuir um usuário ao SmartFile, você precisará selecionar qualquer função válida específica do aplicativo (se disponível) na caixa de diálogo de atribuição. 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 o provisionamento automático de usuários com o Microsoft Entra ID, você precisará habilitar o provisionamento do SCIM no SmartFile e coletar mais detalhes necessários.

Entre no Console de Administração do SmartFile. Vá até o canto superior direito do Console de Administração do SmartFile. Selecione Chave do Produto (Product Key) .
Para gerar um token de portador, copie a Chave do Produto (Product Key) e a Senha do Produto. Cole-as em um bloco de notas com dois-pontos entre eles.

Adicionar o SmartFile por meio da galeria

Para configurar o SmartFile para o provisionamento automático de usuários com o Microsoft Entra ID, é necessário adicionar o SmartFile a partir da galeria de aplicativos do Microsoft Entra à lista de aplicativos SaaS gerenciados.

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

Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
Navegue até Identidade>Aplicativos>Aplicativos empresariais>Novo aplicativo.
Na seção Adicionar por meio da galeria, digite SmartFile e 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.

Como configurar o provisionamento automático de usuário no SmartFile

Esta seção descreve as etapas de configuração do 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 de grupo no Microsoft Entra ID.

Dica

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

Para configurar o provisionamento automático de usuário para o SmartFile no Microsoft Entra ID:

Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
Navegue até Identidade>Aplicativos>Aplicativos empresariais
Na lista de aplicativos, selecione SmartFile.
Selecione a guia Provisionamento.
Defina o Modo de Provisionamento como Automático.
Na seção Credenciais de Administrador, insira https://<SmartFile sitename>.smartfile.com/ftp/scim em URL do Locatário. Um exemplo será semelhante a https://demo1test.smartfile.com/ftp/scim. Insira o valor do Token de portador (ProductKey:ProductPassword) recuperado anteriormente em Token Secreto. Clique em Testar Conectividade para verificar se o Microsoft Entra ID pode se conectar ao SmartFile. Se a conexão falhar, verifique se a sua conta do SmartFile tem permissões de Administrador e tente novamente.
No campo Notificação por Email, insira o endereço de email de uma pessoa ou grupo que deverá receber as notificações de erro de provisionamento e selecione a caixa de seleção - Enviar uma notificação por email quando ocorrer uma falha.
Clique em Save (Salvar).
Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra com o SmartFile.
Revise os atributos de usuário que serão sincronizados do Microsoft Entra ID com o SmartFile na seção Mapeamento de Atributos. Os atributos selecionados como propriedades Correspondentes são usados para fazer a correspondência das contas de usuário no SmartFile em 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 o SmartFile.
Revise os atributos de grupo que serão sincronizados do Microsoft Entra ID com o SmartFile na seção Mapeamento de Atributos. Os atributos selecionados como propriedades Correspondentes são usados para fazer a correspondência dos grupos no SmartFile em operações de atualização. Selecione o botão Salvar para confirmar as alterações.
Para configurar filtros de escopo, consulte as seguintes instruções fornecidas no tutorial do Filtro de Escopo.
Para habilitar o serviço de provisionamento do Microsoft Entra no SmartFile, altere o Status de Provisionamento para Ativado na seção Configurações.
Defina os usuários e/ou os grupos que deseja provisionar no SmartFile escolhendo os valores desejados em Escopo na seção Configurações.
Quando você estiver pronto para provisionar, clique em Salvar.

Essa operação inicia a sincronização inicial de todos os usuários e/ou grupos definidos no Escopo na seção Configurações. Observe que a sincronização inicial levará mais tempo do que as sincronizações subsequentes, que ocorrem aproximadamente a cada 40 minutos, desde que o serviço de provisionamento do Microsoft Entra esteja em execução. Use a seção Detalhes de Sincronização para monitorar o progresso e siga os links para o relatório de atividades 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, confira Relatórios sobre o provisionamento automático de contas de usuário