Compartilhar via


Configurar o Braze para logon único com a ID do Microsoft Entra

Neste artigo, você aprenderá a integrar o Braze à ID do Microsoft Entra. Ao integrar o Braze à ID do Microsoft Entra, você pode:

  • Controlar no Microsoft Entra ID quem tem acesso ao Braze.
  • Permitir que os usuários sejam conectados automaticamente ao Braze com suas contas do Microsoft Entra.
  • Gerencie suas contas em um local central.

Pré-requisitos

O cenário descrito neste artigo pressupõe que você já tenha os seguintes pré-requisitos:

  • Assinatura habilitada para SSO (logon único) do Braze.

Descrição do cenário

Neste artigo, você configurará e testará o SSO do Microsoft Entra em um ambiente de teste.

  • Braze dá suporte ao SSO iniciado por SP e IDP.

Nota

O identificador desse aplicativo é um valor de cadeia de caracteres fixo para que apenas uma instância possa ser configurada em um locatário.

Para configurar a integração do Braze ao Microsoft Entra ID, você precisa adicionar o Braze por meio 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é Entrar ID>Aplicativos empresariais>Novo aplicativo.
  3. Na seção Adicionar por meio da galeria , digite Braze na caixa de pesquisa.
  4. Selecione Braze 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 Aplicativos Empresariais. Neste assistente, você pode adicionar um aplicativo ao seu locatário, adicionar usuários/grupos ao aplicativo, atribuir funções e também percorrer a configuração de SSO. Saiba mais sobre os assistentes do Microsoft 365.

Configurar e testar o SSO do Microsoft Entra para Braze

Configure e teste o SSO do Microsoft Entra com o Braze usando um usuário de teste chamado B.Simon. Para que o SSO funcione, é necessário estabelecer uma relação de vínculo entre um usuário do Microsoft Entra e o usuário relacionado do Braze.

Para configurar e testar o SSO do Microsoft Entra com o Braze, execute as seguintes etapas:

  1. Configure o SSO do Microsoft Entra para permitir que os usuários usem esse recurso.
    1. Crie um usuário de teste do Microsoft Entra para testar o logon único do Microsoft Entra com B.Simon.
    2. Atribuir o usuário de teste do Microsoft Entra - para permitir que B.Simon use o logon único do Microsoft Entra.
  2. Configure o SSO do Braze – para definir as configurações de logon único no lado do aplicativo.
    1. Crie um usuário de teste do Braze para ter um equivalente de B.Simon no Braze que esteja vinculado à representação do usuário do Microsoft Entra.
  3. 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.

  1. Entre no Centro de administração do Microsoft Entra como pelo menos um Administrador de Aplicativos na Nuvem.

  2. Navegue até Entra ID>Aplicativos empresariais>Braze>Single Sign-On.

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

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

    Editar Configuração Básica do SAML

  5. Na seção Configuração Básica do SAML , se você quiser configurar o aplicativo no modo iniciado pelo IDP , execute a seguinte etapa:

    Na caixa de texto URL de Resposta , digite uma URL usando o seguinte padrão: https://<SUBDOMAIN>.braze.com/auth/saml/callback

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

    Na caixa de texto URL de logon, digite uma URL usando o seguinte padrão: https://<SUBDOMAIN>.braze.com/sign_in

    Nota

    Para o subdomínio, use o subdomínio de coordenação listado em sua URL da instância do Braze. Por exemplo, se sua instância for US-01, sua URL será https://dashboard-01.braze.com. Isso significa que seu subdomínio é dashboard-01.

  7. O aplicativo Braze espera as declarações SAML em um formato específico, o que exige que você adicione mapeamentos de atributo personalizados à configuração de atributos do token SAML. A captura de tela a seguir mostra a lista de atributos padrão.

    image

  8. Além do indicado acima, o aplicativo Braze espera que mais alguns atributos sejam passados novamente na resposta SAML, que são mostrados abaixo. Esses atributos também são pré-preenchidos, mas você pode revisá-los de acordo com seus requisitos.

    Nome Atributo de origem
    email user.userprincipalname
    primeiro_nome user.givenname
    sobrenome user.surname
  9. Na página Configurar logon único com SAML , na seção Certificado de Autenticação SAML , localize o Certificado (Base64) e selecione Baixar para baixar o certificado e salvá-lo no computador.

    O link de download do Certificado

  10. Na seção Configurar o Braze , copie as URLs apropriadas de acordo com suas necessidades.

    Copiar URLs de configuração

Criar e atribuir um usuário de teste do Microsoft Entra

Siga as diretrizes na instrução rápida criar e atribuir uma conta de usuário para criar uma conta de usuário de teste chamada B.Simon.

Configurar o SSO do Braze

Para configurar o logon único no lado do Braze, você precisa garantir que um Gerente de Contas do Braze habilitou o SAML SSO para sua conta. Depois de ativado, você pode ir para Configurações da Empresa > Configurações de Segurança e ativar a seção SAML SSO. Nesta seção, você precisa copiar e colar o certificado baixado (Base64) juntamente com a adição de um Nome SAML.

Criar um usuário de teste do Braze

Nesta seção, você criará um usuário chamado B.Simon no Braze. Trabalhe com a equipe de suporte do Braze para adicionar os usuários à plataforma Braze. Os usuários devem ser criados e ativados antes de usar o logon único.

Testar SSO

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

Iniciado por SP:

  • Selecione Testar este aplicativo, essa opção redireciona para a URL de Logon do Braze, na qual você pode iniciar o fluxo de logon.

  • Acesse diretamente a URL de Logon do Braze e inicie o fluxo de logon nela.

Iniciado por IdP:

  • Selecione Testar este aplicativo e você deverá ser conectado automaticamente ao Braze para o qual configurou o SSO.

Você também pode usar o Microsoft My Apps para testar o aplicativo em qualquer modo. Ao selecionar o bloco do Braze em Meus Aplicativos, se ele estiver configurado no modo SP, você será redirecionado para a página de logon do aplicativo para iniciar o fluxo de logon e, se ele estiver configurado no modo IDP, você será conectado automaticamente ao Braze para o qual configurou o SSO. Para obter mais informações, consulte Microsoft Entra My Apps.

Depois de configurar o Braze, você poderá impor o controle de sessão, que protege contra exfiltração e 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 controle de sessão com o Microsoft Cloud App Security.