Skip to main content

Guia de instalação do BriefCam

SAML – Configuração de Terceiros Confiáveis do ADFS para Requisitos BriefCam

Last Updated: 4 minute read
Versão2024r2
IdiomaPortuguês

  1. Para usar o ADFS para fazer login na sua BriefCam instância, você precisa dos seguintes componentes:

    • Uma instância do Active Directory.

    • Este guia usa capturas de tela do Servidor 2012R2, mas etapas semelhantes devem ser possíveis em outras versões.

    • Um certificado SSL para assinar sua página de login do ADFS e a impressão digital desse certificado.

    • Depois de atender a esses requisitos básicos, você precisa instalar o ADFS em seu servidor. A configuração e instalação do ADFS está além do escopo deste guia, mas é detalhado em um artigo da Base de Conhecimento Microsoft.

    Nota

    BriefCam usa o e-mail do usuário fornecido pelo ADFS como parte das asserções SAML para identificar o usuário.

  2. Quando tiver uma instalação do ADFS totalmente instalada, anote o valor do URL da SAML 2.0/W-Federation na seção Pontos de extremidade do ADFS. Se você escolher os padrões para a instalação, isso será '/adfs/ls/'.

Etapa 1: Adicionando uma Relação de Confiança da Terceira Parte Confiável

  1. Neste ponto, você deve estar pronto para configurar a conexão ADFS com a sua BriefCam instância. A conexão entre o ADFS e o RPT BriefCam é definida usando uma Relação de Confiança da Terceira Parte Confiável (RPT).

  2. Selecione a pasta Confianças da Terceira Parte do Gerenciamento do ADFS e adicione uma nova Confiança da Terceira Parte Confiável Padrão na barra lateral Ações. Isso inicia o assistente de configuração para uma nova relação de confiança.

    SAML welcome.png

  3. Na tela Selecionar fonte de dados, selecione a última opção e insira os dados da terceira parte confiável manualmente.

    SAML select source.png

  4. Na próxima tela, insira um nome de exibição que você reconhecerá no futuro e todas as anotações que desejar fazer.

    SAML display name.png

  5. Na próxima tela, selecione o botão de opção Perfil do AD FS.

    SAML AD FS profile.png

  6. Na próxima tela, deixe as configurações do certificado com seus padrões.

    SAML configure certificate.png

  7. Na próxima tela, marque a caixa rotulada Ativar suporte para o protocolo SAML 2.0 WebSSO. O URL do serviço será: https://<WebServices>/ProWebApi/AuthenticationApi/AuthenticateSaml

    Substitua <WebServices> pelo seu endereço de servidor de BriefCam Web Services. Observe que não há barra à direita no final do URL.

    SAML Enable support for protocol.png

  8. Na próxima tela, adicione um identificador de confiança da terceira parte confiável.

    https://<WebServices>/prowebapi Deve corresponder ao endereço exato do ProWebAPI nas configurações (diferencia maiúsculas de minúsculas).

    Substitua <WebServices> pelo seu endereço de servidor dos BriefCam Serviços Web.

    SAML relying identifier.png

    HTTPS é necessário no endereço.

  9. Na próxima tela, você pode configurar a autenticação multifator, mas isso está além do escopo deste guia.

    SAML multi-factor.png

  10. Na próxima tela, selecione o botão de opção Permitir que todos os usuários acessem esta terceira parte confiável.

    SAML permit all.png

  11. Nas próximas duas telas, o assistente exibirá uma visão geral das suas configurações. Na tela final, use o botão Fechar para sair e abrir o editor de regras de reivindicação.

    SAML claim rules.png

Etapa 2: Criação de Regras de Reivindicação

Assim que a relação de confiança da terceira parte confiável for criada, você pode criar as regras de alegação.

  1. Para criar uma nova regra, clique em Adicionar regra. Criar uma regra Enviar Atributos LDAP como Alegações.

    SAML claim rule template.png

  2. Na próxima tela, usando o Active Directory como repositório de atributos, faça o seguinte:

    • Na coluna Atributo LDAP, selecione Endereços de e-mail.

    • Em Tipo de reivindicação de saída, selecione Endereço de e-mail.

      SAML configure rule.png

  3. Repita a etapa para o UPN.

  4. Clique em OK para salvar a nova regra.

Etapa 3: Configurando BriefCam

  1. Após configurar o ADFS, você precisa configurar sua BriefCam instância para autenticar usando SAML.

  2. Você usará o URL completo do servidor ADFS com o endpoint SAML como o URL SSO.

  3. A impressão digital será a impressão digital do certificado de assinatura de token instalado em sua instância do ADFS. No utilitário de certificação do Windows, isso também é chamado de impressão digital SHA-1.

  4. Exportar o certificado de assinatura de token ADFS (no servidor ADFS) no PowerShell como administrador:

    $certRefs=Get-AdfsCertificate -CertificateType Token-Signing

    $certBytes=$certRefs[0].Certificate.Export([System.Security.Cryptography.X509Certificates.X509ContentType]::Cert)

    [System.IO.File]::WriteAllBytes("c:\foo.cer", $certBytes)

  5. Copie c:\foo.cer para o BriefCam servidor.

  6. Iniciar mmc.

  7. Arquivo -> adicionar e remover snap-ins.

  8. Certificados -> adicionar -> conta de computador -> computador local.

  9. Vá para Certificados -> Pessoais -> Certificados.

  10. Clique com o botão direito em Certificados e selecione Todas as Tarefas -> Importarfoo.cer.

    SAML import certificate.png

  11. Clique duas vezes no novo certificado, vá para a guia de detalhes e copie a impressão digital do certificado.

  12. Cole a impressão digital em um editor de texto, remova os espaços e copie e cole-a na seção ProWebAPI no campo Web admin > Configurações SamlCertificate.

  13. Defina os seguintes campos nas configurações de ambiente BriefCam Administrator Consoledo:

    • SamlLoginUrl = https:// <ADFS Server address>/adfs/ls/idpinitiatedsignon

    • SamlLogoutUrl = URL de logout do servidor ADFS

    • SamlCertificate = <Certificado SAML>

    Nota

    Não altere as configurações do ambiente ProWebApiAddress e ProWebClientAddress (deixe os valores padrão).

  14. No gerenciador do IIS no computador WebServices, vá para BriefCam Web Services > Bindings > Add, no menu suspenso Type, selecione https e clique em OK¼.

    SAML Add binding.png

  15. Reinicie os Serviços IIS (abrindo os serviços Windows, clicando com o botão direito no Serviço de Publicação do World Wide Web e clicando em Reiniciar).

  16. Agora, você deve estar configurado e pronto para começar. Para testar, execute: https://localhost/authenticationApi/RequestAuthenticationRoute

Se você foi redirecionado para a página de login, fez login e recebeu uma saída válida (ID da sessão e nome de usuário), parabéns por ter sobrevivido com sucesso a este guia.

Caso contrário, certifique-se de ter seguido todas as etapas corretamente.