totvsObjetivo

Este documento é demonstra como integrar o sistema RM com o AD FS como provedor de Identidade.

Introdução

O AD FS, Active Diretory Federation Services, permite o compartilhamento da informação de identidade em um ampla variedade de aplicativos utilizando o padrão SAML que é suportado na linha RM.

Configurando o Aplicativo Confiável no AD FS

Abaixo são demonstrados os passos para a criação da entidade confiável para a Linha RM dentro do AD FS.

Ao acessar a configuração do AD FS, selecione "Add Relying Party Trust" para acesso ao assistente de configuração.

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_10-34-23.png

Acione o botão "Start".

Selecione a opção "Enter data about the relying party manually" para inserir os dados sobre a Linha RM.

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_10-46-50.png

Acione o botão "Next".

Informe um nome para identificar o aplicativo

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_10-54-6.png

Selecione a opção: "AD FS profile"

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_10-57-10.png

Neste ponto, acione "Next"

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_10-58-55.png

Neste passo, deve-se informar a URL do serviço responsável por processar o SingleSignOn do RM:
https://<Endereço do Host>/RMCloudPass/SSOSaml2

O AD FS exige que este serviço esteja exposto via SSL. Mais detalhes sobre como configurar o RM Host para expor serviços via SSL em: Habilitar SSL no Host

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_11-2-29.png

Selecione a opção: "I do not want to configure multifactor..."

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_11-5-53.png

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_11-9-13.png

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_12-9-1.png

Selecione a caixa de seleção para abrir a edição de regras

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_12-9-34.png

Selecione a opção: "Add rule..."

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_12-10-18.png

Selecione a opção: "Send LDAP Attributes as Claims"

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_12-10-48.png

Defina um nome para a regra e selecione o mapeamento conforme a imagem abaixo. O mapeamento para o SSO no RM é feito pelo e-mail do usuário.

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_12-11-17.png

Selecione a opção: "Add rule..."

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_12-12-13.png

Selecione a opção: "Tranform an Incoming Claim"

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_12-14-23.png

Defina um nome para a regra e selecione os parâmetros conforme a imagem abaixo.

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_12-15-8.png

Metadado do AD FS

Abaixo temos um exemplo do metadados SAML que deve ser importado no RM:

<?xml version="1.0" encoding="UTF-8"?>
<EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID="http://<URI do Portal Corpore .NET>" ID="_32a417e2-1378-405d-8757-94bcba2db823">
<IDPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
<KeyDescriptor use="signing">
<KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">
<X509Data>
	<X509Certificate>MIIC4DCCAcigAwIBAg...</X509Certificate>
</X509Data>
</KeyInfo>
</KeyDescriptor>
<SingleSignOnService Location="https://<Servidor AD FS>/adfs/ls/idpinitiatedsignon.aspx?loginToRp=<Identificador do RP>" Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST"/>
<SingleSignOnService Location="https://<Servidor AD FS>/adfs/ls/idpinitiatedsignon.aspx?loginToRp=Totvs" Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect"/>
<SingleLogoutService Location="https://<Servidor AD FS>/adfs/ls/?wa=wsignout1.0" Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect"/>
<SingleLogoutService Location="https://<Servidor AD FS>/adfs/ls/?wa=wsignout1.0" Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" />
</IDPSSODescriptor>
</EntityDescriptor>

Repare que as URI's devem estar configuradas de acordo com seu ambiente.

O atributo entityID do elemento EntityDescriptor deve estar definido com a URL do Portal Corpore.NET.
Nas URI's de SingleSignOnService, o parâmetros LoginToRp deve receber o nome da Relying Party configurado no Passo 3 do Item "Configurando o aplicativo confiável no AD FS".

Importando o metadado do AD FS no RM

Após obter o metadados personalizado, ele deve ser importado no RM em: Ambiente → Parâmetros → Parâmetros Globais → Integração SAML

Linha RM > Integração do RM com ADFS via SAML > image2018-3-14_14-43-56.png

Até o momento, a integração com o AD FS foi homologada somente com o Portal Corpore.NET

Produto: Framework

Versão: 12.1.18 e superiores

Processo: Integração SAML

Status: Finalizado

Data: 15/03/2018

Autores:

Diogo Damiani Ferreira