Tutorial: integração do logon único (SSO) do Microsoft Entra ao FiscalNote
Neste tutorial, você aprenderá a integrar o FiscalNote ao Microsoft Entra ID. Ao integrar o FiscalNote com o Microsoft Entra ID, você pode:
- Controlar no ID do Microsoft Entra quem tem acesso ao FiscalNote.
- Permitir que seus usuários entrem automaticamente no FiscalNote com suas contas do Microsoft Entra.
- Gerencie suas contas em um local central.
Para saber mais sobre a integração de aplicativos SaaS ao Microsoft Entra ID, confira O que é o acesso de aplicativos e o logon único com o Microsoft Entra ID.
Pré-requisitos
Para começar, você precisará dos seguintes itens:
- Uma assinatura do Microsoft Entra. Caso você não tenha uma assinatura, obtenha uma conta gratuita.
- Assinatura habilitada para SSO (logon único) do FiscalNote.
Descrição do cenário
Neste tutorial, você vai configurar e testar o SSO do Microsoft Entra em um ambiente de teste.
O FiscalNote dá suporte ao SSO iniciado por SP
O FiscalNote dá suporte ao provisionamento de usuário Just-In-Time
Adição do FiscalNote da galeria
Para configurar a integração do FiscalNote ao Microsoft Entra, você precisará adicionar o FiscalNote da galeria à sua lista de aplicativos SaaS gerenciados.
- Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
- Navegue até Identidade>Aplicativos>Aplicativos empresariais>Novo aplicativo.
- Na seção Adicionar por meio da galeria, digite FiscalNote na caixa de pesquisa.
- Selecione FiscalNote no painel de resultados e, em seguida, adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.
Opcionalmente, você também pode usar o Assistente de Configuração de Aplicativos do Enterprise. 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 de SSO. Saiba mais sobre os assistentes do Microsoft 365.
Configurar e testar o logon único do Microsoft Entra para o FiscalNote
Configurar e testar o SSO do Microsoft Entra com o FiscalNote 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 FiscalNote.
Para configurar e testar o SSO do Microsoft Entra com o FiscalNote, conclua os seguintes blocos de construção:
- Configurar o SSO do Microsoft Entra - para permitir que os usuários usem esse recurso.
- Crie um usuário de teste do Microsoft Entra para testar o logon único do Microsoft Entra com B.Silva.
- Atribuir o usuário de teste do Microsoft Entra – para permitir que B.Fernandes use o logon único do Microsoft Entra.
- Configurar o SSO do FiscalNote – para definir as configurações de logon único no lado do aplicativo.
- Criar um usuário de teste do FiscalNote – para ter um equivalente de B.Simon no FiscalNote que esteja vinculado à representação de usuário do Microsoft Entra.
- Testar o SSO – para verificar se a configuração funciona.
Configurar o SSO do Microsoft Entra
Siga estas etapas para habilitar o SSO do Microsoft Entra.
Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
Navegue até Identidade>Aplicativos>Aplicativos empresariais>FiscalNote>Logon único.
Na página Selecionar um método de logon único, escolha SAML.
Na página Configurar o logon único com o SAML, clique no ícone de edição/caneta da Configuração Básica do SAML para editar as configurações.
Na seção Configuração Básica do SAML, insira os valores para os seguintes campos:
a. Na caixa de texto URL de Logon, digite uma URL usando o seguinte padrão:
https://<InstanceName>.fiscalnote.com/login?client=<ClientID>&redirect_uri=https://app.fiscalnote.com/saml-login.html&audience=https://api.fiscalnote.com/&connection=<CONNECTION_NAME>&response_type=id_token%20tokenb. Na caixa de texto Identificador (ID da Entidade) , digite uma URL usando o seguinte padrão:
urn:auth0:fiscalnote:<CONNECTIONNAME>Observação
Esses valores não são reais. Atualize esses valores com a URL de Entrada e o Identificador reais. Contate a equipe de suporte do Cliente FiscalNote para obter esses valores. Você também pode consultar os padrões mostrados na seção Configuração Básica do SAML.
O aplicativo FiscalNote espera as declarações SAML em um formato específico, o que exige a adição de mapeamentos de atributo personalizado à configuração de atributos do token SAML. A captura de tela a seguir mostra a lista de atributos padrão.
Além do indicado acima, o aplicativo FiscalNote espera que mais alguns atributos sejam passados novamente na resposta SAML, que são mostrados abaixo. Esses atributos também são pré-populados, mas você pode examiná-los de acordo com seu requisito.
Nome Atributo de Origem familyName user.surname email user.mail Na página Configurar logon único com SAML, na seção Certificado de autenticação SAML, localize Certificado (Bruto) e selecione Baixar para baixar o certificado e salvá-lo no computador.
Na seção Configurar o FiscalNote, copie as URLs apropriadas de acordo com suas necessidades.
Criar um usuário de teste do Microsoft Entra
Nesta seção, você criará um usuário de teste chamado B.Fernandes.
- Entre no centro de administração do Microsoft Entra como, no mínimo, Administrador de Usuários.
- Navegue até Identidade>Usuários>Todos os usuários.
- Na parte superior da tela, selecione Novo usuário>Criar novo usuário.
- Nas propriedades do Usuário, siga estas etapas:
- No campo Nome de exibição, insira
B.Simon. - No campo Nome principal do usuário, insira o username@companydomain.extension. Por exemplo,
B.Simon@contoso.com. - Marque a caixa de seleção Mostrar senha e, em seguida, anote o valor exibido na caixa Senha.
- Selecione Examinar + criar.
- No campo Nome de exibição, insira
- Selecione Criar.
Atribuir o usuário de teste do Microsoft Entra
Nesta seção, você permitirá que B.Fernandes use o logon único ao conceder-lhe acesso ao FiscalNote.
Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
Navegue até Identidade>Aplicativos>Aplicativos empresariais>FiscalNote.
Na página de visão geral do aplicativo, localize a seção Gerenciar e escolha Usuários e grupos.
Escolha Adicionar usuário e, em seguida, Usuários e grupos na caixa de diálogo Adicionar Atribuição.
Na caixa de diálogo Usuários e grupos, selecione B.Fernandes na lista Usuários e clique no botão Selecionar na parte inferior da tela.
Se você estiver esperando um valor de função na declaração SAML, na caixa de diálogo Selecionar Função, escolha a função apropriada para o usuário da lista e, em seguida, clique no botão Escolher na parte inferior da tela.
Na caixa de diálogo Adicionar atribuição, clique no botão Atribuir.
Configurar o SSO do FiscalNote
Para configurar o logon único no FiscalNote, será necessário enviar o Certificado (Bruto) baixado e as URLs apropriadas copiadas da configuração do aplicativo para a equipe de suporte do FiscalNote. Eles definem essa configuração para ter a conexão de SSO de SAML definida corretamente em ambos os lados.
Criar um usuário de teste do FiscalNote
Nesta seção, um usuário chamado B.Fernandes será criado no FiscalNote. O FiscalNote dá suporte ao provisionamento de usuário Just-In-Time, que está habilitado por padrão. Não há itens de ação para você nesta seção. Se um usuário ainda não existir no FiscalNote, um novo será criado após a autenticação.
Observação
Se você precisar criar um usuário manualmente, contate a equipe de suporte do FiscalNote.
Testar o SSO
Nesta seção, você testará sua configuração de logon único do Microsoft Entra usando o Painel de Acesso.
Ao clicar no bloco do FiscalNote no Painel de Acesso, você deverá ser conectado automaticamente ao FiscalNote, para o qual você configurou o SSO. Para saber mais sobre o Painel de Acesso, veja Introdução ao Painel de Acesso.