Integração SAML simplificada: Conexão do Microsoft Entra com o Couchbase Server para SSO seguro

No cenário digital atual, as empresas estão sempre buscando maneiras eficientes de gerenciar seus processos de controle de acesso e autenticação. A integração do Microsoft Entra (anteriormente conhecido como Azure AD) com o Couchbase Server oferece uma solução robusta e segura para logon único (SSO) usando SAML. Essa integração aumenta a segurança e simplifica o gerenciamento de usuários, aproveitando os recursos abrangentes de gerenciamento de identidade e acesso do Entra e, ao mesmo tempo, os poderosos recursos da plataforma de dados do Couchbase Server. Ao conectar essas duas plataformas, as organizações podem garantir uma autenticação de usuário perfeita, uma experiência de usuário aprimorada e uma administração simplificada.

Este guia o guiará pelo processo de configuração, desde a criação de um aplicativo corporativo no Microsoft Entra até a configuração do Couchbase Server como um provedor de serviços SAML. Quer você seja um administrador de segurança ou um administrador do Azure AD, este guia o ajudará a implementar com êxito o SSO baseado em SAML entre o Microsoft Entra e o Couchbase Server. Vamos mergulhar de cabeça!

Pré-requisitos

• • Acesso de administrador ao Azure AD, por exemplo, a capacidade de configurar um novo aplicativo empresarial
  • Acesso de administrador de segurança ao Couchbase
  • Familiaridade com configurações SAML baseadas em XML
  • Usuários existentes no Azure
  • Leia o artigo anterior do blog sobre Preparando-se para o SAML.

Configuração do Microsoft Entra

Criar um aplicativo corporativo

1. 1. Faça login no Portal do Azure.
   2. Navegue até Microsoft Entra ID > Aplicativos corporativos > + Novo aplicativo.
   3. Clique em + Crie seu próprio aplicativo.
   4. Forneça um nome para seu aplicativo e selecione: Integre qualquer outro aplicativo que não esteja na galeria (não pertencente à galeria).
      
      
   5. Clique em CRIAR.

Observe: O Azure recomendará várias opções de galeria, como o Couchbase Capella. Para a edição no local, você precisará ignorar essa opção, pois ela só funciona com a nossa oferta Capella.

Configurar o logon único

1. 1. O aplicativo recém-criado será aberto e, em seguida, clique no botão Configurar o logon único.
      
      
   2. Escolha o SAML na opção Selecione uma tela de método de logon único.
      
      
   3. Abaixo de Configuração básica de SAMLVocê precisará preencher os dados a seguir:
   4. Identificador (ID da entidade): A ID da entidade de seu provedor de serviços. Para fins ilustrativos, couchbase será usado como exemplo. No entanto, sinta-se à vontade para substituí-lo por qualquer identificador de sua escolha.
   5. URL de resposta (URL do serviço de consumidor de asserção): URL para onde as asserções SAML devem ser enviadas. Vou usar um espaço reservado aqui até que a segunda parte da configuração seja concluída: https://www.mydomain.com.
      
   6. Salvar suas alterações.

Coletar informações de SAML

Colete as seguintes informações:

• • Baixar Certificaçãote (Base64)
  • Baixar Metadados da Federação XML
    
    
  • URL de login: Encontrado na Seção 4 chamada Configuração
    
    

Configuração do Couchbase como um SAML SP

Configuração do provedor de serviços

1. 1. Faça login na interface de usuário do Couchbase.
   2. Selecione Segurança na navegação do lado esquerdo:
      
   3. Clique no botão SAML na parte superior:
      
      
   4. Ativar SAML clicando na caixa de seleção.
   5. Aberto  Metadados No Configuração do provedor de serviços seção.
   6. Insira seu ID da entidade SP: (exemplo: couchbase).
   7. Selecione seu Tipo de URL de base do SP. Por exemplo URL personalizado > http://127.0.0.1:8091.
      
   8. Aberto Chave e certificados No Configuração do provedor de serviços seção.
   9. Carregar um Chave privada e um Certificado que será usado para assinar as Asserções SAML.
   10. Faça upload de quaisquer certificados intermediários (opcional) na seção Cadeia de certificados, se necessário. Eles serão passados para o IDP como metadados.
       
       

Configuração do provedor de identidade

1. 1. Aberto Metadados no Configuração do provedor de identidade seção.
   2. Clique no botão Arquivo opção em Carregar metadados do IDP de opção.
   3. Clique em Selecionar arquivo e carregue o arquivo XML de metadados que você baixou na etapa anterior.
      
      
   4. Carregue também o certificado CA que você baixou anteriormente na opção CA Certificates (Certificados CA).
      
      
   5. Aberto Logon único na seção Configurações.
   6. Certifique-se de que a opção Validar assinatura de envelope de asserção esteja desmarcada (desligada).
      
   7. Ativar Atributo de nome de usuário tratamento de reclamações, assinalando a opção Atributo de nome de usuário e preencha o seguinte nome de atributo:
      
      
      http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name in order to use the email address of the Azure user inside Couchbase as a username

      1	http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name para usar o endereço de e-mail do usuário do Azure dentro do Couchbase como um nome de usuário

      
      
   8. Certifique-se de configurar também o tratamento de reclamações de grupos e funções; os detalhes exatos disso estão fora do escopo deste guia.
   9. Clique em SALVAR.

Coletar informações de metadados do SP

Depois de salvar as configurações de SAML com êxito, a próxima etapa é rolar para cima até a parte superior da janela Configuração de SAML e colete as seguintes informações:

• • URL de consumo do SP atual: clique no Copiar URL link

Concluir a configuração do Microsoft Entra

Volte ao Azure e abra a seção Configurar logon único com SAML do aplicativo Enterprise que acabamos de criar.

1. 1. Abaixo de Configuração básica de SAMLVocê precisará alterar o seguinte:
      • URL de resposta (URL do serviço de consumidor de asserção). Cole o URL do URL de consumo do SP atual:
        
        
   2. Certifique-se de atribuir usuários a esse aplicativo. É importante que você atribua usuários no aplicativo Microsoft Entra para que possa testar um login de usuário.

Mapeamento de usuários do Entra para usuários do Couchbase Server

Depois de configurar com êxito o Microsoft Entra como seu provedor de identidade (IdP) e o Couchbase Server como provedor de serviços (SP), a próxima etapa é garantir que os atributos do usuário sejam mapeados corretamente entre eles. 

Mapeamento de usuário para usuário

A maneira mais simples de mapear usuários é criar usuários externos no Couchbase Server que correspondam aos usuários no Entra. Neste exemplo, fiz exatamente isso. 

1. 1. Encontre um e-mail no Entra: Volte ao aplicativo Microsoft Entra e encontre o endereço de e-mail de um usuário que você atribuiu a esse aplicativo. Usaremos esse usuário mais tarde para testar a integração.
   2. Abra a interface do usuário do servidor Couchbase: Abra a interface do usuário do servidor Couchbase.
   3. Clique em Segurança: À esquerda, você pode encontrar o link de segurança.
   4. Abra a guia Usuários: Na parte superior, você encontrará o Usuários e grupos clique nela para listar os usuários no Couchbase Server.
      
      
   5. Adicionar usuário: Clique no botão Adicionar usuário no canto superior direito.
   6. Usuário externo: Você precisa ter certeza de que configurou seu usuário como  Externo - consulte nossa documentação para obter mais detalhes.
   7. Preencha o nome de usuário: Você copia o endereço de e-mail da Entra nesse campo.
      
      
   8. Definir funções: No lado direito, você precisa selecionar as funções exatas que o usuário deve ter.
   9. Configurar grupos: (Opcional) Você também pode adicionar o usuário externo a qualquer grupo do Couchbase Server especificado anteriormente.

Testes

• • Abra a interface do usuário do Couchbase em uma janela anônima.
  • Observe o novo botão chamado Fazer login usando o SSO:
    
    
  • Clique em Sign In Using SSO.
  • Você será redirecionado para o Microsoft Entra para fazer login.

Parabéns! Se você seguiu este guia abrangente, agora deve ter um Single Sign-On (SSO) baseado em SAML totalmente funcional entre o Microsoft Entra e o Couchbase Server.

Percorremos as etapas essenciais para configurar essa conexão e espero que este guia seja útil para você. Se encontrar algum desafio ou tiver outras dúvidas, sinta-se à vontade para entrar em contato por meio de nossos canais de suporte.

Solução de problemas