MASTERSAF DFE MANUAL DE CONFIGURAÇÃO SAML DFE V3

Transcrição

1 DFE V3 Versão do Documento: 1.0 Publicado em: 09/04/2019

2 SUMÁRIO INTRODUÇÃO... 3 PRÉ-REQUISITO... 3 CONFIGURAÇÃO... 3 MUDANÇAS DE VERSÕES DO MANUAL SUPORTE TÉCNICO Página 2 de 15

3 INTRODUÇÃO Este documento foi elaborado com o objetivo de orientar sobre o procedimento para ativar autenticação no através do SAML (Security Assertion Markup Language). PRÉ-REQUISITO Instalado: Versão mínima Microsoft AD FS configurado. CONFIGURAÇÃO Neste manual para demonstrar a funcionalidade de autenticação SAML, será utilizado como exemplo a configuração do Mastersaf DFe com o AD FS como Identity Provider. Segue abaixo os passos para realizar esta configuração: 1. Com o servidor Tomcat fora do ar, abra o arquivo context.xml localizado no diretório (\tomcat\conf) de instalação do tomcat do portal. Neste arquivo deve ser ativado no contexto o profile de configuração do SAML. Por padrão as linhas de configuração do SAML estarão em comentário (desativadas). Para ativá-las, remova a notação de comentário XML para que fique conforme: <Environment name="activeprofiles" override="false" type="java.lang.string" value="samlconfig"/> 2. Inicie o Tomcat. Ao acessar o Mastersaf DFe, um novo item chamado SSO ficará visível. É através desta funcionalidade que será possível realizar a configuração do SAML. Página 3 de 15

4 3. Acesse a tela de configuração do SAML e preencha os campos App Name e URL Base DFE conforme abaixo: NAME APP Name: URL Base DFe VALUE Informe neste campo um nome para a aplicação DFe que poderá ser informado dentro do Identity Provider (IdP). Ex: Mastersaf DFe Url Base do DFe que é sugerida automaticamente ao ser criado um novo registro de configuração SAML no padrão Ex: Página 4 de 15

5 4. Após salvar a configuração, reinicie o servidor Tomcat; 5. Após o servidor Tomcat reiniciar, acessar a tela de configuração do SAML e realizar o download do metadata do Mastersaf DFe através do botão Download SP Metadata. 6. Transferir o arquivo de metadata do DFe para o servidor do ADFS e abrir a ferramenta o AD FS Management. 7. Acessar a tela de configuração do AD FS. Página 5 de 15

6 8. Acessar AD FS > Trust Relationships > Relying Party Trusts > Add Relying Party Trust 9. Clique em Start Página 6 de 15

7 10. Selecione Import data about the relying party from a file e preencha o caminho para o arquivo de metadata do Onesource e clique em Next. 11. Digite um nome de exibição e clique em Next Página 7 de 15

8 12. Selecione a opção para configurar Multi-factor Authentication posteriormente e clique em Next 13. Selecione a opção de configuração posterior para Permissões de acesso e clique em Next Página 8 de 15

9 14. Confira as informações e clique em Next 15. Deixe a opção marcada e clique em Close Página 9 de 15

10 16. Na janela Edit Claim Rules clique em Add Rule Selecione o Template Send LDAP Attributes as Claims e clique em Next ; Página 10 de 15

11 18. Informe os seguintes valores para os campos: a. Claim rule name: NameID b. Attribute store: Active Directory c. LDAP Attribute: SAM-Account-Name d. Outgoing claim type: Name ID Após informar os dados, salvar a configuração. 19. Abrir com um duplo clique a configuração criada anteriormente, e na aba Advanced configurar o algoritimo de hash para SHA-1. Página 11 de 15

12 20. Após a configuração do AD FS estar concluído, será necessário realizar o download do metadata do AD FS. Ele é disponibilizado para download através do seguinte endereço Acessar a tela de configuração do SAML, e realizar o upload do xml do metadata através do botão PROCURAR no campo IDP Metadata. Após o upload ser realizado, favor salvar a configuração. 22. O próximo passo a ser realizado é vincular o usuário do Mastersaf DFe como o respectivo usuário do AD FS. Este vinculo é feito através do campo Login IDP na seção SAML no Cadastro de Usuários do sistema. 23. Com o servidor Tomcat fora do ar, abra o arquivo context.xml localizado no diretório (\tomcat\conf) de instalação do tomcat do portal. Neste arquivo deve ser ativado no contexto o profile de utilização do SAML. Por padrão as linhas de configuração do SAML estarão em comentário (desativadas). Para ativá-las, remova a notação de comentário XML para que fique conforme: <Environment name="activeprofiles" override="false" type="java.lang.string" value="saml"/> Página 12 de 15

13 24. Após iniciado o Tomcat, o DFe irá apresentar o link para realizar a autenticação conforme abaixo. Página 13 de 15

14 MUDANÇAS DE VERSÕES DO MANUAL VERSÃO DATA MUDANÇAS VERSÃO DFE /04/2019 Criação do manual Página 14 de 15

15 SUPORTE TÉCNICO Para dúvidas ou problemas, abra um chamado no Contact Center por meio do site ou entre em contato com nossa equipe de Suporte Técnico pelo Telefone: (11) Opção 2 (Atendimento das Soluções DFE). Nosso horário de atendimento é de segunda a sexta-feira das 9h às 18h. Página 15 de 15