Índice

exclude	.*ndice:

Objetivo

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

Introdução

O AD FS, O ADFS (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 ADFS

Abaixo são demonstrados os passos para a criação da entidade confiável para a Linha RM dentro do AD FS.Configurando o RM para a Integração - Passo a Passo:ADFS.

Passo a Passo

Informações

icon	false

Deck of Cards

id

id 1Passo 2idPasso 3

Image Removed

Configurando o Aplicativo Confiável no ADFS

Card

Passo 1

label	1º Passo

title

Passo 1

:

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

Image Removed

Acione o botão "Start".

Card

Image Added

Card

label	2º Passo:

id

Passo 2

label

Passo 2

title

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

Image Removed

Image Added

Acione o botão "Next".

Card

label

3º Passo:

Informe um nome para identificar o aplicativo.

Image Added

Card

label

Passo 3

title

Passo 3

Card

id	Passo 4
label	Passo 4
title	Passo 4

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

Card

id	Passo 5
label	Passo 5
title	Passo 5

4º Passo:

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

Image Added

Card

label	5º Passo:

Neste ponto, acione "Next".

Image Added

Card

label	6º Passo:

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/TLS no Host

Image Added

Card

label	7º Passo:

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

Image Added

Card

label	8º Passo:

Escolha a opção "Permit all users to access thie relying party".

Image Added

Card

label	9º Passo:

Neste ponto, acione "Next".

Image Added

Card

label	10º Passo:

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

Image Added

Configurando as Regras de Declaração (RM Portal)

Informações

icon	false

Deck of Cards

id	Configurando o Aplicativo Confiável no ADFS

Card

label	1º Passo:

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

Image Added

Card

label	2º Passo:

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

Image Added

Card

label	3º Passo:

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.

Image Added

Card

label	4º Passo:

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

Image Added

Card

label	5º Passo:

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

Image Added

Card

label	6º Passo:

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

Image Added

Card

label	7º Passo:

Para o Portal CorporeRM não é necessário configurar o RelaySate.

Mas, para usar o portal FrameHTML, é necessário configurá-lo, de acordo com a regra abaixo, no seguinte formato:

state|loginPage|returnUrl
Ex: webapi|http://localhost:8090/RM/Login/Login.aspx|/web/app/RH/PortalMeuRH/

obs1: state para FrameHTML deve ser exclusivamente webapi.
obs2: até a versão 12.1.29 continua necessário mandar o ExecutablePath na requisição Saml.

Configurando as Regras de Declaração (MDI - RM.exe)

Informações

icon	false

Deck of Cards

id	Configurando o Aplicativo Confiável no ADFS

Card

label	1º Passo:

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

Image Added

Card

label	2º Passo:

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

Image Added

Card

label	3º Passo:

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.

Image Added

Card

label	4º Passo:

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

Image Added

Card

label	5º Passo:

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

Image Added

Card

label	6º Passo:

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

Image Added

Card

label	7º Passo:

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

Image Added

Card

label	8º Passo:

Selecione a opção "Send Claims Using a Custom Rule".

Image Added

Card

label	9º Passo:

Defina um nome para a regra e escreva a regra de declaração customizada conforme a imagem abaixo:

Image Added

Bloco de código

language	c#
title	RelayState
linenumbers	true

=> issue(Type = "RelayState", Value = "samlexecutable");

Card

label	10º Passo:

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

Image Added

Card

label	11º Passo:

Selecione a opção "Send Claims Using a Custom Rule".

Image Added

Card

label	12º Passo:

Defina um nome para a regra e escreva a regra de declaração customizada conforme a imagem abaixo:

Image Added

Bloco de código

language	c#
title	RelayState
linenumbers	true

=> issue(Type = "ExecutablePath", Value = "C:\totvs\CorporeRM\RM.Net\RM.exe");

Integração SAML no RM

Metadado do ADFS

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

Bloco de código

language	xml
firstline	1
title	Metadata
linenumbers	true

<?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><Conteúdo do Certificado Proveniente do Arquivo Metadata></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=<Identificador do RP>" 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.

Aviso

title	Atenção

O atributo entityID do elemento EntityDescriptor deve estar definido com a URL do Portal Corpore.NET.
A tag X509Certificate deve ser preenchida com o certificado em base64 proveninente do arquivo de metadata, disponível em https://<Servidor AD FS>/FederationMetadata/2007-06/FederationMetadata.xml
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

Caso queira integrar o ADFS com a MDI, via SAML, adicionar o metadado no campo "Metadata Identity Provider - RM.exe"

Image Added

Caso queira integrar o ADFS com o Portal, via SAML, adicionar o metadado no campo "Metadata Identity Provider - Portal".

Image Added

Informações

title	Observação

Existe a possibilidade de integrar o ADFS com a MDI e o Portal de forma simultânea, basta adicionar o metadado nos campos "Metadata Identity Provider - RM.exe" e "Metadata Identity Provider - Portal".

Informações

icon	false

Informações

icon	false

Produto: Framework

Informações

icon	false

Versão: 12.1.18 e superiores

Informações

icon	false

Processo: Integração SAML

Informações

icon	false

Informações

icon	false

Status: Finalizado

Informações

icon	false

Data: 15/03/2018

Informações

icon	false

Autores:

Diogo Damiani Ferreira

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 3

Nova versão Atual

Chave

Índice

Objetivo

Introdução

Configurando o Aplicativo Confiável no ADFS

Configurando as Regras de Declaração (RM Portal)

Configurando as Regras de Declaração (MDI - RM.exe)

Integração SAML no RM

Atalhos

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 3

Nova versão Atual

Chave

Índice

Objetivo

Introdução

Configurando o Aplicativo Confiável no ADFS

Configurando as Regras de Declaração (RM Portal)

Configurando as Regras de Declaração (MDI - RM.exe)

Integração SAML no RM