Partilhar via

Integração de logon único (SSO) do Microsoft Entra com o KnowledgeOwl

  • Artigo

Neste artigo, você aprenderá como integrar o KnowledgeOwl com o Microsoft Entra ID. Quando você integra o KnowledgeOwl com o Microsoft Entra ID, você pode:

  • Controle no Microsoft Entra ID quem tem acesso ao KnowledgeOwl.
  • Permita que seus usuários entrem automaticamente no KnowledgeOwl com suas contas do Microsoft Entra.
  • Gerencie suas contas em um local central.

Pré-requisitos

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

  • Assinatura habilitada para logon único (SSO) do KnowledgeOwl.

Descrição do cenário

Neste artigo, você configura e testa o Microsoft Entra SSO em um ambiente de teste.

  • O KnowledgeOwl suporta SP e SSO iniciado por IDP.
  • O KnowledgeOwl suporta Just In Time provisionamento de usuários.

Para configurar a integração do KnowledgeOwl no Microsoft Entra ID, você precisa adicionar o KnowledgeOwl da galeria à sua lista de aplicativos SaaS gerenciados.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Aplicações na Cloud.
  2. Navegue para Identidade>Aplicações>Aplicações empresariais>Nova aplicação.
  3. Na seção Adicionar da galeria, digite KnowledgeOwl na caixa de pesquisa.
  4. Selecione KnowledgeOwl no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Como alternativa, poderá também usar o Assistente de Configuração do Enterprise App . Neste assistente, você pode adicionar um aplicativo ao seu locatário, adicionar usuários/grupos ao aplicativo, atribuir funções, bem como percorrer a configuração do SSO. Saiba mais sobre os assistentes do Microsoft 365.

Configurar e testar o Microsoft Entra SSO para KnowledgeOwl

Configure e teste o Microsoft Entra SSO com o KnowledgeOwl usando um usuário de teste chamado B.Simon. Para que o SSO funcione, você precisa estabelecer uma relação de vínculo entre um usuário do Microsoft Entra e o usuário relacionado no KnowledgeOwl.

Para configurar e testar o Microsoft Entra SSO com o KnowledgeOwl, execute as seguintes etapas:

  1. Configurar o Microsoft Entra SSO - para permitir que seus usuários usem esse recurso.
    1. Criar um usuário de teste do Microsoft Entra - para testar o logon único do Microsoft Entra com B.Simon.
    2. Atribua o de usuário de teste do Microsoft Entra - para permitir que B.Simon use o logon único do Microsoft Entra.
  2. Configure KnowledgeOwl SSO - para configurar as configurações de logon único no lado do aplicativo.
    1. Criar utilizador de teste do KnowledgeOwl - para ter um equivalente de B.Simon no KnowledgeOwl que esteja vinculado à representação do utilizador no Microsoft Entra.
  3. Teste SSO - para verificar se a configuração funciona.

Configurar o Microsoft Entra SSO

Siga estas etapas para habilitar o Microsoft Entra SSO.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Cloud Application Administrator.

  2. Navegue até Identity>Applications>Enterprise applications>KnowledgeOwl>Autenticação única.

  3. Na página Seleciona um método de logon único, seleciona SAML.

  4. Na página Configurar logon único com SAML, clique no ícone de lápis para a Configuração Básica de SAML para editar as configurações.

    Editar Configuração Básica SAML

  5. Na seção de Configuração Básica do SAML, se desejar configurar o aplicativo no modo iniciado IDP, insira os valores para os seguintes campos:

    um. Na caixa de texto Identificador, digite a URL usando um dos seguintes padrões:

    https://app.knowledgeowl.com/sp
https://app.knowledgeowl.com/sp/id/<unique ID>

    b. Na caixa de texto URL de resposta, digite a URL usando um dos seguintes padrões:

    https://subdomain.knowledgeowl.com/help/saml-login
https://subdomain.knowledgeowl.com/docs/saml-login
https://subdomain.knowledgeowl.com/home/saml-login
https://privatedomain.com/help/saml-login
https://privatedomain.com/docs/saml-login
https://privatedomain.com/home/saml-login

  6. Clique Definir URLs adicionais e execute a seguinte etapa se desejar configurar o aplicativo no modo iniciado SP:

    Na caixa de texto URL de início de sessão, escreva o URL utilizando um dos seguintes padrões:

    https://subdomain.knowledgeowl.com/help/saml-login
https://subdomain.knowledgeowl.com/docs/saml-login
https://subdomain.knowledgeowl.com/home/saml-login
https://privatedomain.com/help/saml-login
https://privatedomain.com/docs/saml-login
https://privatedomain.com/home/saml-login

    Observação

    Estes valores não são reais. Você precisará atualizar esses valores do Identificador real, URL de resposta e URL Sign-On, que será explicado mais adiante no artigo.

  7. O aplicativo KnowledgeOwl espera as asserções SAML em um formato específico, o que requer que você adicione mapeamentos de atributos personalizados à sua configuração de atributos de token SAML. A captura de tela a seguir mostra a lista de atributos padrão.

    imagem

  8. Além disso, o aplicativo KnowledgeOwl espera que mais alguns atributos sejam passados de volta na resposta SAML, que são mostrados abaixo. Esses atributos também são pré-preenchidos, mas você pode revisá-los de acordo com suas necessidades.

    Nome Atributo de origem Espaço de nomes
    ssoid usuário.mail http://schemas.xmlsoap.org/ws/2005/05/identity/claims

  9. Na página Configurar início de sessão único com SAML, na seção SAML Certificado de Assinatura, localize Certificado (Bruto) e selecione Download para transferir o certificado e salvá-lo no seu computador.

    O link de download do certificado

  10. Na seção Configurar o KnowledgeOwl, copie o(s) URL(s) apropriado(s) com base na sua necessidade.

    Copiar URLs de configuração

Criar um usuário de teste do Microsoft Entra

Nesta seção, você criará um usuário de teste chamado B.Simon.

  1. Entre no centro de administração do Microsoft Entra pelo menos como Administrador de Utilizadores.
  2. Navegue até Identidade>Utilizadores>Todos os utilizadores.
  3. Selecione Novo usuário>Criar novo usuário, na parte superior da tela.
  4. Nas propriedades User, siga estes passos:
    1. No campo Nome para exibição, digite B.Simon.
    2. No campo Nome principal do utilizador, digite o username@companydomain.extension. Por exemplo, B.Simon@contoso.com.
    3. Selecione a caixa de seleção Mostrar palavra-passe e anote o valor exibido na caixa Palavra-passe.
    4. Selecione Revisar + criar.
  5. Selecione Criar.

Atribuir o usuário de teste do Microsoft Entra

Nesta seção, você permitirá que B.Simon use o logon único concedendo acesso ao KnowledgeOwl.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Cloud Application Administrator.
  2. Navegue até Identity>Applications>Enterprise applications>KnowledgeOwl.
  3. Na página de visão geral do aplicativo, selecione Usuários e grupos.
  4. Selecione Adicionar utilizador/grupoe, em seguida, selecione Utilizadores e grupos na caixa de diálogo de atribuição Adicionar.
    1. Na caixa de diálogo Usuários e grupos, selecione B.Simon na lista Usuários e clique no botão Selecionar na parte inferior da tela.
    2. Se estiver à espera que um cargo seja atribuído aos utilizadores, poderá selecioná-lo na lista suspensa Selecione um cargo. Se nenhuma função tiver sido configurada para este aplicativo, você verá a função "Acesso padrão" selecionada.
    3. Na caixa de diálogo Adicionar Tarefa, clique no botão Atribuir.

Configurar o SSO do KnowledgeOwl

  1. Em uma janela diferente do navegador da Web, entre no site da empresa KnowledgeOwl como administrador.

  2. Clique em Configurações e, em seguida, selecione SSO.

    Captura de tela mostra o SSO selecionado no menu Configurações.

  3. Na aba de Configurações do SAML, execute as seguintes etapas:

    Captura de tela mostra a integração SAML S S O onde você pode fazer as alterações descritas aqui.

    um. Selecione Ativar SAML SSO.

    b. Copie o valor do ID da Entidade do SP de e cole-o no Identificador (ID da Entidade) de na secção Configuração SAML Básica no portal do Azure.

    c. Copie o valor de URL de Logon do SP e cole-o nas caixas de texto URL de Logon e URL de Resposta na seção Configuração SAML Básica no portal do Azure.

    d. Na caixa de texto IdP entityID, cole o valor Microsoft Entra Identifier, que você copiou anteriormente.

    e. Na caixa de texto URL de Login do IdP, cole o valor URL de Login, que você copiou anteriormente.

    f. Na caixa de texto URL de Logout do IdP, cole o valor URL de Logout que copiou anteriormente.

    g. Carregue o certificado baixado no portal do Azure clicando no link Carregar abaixo Certificado IdP.

    h. Clique Salvar na parte inferior da página.

    Captura de tela mostra o botão Salvar.

    i. Abra a guia Mapa de Atributos SAML para mapear atributos e executar as seguintes etapas:

    A captura de ecrã mostra Map SAML Attributes onde podes fazer as alterações descritas aqui.

    • Introduza http://schemas.xmlsoap.org/ws/2005/05/identity/claims/ssoid na caixa de texto ID SSO.
    • Introduza http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress na caixa de texto Nome de utilizador/ E-mail.
    • Introduza http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname na caixa de texto Nome Próprio.
    • Introduza http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname na caixa de texto Apelido.

    j. Clique Salvar na parte inferior da página.

    Captura de tela mostra o botão Salvar1.

Criar usuário de teste do KnowledgeOwl

Nesta seção, um usuário chamado B.Simon é criado no KnowledgeOwl. O KnowledgeOwl suporta provisionamento de usuário just-in-time, que é habilitado por padrão. Não há nenhum item de ação para você nesta seção. Se um usuário ainda não existir no KnowledgeOwl, um novo será criado após a autenticação.

Observação

Se você precisar criar um usuário manualmente, entre em contato com equipe de suporte da KnowledgeOwl.

Teste de SSO

Nesta seção, você testa sua configuração de logon único do Microsoft Entra com as seguintes opções.

SP iniciado

  • Clique em testar esta aplicação, isso irá redirecionar para KnowledgeOwl Sign on URL onde você pode iniciar o fluxo de login.

  • Vá para o URL de logon do KnowledgeOwl diretamente e inicie o fluxo de login a partir daí.

IDP iniciado

  • Clique em testar este aplicativo, no portal do Azure e você deve ser automaticamente conectado ao aplicativo KnowledgeOwl para o qual você configurou o SSO.

Você também pode usar o portal Microsoft My Apps para testar o aplicativo em qualquer modo. Quando você clica no bloco KnowledgeOwl no portal Meus Aplicativos, se configurado no modo SP, você será redirecionado para a página de logon do aplicativo para iniciar o fluxo de login e, se configurado no modo IDP, deverá ser automaticamente conectado ao aplicativo KnowledgeOwl para o qual configurou o SSO. Para obter mais informações sobre o portal Meus Aplicativos, consulte Introdução aos Meus Aplicativos.

Conteúdo relacionado

Depois de configurar o KnowledgeOwl, você pode impor o controle de sessão, que protege a exfiltração e a infiltração dos dados confidenciais da sua organização em tempo real. O controle de sessão se estende do Acesso Condicional. Saiba como impor o controlo de sessão com o Microsoft Defender for Cloud Apps.