Partilhar via

Tutorial: Integração do Microsoft Entra SSO com a autenticação SAML do RStudio Connect

  • Artigo

Neste tutorial, você aprenderá como integrar a autenticação SAML RStudio Connect com o Microsoft Entra ID. Ao integrar a Autenticação SAML do RStudio Connect com o Microsoft Entra ID, você pode:

  • Controle no Microsoft Entra ID quem tem acesso à Autenticação SAML do RStudio Connect.
  • Permita que seus usuários entrem automaticamente na Autenticação SAML do RStudio Connect com suas contas do Microsoft Entra.
  • Gerencie suas contas em um local central.

Pré-requisitos

Para configurar a integração do Microsoft Entra com a Autenticação SAML do RStudio Connect, você precisa dos seguintes itens:

  • Uma assinatura do Microsoft Entra. Se não tiver um ambiente Microsoft Entra, pode obter uma conta gratuita.
  • Autenticação SAML do RStudio Connect. Há uma avaliação gratuita de 45 dias.

Descrição do cenário

Neste tutorial, você configura e testa o logon único do Microsoft Entra em um ambiente de teste.

  • A Autenticação SAML do RStudio Connect suporta SSO iniciado por SP e IDP .

  • A autenticação SAML do RStudio Connect suporta o provisionamento de usuários Just In Time .

Para configurar a integração da Autenticação SAML do RStudio Connect no ID do Microsoft Entra, você precisa adicionar a Autenticação SAML do RStudio Connect da galeria à sua lista de aplicativos SaaS gerenciados.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
  2. Navegue até Identity>Applications>Enterprise applications>Novo aplicativo.
  3. Na seção Adicionar da galeria, digite RStudio Connect SAML Authentication na caixa de pesquisa.
  4. Selecione RStudio Connect SAML Authentication no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Como alternativa, você também pode usar o Assistente de Configuração de Aplicativo Empresarial. 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 do SSO. Saiba mais sobre os assistentes do Microsoft 365.

Configurar e testar o Microsoft Entra SSO para autenticação SAML do RStudio Connect

Configure e teste o Microsoft Entra SSO com a Autenticação SAML do RStudio Connect 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 na Autenticação SAML do RStudio Connect.

Para configurar e testar o Microsoft Entra SSO com a Autenticação SAML do RStudio Connect, execute as seguintes etapas:

  1. Configure o Microsoft Entra SSO - para permitir que seus usuários usem esse recurso.
    1. Criar um usuário de teste do Microsoft Entra - para testar o logon único do Microsoft Entra com Brenda Fernandes.
    2. Atribua o usuário de teste do Microsoft Entra - para permitir que Brenda Fernandes use o logon único do Microsoft Entra.
  2. Configure o SSO de Autenticação SAML do RStudio Connect - para configurar as configurações de Logon Único no lado do aplicativo.
    1. Criar usuário de teste de Autenticação SAML do RStudio Connect - para ter um equivalente de Brenda Fernandes na Autenticação SAML do RStudio Connect vinculado à representação do usuário do Microsoft Entra.
  3. Teste SSO - para verificar se a configuração funciona.

Configurar o Microsoft Entra SSO

Siga estas etapas para habilitar o Microsoft Entra SSO.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

  2. Navegue até Identity>Applications>Enterprise applications>RStudio Connect SAML Authentication>Single sign-on.

  3. Na página Selecione um método de logon único, selecione SAML.

  4. Na página Configurar logon único com SAML, clique no ícone de lápis para Configuração Básica de SAML para editar as configurações.

    Editar configuração básica de SAML

  5. Na seção Configuração Básica do SAML, se desejar configurar o aplicativo no modo iniciado pelo IDP, execute as seguintes etapas, substituindo <example.com> pelo endereço e a porta do servidor de autenticação SAML do RStudio Connect:

    a. Na caixa de texto Identificador , digite uma URL usando o seguinte padrão: https://<example.com>/__login__/saml

    b. Na caixa de texto URL de resposta, digite uma URL usando o seguinte padrão:https://<example.com>/__login__/saml/acs

  6. Clique em Definir URLs adicionais e execute a seguinte etapa se desejar configurar o aplicativo no modo iniciado pelo SP :

    Na caixa de texto URL de início de sessão, escreva um URL utilizando o seguinte padrão: https://<example.com>/

    Nota

    Estes valores não são reais. Atualize estes valores com o Identificador real, o URL de resposta e o URL de início de sessão. Eles são determinados a partir do endereço do servidor de autenticação SAML RStudio Connect (https://example.com nos exemplos acima). Entre em contato com a equipe de suporte da Autenticação SAML do RStudio Connect se tiver problemas. Você também pode consultar os padrões mostrados na seção Configuração Básica de SAML.

  7. Seu aplicativo de autenticação SAML RStudio Connect espera as asserções SAML em um formato específico, o que requer que você adicione mapeamentos de atributos personalizados à sua configuração de atributos de token SAML. A captura de tela a seguir mostra a lista de atributos padrão, enquanto nameidentifier é mapeado com user.userprincipalname. O aplicativo RStudio Connect SAML Authentication espera que o nameidentifier seja mapeado com user.mail, então você precisa editar o mapeamento de atributos clicando no ícone Editar e alterar o mapeamento de atributos.

    image

  8. Na página Configurar Logon Único com SAML, na seção Certificado de Assinatura SAML, clique no botão copiar para copiar a URL de Metadados de Federação de Aplicativos e salvá-la em seu computador.

    O link de download do certificado

Criar um usuário de teste do Microsoft Entra

Nesta seção, você criará um usuário de teste chamado B.Simon.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Usuário.
  2. Aceder a Identidade>Utilizadores>Todos os Utilizadores.
  3. Selecione Novo usuário>Criar novo usuário, na parte superior da tela.
  4. Nas propriedades do usuário , siga estas etapas:
    1. No campo Nome para exibição , digite B.Simon.
    2. No campo Nome principal do usuário, digite o username@companydomain.extensionarquivo . Por exemplo, B.Simon@contoso.com.
    3. Marque a caixa de seleção Mostrar senha e anote o valor exibido na caixa Senha .
    4. Selecione Rever + criar.
  5. Selecione Criar.

Atribuir o usuário de teste do Microsoft Entra

Nesta seção, você habilitará o B.Simon para usar o logon único concedendo acesso à Autenticação SAML do RStudio Connect.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
  2. Navegue até Identity>Applications>Enterprise applications>RStudio Connect SAML Authentication.
  3. Na página de visão geral do aplicativo, selecione Usuários e grupos.
  4. Selecione Adicionar usuário/grupo e, em seguida, selecione Usuários e grupos na caixa de diálogo Adicionar atribuição .
    1. Na caixa de diálogo Usuários e grupos, selecione B.Simon na lista Usuários e clique no botão Selecionar na parte inferior da tela.
    2. Se você estiver esperando que uma função seja atribuída aos usuários, poderá selecioná-la na lista suspensa Selecionar uma função . Se nenhuma função tiver sido configurada para este aplicativo, você verá a função "Acesso padrão" selecionada.
    3. Na caixa de diálogo Adicionar atribuição, clique no botão Atribuir.

Configurar SSO de autenticação SAML do RStudio Connect

Para configurar o logon único para a Autenticação SAML do RStudio Connect, você precisa usar a URL de Metadados de Federação de Aplicativos e o Endereço do Servidor usados acima. Isso é feito no arquivo de configuração RStudio Connect SAML Authentication em /etc/rstudio-connect.rstudio-connect.gcfg.

Este é um exemplo de arquivo de configuração:

[Server]
SenderEmail =

; Important! The user-facing URL of your RStudio Connect SAML Authentication server.
Address = 

[Http]
Listen = :3939

[Authentication]
Provider = saml

[SAML]
Logging = true

; Important! The URL where your IdP hosts the SAML metadata or the path to a local copy of it placed in the RStudio Connect SAML Authentication server.
IdPMetaData = 

IdPAttributeProfile = azure
SSOInitiated = IdPAndSP

Se IdPAttributeProfile = azure, o perfil define o NameIDFormat como persistente, entre outras configurações e substitui quaisquer outros atributos especificados definidos no arquivo de configuração.

Isso se torna um problema se você quiser criar um usuário com antecedência usando a API do RStudio Connect e aplicar permissões antes do usuário fazer login pela primeira vez. O NameIDFormat deve ser definido como emailAddress ou algum outro identificador exclusivo porque quando é definido como persistente, o valor fica em hash e você não sabe qual é o valor com antecedência. Portanto, usar a API não funcionará. API para criar usuário para SAML: https://docs.rstudio.com/connect/api/#post-/v1/users

Portanto, você pode querer ter isso em seu arquivo de configuração nesta situação:

[SAML]
NameIDFormat = emailAddress
UniqueIdAttribute = NameID
UsernameAttribute = http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
FirstNameAttribute = http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
LastNameAttribute = http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname
EmailAttribute = http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailAddress

Armazene seu Endereço do Server.Address Servidor no valor e a URL de Metadados de Federação do SAML.IdPMetaData Aplicativo no valor. Observe que essa configuração de exemplo usa uma conexão HTTP não criptografada, enquanto o Microsoft Entra ID requer o uso de uma conexão HTTPS criptografada. Você pode usar um proxy reverso na frente da Autenticação SAML do RStudio Connect ou configurar a Autenticação SAML do RStudio Connect para usar HTTPS diretamente.

Se tiver problemas com a configuração, pode ler o Guia Administrativo de Autenticação SAML do RStudio Connect ou enviar um e-mail para a equipa de suporte do RStudio para obter ajuda.

Criar usuário de teste de autenticação SAML do RStudio Connect

Nesta seção, um usuário chamado Brenda Fernandes é criado na Autenticação SAML do RStudio Connect. A Autenticação SAML RStudio Connect suporta provisionamento just-in-time, que é ativado por padrão. Não há nenhum item de ação para você nesta seção. Se ainda não existir um utilizador na Autenticação SAML do RStudio Connect, será criado um novo utilizador quando tentar aceder à Autenticação SAML do RStudio Connect.

SSO de teste

Nesta seção, você testa sua configuração de logon único do Microsoft Entra com as seguintes opções.

SP iniciado:

  • Clique em Testar esta aplicação, isto irá redirecionar para RStudio Connect SAML Authentication Sign on URL onde você pode iniciar o fluxo de login.

  • Vá diretamente para o URL de início de sessão de autenticação SAML do RStudio Connect e inicie o fluxo de início de sessão.

IDP iniciado:

  • Clique em Testar esta aplicação e deverá iniciar sessão automaticamente na Autenticação SAML do RStudio Connect para a qual configurou o SSO.

Você também pode usar o Microsoft My Apps para testar o aplicativo em qualquer modo. Ao clicar no bloco Autenticação SAML do RStudio Connect em Meus Aplicativos, se configurado no modo SP, você será redirecionado para a página de logon do aplicativo para iniciar o fluxo de login e, se configurado no modo IDP, deverá entrar automaticamente na Autenticação SAML do RStudio Connect para a qual configurou o SSO. Para obter mais informações, consulte Microsoft Entra My Apps.

Próximos passos

Depois de configurar a Autenticação SAML do RStudio Connect, você pode impor o controle de sessão, que protege a exfiltração e a infiltração dos dados confidenciais da sua organização em tempo real. O controle de sessão se estende do Acesso Condicional. Saiba como impor o controlo de sessão com o Microsoft Defender for Cloud Apps.