Login iniciado pelo prestador de serviço (SP)
Este artigo irá guiá-lo sobre como ativar o logon único SAML para sua conta Braze e como obter um rastreamento SAML.
Solicitações
Após a configuração, solicitaremos que você forneça uma URL de login e um URL do Assertion Consumer Service (ACS).
Requisito | Informações |
---|---|
URL do serviço de consumidor de asserção (ACS) | https://<SUBDOMAIN>.braze.com/auth/saml/callback Para domínios da União Europeia, o URL do ASC é https://<SUBDOMAIN>.braze.eu/auth/saml/callback . Para alguns IdPs, isso também pode ser chamado de URL de resposta, URL de login, URL do público ou URI do público. |
ID da entidade | braze_dashboard |
Chave de API do RelayState | Acesse Configurações > Chaves de API ) e crie uma chave de API com permissões sso.saml.login e, em seguida, insira a chave de API gerada como o parâmetro RelayState em seu IdP. |
Se você estiver usando a navegação mais antiga, você pode encontrar suas chaves API em Configurações na console de desenvolvedor > Configurações de API.
Configurando SSO SAML
Etapa 1: Configure seu provedor de identidade
Configure o Braze como um prestador de serviço (SP) em seu provedor de identidade (IdP) com as seguintes informações. Além disso, configure o mapeamento de atribuições SAML.
Se planeja usar o Okta como provedor de identidade, use a integração pré-construída encontrada no site do Okta.
Atributo SAML | Necessário? | Atribuições SAML aceitas |
---|---|---|
email |
Obrigatória | email mail http://schemas.xmlsoap.org/ws/2005/05/identity/claims/email |
first_name |
Opcional | first_name firstname firstName http://schemas.xmlsoap.org/ws/2005/05/identity/claims/first_name |
last_name |
Opcional | last_name lastname lastName http://schemas.xmlsoap.org/ws/2005/05/identity/claims/last_name |
A Braze requer apenas o endereço email
na declaração SAML.
Etapa 2: Configurar o Braze
Quando terminar de configurar a Braze em seu provedor de identidade, ele fornecerá um URL de direcionamento e um certificado x.509
para inserir em sua conta Braze.
Depois que o gerente da conta ativar o SAML SSO para a sua conta, acesse Configurações > Configurações administrativas > Configurações de segurança e alterne a seção SAML SSO para ATIVADO.
Se você estiver usando a navegação mais antiga, selecione o ícone da sua conta e acesse Configurações da Empresa > Configurações de Segurança para encontrar a seção SAML SSO.
Na mesma página, insira o seguinte:
Requisito | Informações |
---|---|
SAML Name |
Isso aparecerá como o texto do botão na tela de login. Normalmente, esse é o nome de seu provedor de identidade, como “Okta”. |
Target URL |
Isso acontecerá após a configuração da Braze em seu IdP. Alguns IdPs fazem referência a isso como URL de SSO ou endpoint SAML 2.0. |
Certificate |
O certificado x.509 que é fornecido por seu provedor de identidade. |
Confira se o seu certificado x.509
segue esse formato ao adicioná-lo ao dashboard:
1
2
3
-----BEGIN CERTIFICATE-----
<certificate>
-----END CERTIFICATE-----
Etapa 3: Faça login no Braze
Salve suas configurações de segurança e faça o registro. Em seguida, faça login novamente com seu provedor de identidade.
Comportamento de SSO
Os membros que aceitarem usar o SSO não poderão mais usar sua senha como faziam antes. Os usuários que continuarem a usar sua senha poderão, a menos que sejam restringidos pelas seguintes configurações.
Restrição
Você pode restringir os membros de sua organização para que façam login apenas com o Google SSO ou o SAML SSO. Para ativar as restrições, acesse Security Settings e selecione Enforce Google SSO only login ou Enforce custom SAML SSO only login.
Ao ativar as restrições, os usuários do Braze da sua empresa não poderão mais se registrar usando uma senha, mesmo que já tenham se registrado com uma senha anteriormente.
Obtendo um rastreamento SAML
Se você tiver problemas de login relacionados ao SSO, obter um rastreamento SAML pode ajudá-lo a solucionar sua conexão SSO, identificando o que é enviado nas solicitações SAML.
Pré-requisitos
Para executar um rastreamento SAML, você precisará de um rastreador SAML. Aqui estão duas opções possíveis com base no seu navegador:
Etapa 1: Abra o rastreador SAML
Selecione o rastreador SAML na barra de navegação do seu navegador. Certifique-se de que a opção Pausar não esteja selecionada, pois isso impedirá que o rastreador SAML capture o que é enviado nas solicitações SAML. Quando o rastreador SAML está aberto, você verá ele preencher o rastreio.
Etapa 2: Faça login no Braze usando SSO
Acessar seu dashboard Braze e tentar fazer login usando SSO. Se você encontrar um erro, abra o rastreador SAML e tente novamente. Um rastreamento SAML foi coletado com sucesso se houver uma linha com uma URL como https://dashboard-XX.braze.com/auth/saml/callback
e uma tag SAML laranja.
Etapa 3: Exportar e enviar para Braze
Selecionar Exportar. Para Selecionar o perfil de filtro de cookies, selecione Nenhum. Em seguida, selecione Exportar. Isso gerará um arquivo JSON que você pode enviar para o suporte da Braze para mais solução de problemas.