Configurando o SCIM para o Azure

Neste artigo, você aprenderá a configurar o SCIM com o Azure Active Directory (AD). A configuração do SCIM para o Azure permitirá que você adicione e gerencie usuários e grupos no console do KMSAT usando o Azure.

As instruções nesse artigo se destinam a softwares de terceiros. Caso tenha problemas com o provisionamento de usuários no Azure, recomendamos que você consulte o Azure para obter instruções específicas. Também é possível entrar em contato com nossa equipe de suporte, que ficará feliz em ajudar.  

Acesse:

Configurando o SCIM

Definindo quais usuários e grupos sincronizar usando o Azure

Iniciando a sincronização

Opções avançadas de configuração

• Mapeamentos padrão
• Alterando os mapeamentos padrão
• Adicionando o mapeamento de atributos a campos personalizados de usuários

Perguntas frequentes (FAQs)

Configurando o SCIM

Nesta seção, você aprenderá a configurar seu SCIM usando o Azure. Observe que estas etapas devem ser configuradas depois da definição das suas configurações no console do KMSAT. Para obter mais informações sobre como configurar o SCIM no console do KMSAT, consulte o Guia de configuração do SCIM.

Para configurar o SCIM com o Azure, siga estas etapas:

1. Faça login no portal do Azure e vá para Azure Active Directory.
   
2. Clique em Aplicativos empresariais.
   
3. Clique em + Novo aplicativo.
   
4. Na barra de pesquisa, insira "KnowBe4" para filtrar seus resultados. 
5. Clique no bloco Treinamento de conscientização em segurança da KnowBe4.  
   
6. Em seguida, clique em Criar. Depois de clicar em Criar, você passará para a página Visão geral do aplicativo criado. Caso você não seja direcionado à página Visão geral, abra o aplicativo na lista de Aplicativos empresariais.
7. No menu à esquerda da página, selecione a guia Provisionamento.
8. Clique em Começar.
   
9. Clique no menu suspenso Modo de provisionamento e selecione Automático.
   
10. Em seguida, você precisa inserir as informações da sua página Configurações da conta. Para saber onde é possível encontrar essas informações, consulte o Guia de configuração do SCIM. No campo URL do locatário, insira o URL do locatário e, no campo Token secreto, insira o Token do SCIM. 
    

    Observação: No momento, este recurso não funciona com o provisionamento sob demanda.

11. Depois de inserir suas informações, clique no botão Testar conexão. Ao clicar nesse botão, você se assegura de que as informações inseridas estão corretas. Se a conexão for bem-sucedida, um banner de êxito aparecerá no canto superior direito da sua tela.
    
12. Clique no botão Salvar no topo da tela.

Depois, você precisa definir quais usuários e grupos deseja que o Azure sincronize com o console do KMSAT.

Voltar ao início

Definindo quais usuários e grupos sincronizar usando o Azure

Depois de concluir as etapas na seção Configurando o SCIM acima, você pode decidir quais usuários e grupos deseja sincronizar. Essa configuração é obrigatória para sincronizar os usuários e grupos do seu provedor de identidades (Identity Provider, IdP).

Siga estas etapas para definir quais usuários e grupos deseja sincronizar a partir do Azure:

1. No Azure Active Directory, acesse Aplicativos empresariais.
2. Selecione o aplicativo que você criou para sua conexão do KnowBe4.
3. Clique em Usuários e grupos no menu à esquerda da página.
   
4. Clique em Adicionar usuário/grupo para selecionar os usuários ou grupos que você deseja sincronizar.
5. Clique em Usuários e grupos para pesquisar pelos usuários ou grupos para incluir na sincronização. Para adicionar um usuário ou grupo, clique no nome desse usuário ou grupo. Agora, eles serão exibidos na categoria Itens selecionados.
   

   Observação: Recomendamos que você inclua apenas alguns usuários na primeira configuração. Antes de adicionar todos os usuários e grupos desejados, comece com apenas alguns usuários para verificar se a conexão está funcionando bem.

   
   
6. Depois de adicionar os usuários e grupos que você deseja incluir na categoria Itens selecionados, clique em Selecionar.
7. Clique em Atribuir.

Os usuários e grupos selecionados serão exibidos na tabela.

Voltar ao início

Iniciando a sincronização

Depois de configurar o SCIM e adicionar os usuários e grupos que deseja sincronizar, será necessário começar a sincronização. Depois que a sincronização começa, o sistema verifica automaticamente as alterações nos seus usuários e grupos do Azure Active Directory a cada 40 minutos e inicia a sincronização em caso de mudanças.

Para iniciar a sincronização, siga estas etapas:

1. No Azure Active Directory, acesse Aplicativos empresariais.
2. Selecione o aplicativo que você criou para sua conexão do KnowBe4.
3. No menu à esquerda da página, selecione Provisionamento.
4. Clique em Iniciar provisionamento.
   

A sincronização iniciará imediatamente. Depois da sincronização inicial, o sistema verifica se há mudanças no seu Azure Active Directory a cada 40 minutos e inicia a sincronização, caso haja.

Para ver o status dessas sincronizações, qualquer erro encontrado e informações adicionais sobre suas sincronizações, vá para Usuários > Provisionamento no console do KMSAT.

Voltar ao início

Opções avançadas de configuração

Quando você habilita o SCIM, os campos no seu provedor de identidades são automaticamente conectados aos campos correspondentes no console do KMSAT. Se desejar alterar o mapeamento padrão ou adicionar campos personalizados, você terá a opção de atualizar esses campos no Azure.

Para saber mais sobre as opções de configuração avançadas do Azure, consulte as seguintes subseções:

Mapeamentos padrão

Os mapeamentos de campo padrão são mostrados abaixo:

Voltar ao início

Alterando os mapeamentos padrão

Você pode alterar os mapeamentos padrão para personalizar as informações dos usuários sincronizados entre o Azure e o console do KMSAT.

Para alterar os mapeamentos padrão, siga estas etapas:

1. No Azure Active Directory, acesse Aplicativos empresariais.
2. Selecione o aplicativo que você criou para sua conexão do KnowBe4.
3. No menu à esquerda da página, selecione Provisionamento.
   
4. Na janela Provisionamento, clique em Editar mapeamento de atributo, em Gerenciar provisionamento.
   
5. Clique na seta suspensa de Mapeamentos para expandir a guia Mapeamentos.
6. Clique em Provisionar usuários do Azure Active Directory.
7. Desloque para baixo até a seção Mapeamentos de atributos. Nesta seção, você verá uma lista de todos os atributos que foram mapeados. A coluna Atributo do Azure Active Directory exibe o nome do atributo no Azure. A coluna Atributo da KnowBe4 exibe o nome padrão do SCIM para esse atributo. 
   
8. Selecione o atributo que você deseja editar.

9. No painel lateral Editar atributo, personalize o atributo. Para obter detalhes sobre as opções de personalização, consulte a lista abaixo:

   
   
   1. Tipo de mapeamento: Selecione Direto no menu suspenso.
   2. Atributo de origem: Selecione o campo do Azure que você deseja mapear para esse campo personalizado.
      Observação: Se você estiver usando o SSO para o Azure AD, este atributo deve ser o mesmo que o Atributo de origem SSO. Por padrão, o Atributo de origem SSO é o user.userprincipalname. Para mais informações, consulte a seção Adicionar o aplicativo KnowBe4 ao Azure AD de nosso artigo Como configurar SSO/SAML com o Azure Active Directory (AD)?.
   3. Valor padrão quando nulo: Este campo é opcional. Recomendamos deixá-lo em branco.
   4. Atributo de destino: Selecione o campo personalizado que você deseja mapear para o campo do Azure que você escolheu.
   5. Corresponder objetos usando este atributo: Recomendamos selecionar Não.
   6. Aplicar este mapeamento: Recomendamos selecionar Sempre.
      
      Observação: Se houver um atributo que você não deseja sincronizar, clique no botão Excluir, ao lado do atributo, para desabilitar a sincronização. Essa ação removerá apenas a conexão entre o atributo e o campo correspondente no console do KMSAT. Nenhum dado será excluído do Azure.
10. Depois de fazer as mudanças desejadas, clique em OK.
    

    Observação: Recomendamos alterar apenas o campo Atributo de origem. A alteração de outras configurações no atributo pode interromper a conexão entre o Azure e o console do KMSAT.

Voltar ao início

Adicionando o mapeamento de atributos a campos personalizados de usuários

Você também tem a opção de adicionar seis campos personalizados. Esses campos não estão mapeados por padrão, mas podem ser adicionados ao Azure seguindo estas etapas:

1. No Azure Active Directory, acesse Aplicativos empresariais.
2. Selecione o aplicativo que você criou para sua conexão do KnowBe4.
3. No menu à esquerda da página, selecione Provisionamento.
   
4. Na janela Provisionamento, selecione Editar mapeamentos de atributos, em Gerenciar provisionamento.
   
5. Clique na seta suspensa de Mapeamentos para expandir a guia Mapeamentos.
   
6. Clique em Provisionar usuários do Azure Active Directory.
7. Clique em Adicionar novo mapeamento na parte inferior da tabela.
8. Na janela Editar atributo, selecione o Atributo de origem que você deseja usar.
9. Depois, selecione o Atributo de destino. Oferecemos os seguintes campos personalizados:

   Campo do KMSAT	Atributo de destino
   Campo personalizado 1	urn:ietf:params:scim:schemas:extension:knowbe4:kmsat:2.0:User:customField1
   Campo personalizado 2	urn:ietf:params:scim:schemas:extension:knowbe4:kmsat:2.0:User:customField2
   Campo personalizado 3	urn:ietf:params:scim:schemas:extension:knowbe4:kmsat:2.0:User:customField3
   Campo personalizado 4	urn:ietf:params:scim:schemas:extension:knowbe4:kmsat:2.0:User:customField4
   Data personalizada 1	urn:ietf:params:scim:schemas:extension:knowbe4:kmsat:2.0:User:customDate1
   Data personalizada 2	urn:ietf:params:scim:schemas:extension:knowbe4:kmsat:2.0:User:customDate2
   Divisão	urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division
   Organização	urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization

10. Recomendamos deixar o restante das configurações como padrão.
11. Repita a etapa 9 para todos os campos personalizados que você adicionou na etapa 8.
12. Para salvar suas alterações, clique em Salvar no topo da tela.

Agora, esses campos personalizados serão sincronizados com o console do KMSAT.

Voltar ao início

Perguntas frequentes (FAQs)

Abaixo, você verá uma lista de perguntas frequentes sobre como usar o SCIM com o Azure Active Directory.

Pergunta: Com que frequência as sincronizações ocorrem?

Resposta: O sistema verifica as atualizações dos usuários e grupos no Azure Active Directory a cada 40 minutos. Se ele encontra alterações, uma sincronização é iniciada automaticamente. No entanto, você pode forçar uma sincronização a qualquer momento, clicando no botão Forçar sincronização agora na seção Configurações do SCIM nas Configurações da conta do KMSAT.

Pergunta: Como posso restaurar os mapeamentos padrão?

Resposta: Você pode restaurar o mapeamento padrão a qualquer momento, seguindo estas etapas:

1. Vá para Aplicativos empresariais.
2. Selecione o aplicativo que você criou para sua conexão do KnowBe4.
3. No menu à esquerda da página, selecione Provisionamento.
4. Clique em Editar mapeamento de atributo, em Gerenciar provisionamento.
5. Clique na seta suspensa de Mapeamentos para expandir o menu suspenso Mapeamentos.
6. Selecione Restaurar mapeamentos padrão.
7. Clique em Salvar no topo da tela.

Pergunta: Como posso sincronizar todos os meus usuários e grupos?

Resposta: Se você deseja sincronizar todos os usuários e grupos do seu Azure Active Directory, siga estas etapas:

1. Vá para o aplicativo configurado para sua conexão do SCIM.
2. Navegue até Provisionamento.
3. Selecione Editar provisionamento no topo da tela ou, em Gerenciar provisionamento, selecione Adicionar filtros com escopo.
4. Clique no menu suspenso Configurações.
5. No menu suspenso Escopo, selecione Sincronizar todos os usuários e grupos.
6. Clique em Salvar no topo da página.

Pergunta: Eu não consigo atribuir usuários a um aplicativo por grupo. Como posso limitar a sincronização dos usuários para o console do KMSAT?

Resposta: Para limitar a sincronização dos usuários para o console do KMSAT, você pode configurar um filtro de escopo. Para obter mais informações sobre como criar um filtro de escopo, consulte o artigo da Microsoft Provisionamento de aplicativo com base em atributo com filtros de escopo.

Voltar ao início