Ir para o conteúdo

Provisionamento automatizado de usuários

O provisionamento automatizado de usuários permite criar e gerenciar usuários da Braze por meio de uma API, em vez de fazer isso manualmente no dashboard. A Braze oferece suporte a isso por meio do System for Cross-domain Identity Management (SCIM). Este artigo orienta você sobre quais informações fornecer, como gerar seu token SCIM e onde encontrar seu endpoint da API SCIM.

Acessar as configurações de provisionamento SCIM

  1. No dashboard da Braze, acesse Configurações > Configurações da empresa > Configurações de administrador > Provisionamento SCIM e selecione Configurar integração SCIM.
  2. Na etapa Configuração da Braze, selecione um método de provisionamento e informe as configurações de acesso.

Página para configurar a integração SCIM, com seções para selecionar um método de provisionamento e informar as configurações de acesso.

  1. Na etapa Configuração do IdP, siga as etapas na plataforma do método de provisionamento selecionado.

Use a opção Okta - Braze app se você configurou o app da Braze para SAML SSO no Okta. Se você configurou um app personalizado para SSO, siga as instruções da guia Okta - Custom app integration.

Etapa 1: Configurar o provisionamento SCIM

Etapa 1.1: Ativar o SCIM

  1. No Okta, acesse Applications > Applications e selecione Create App Integration. Selecione SAML 2.0 como método de login.
  2. Preencha os detalhes a seguir (disponíveis na etapa Configuração do IdP da Braze) para criar um app personalizado:
    • Logo do app
    • URL de single sign-on
    • URL do público (ID da entidade SP)
  3. Selecione Finish.
  4. Selecione a guia General.
  5. Na seção App Settings, selecione Edit.
  6. No campo Provisioning, selecione SCIM.

Etapa 1.2: Desativar a visibilidade do aplicativo

  1. No campo Application visibility, marque a caixa de seleção Do not display application icon to user. Isso impede que os usuários acessem o SSO pelo app, que se destina apenas ao SCIM.
  2. Selecione Save.

Etapa 1.3: Configurar a integração SCIM

  1. Selecione a guia Provisioning.
  2. Em Settings > Integration > SCIM Connection, selecione Edit e preencha os valores dos campos que aparecem na tabela da página Configurar provisionamento SCIM.

Etapa 1.4: Testar as credenciais da API

Selecione Test API Credentials. Se a integração funcionar, uma mensagem de verificação será exibida e você poderá salvar.

Etapa 1.5: Ativar o provisionamento para o app

  1. Em Provisioning > Settings > To App > Provisioning to App, selecione Edit.
  2. Ative as seguintes opções:
    • Create Users
    • Update Users Attributes
    • Deactivate Users
  3. Revise e configure a seção Attribute Mapping com os mapeamentos que aparecem na tabela da página Configurar provisionamento SCIM.

Etapa 2: Atribuir usuários ao app

  1. Selecione a guia Assignment.
  2. Selecione Assign e escolha uma opção.
  3. Atribua o app às pessoas que devem ter acesso à Braze.
  4. Selecione Done quando concluir a atribuição.

Use a opção Okta - Custom app integration se você configurou um app personalizado para SSO. Se você configurou o app da Braze para SAML SSO no Okta, siga as instruções da guia Okta - Braze app.

Etapa 1: Configurar o provisionamento SCIM

Etapa 1.1: Ativar o SCIM

  1. No Okta, acesse o app da Braze.
  2. Selecione a guia General.
  3. Na seção App Settings, selecione Edit.
  4. No campo Provisioning, selecione SCIM.
  5. Selecione Save.

Etapa 1.2: Configurar a integração SCIM

  1. Selecione a guia Provisioning.
  2. Em Settings > Integration > SCIM Connection, selecione Edit e preencha os valores dos campos que aparecem na tabela da página Configurar provisionamento SCIM.
  3. Teste as credenciais da API selecionando Test API Credentials.
  4. Selecione Save.

Etapa 1.3: Ativar o provisionamento para o app

  1. Em Provisioning > Settings > To App > Provisioning to App, selecione Edit.
  2. Ative as seguintes opções:
    • Create Users
    • Update Users Attributes
    • Deactivate Users
  3. Revise e configure a seção Attribute Mapping com os mapeamentos que aparecem na tabela da página Configurar provisionamento SCIM.

Etapa 2: Atribuir usuários ao app

  1. Selecione a guia Assignment.
  2. Selecione Assign e escolha uma opção.
  3. Atribua o app às pessoas que devem ter acesso à Braze.
  4. Selecione Done.

Etapa 1: Configurar o app de provisionamento SCIM

Etapa 1.1: Fazer login no Microsoft Entra admin center

Faça login no seu Microsoft Entra admin center.

Etapa 1.2: Criar e configurar o app SCIM

  1. No menu de navegação, acesse Entra ID > Enterprise apps.
  2. Selecione New application.
  3. Selecione Create your own application.
  4. No painel, insira um nome para o app.
  5. Na seção What are you looking to do with your application?, selecione Integrate application you don’t find in the gallery (Non-gallery).
  6. Selecione Create.

Etapa 1.3: Configurar a integração SCIM

  1. Acesse a seção Manage > Provisioning do seu aplicativo SCIM.
  2. Selecione Connect your application ou New configuration e preencha os valores dos campos que aparecem na tabela da página Configurar provisionamento SCIM.

Etapa 1.4: Ativar o provisionamento para o app

  1. Acesse a seção Manage > Attribute mapping (Preview) do seu aplicativo SCIM.
  2. Selecione Provision Microsoft Entra ID Users.
  3. Revise e configure a seção Attribute Mapping para corresponder aos atributos que aparecem na tabela da página Configurar provisionamento SCIM.
  4. Feche a página Attribute Mapping.

Etapa 2: Atribuir usuários ao app

  1. Acesse Manage > Users and Groups.
  2. Selecione Add user/group.
  3. Selecione None Selected para atribuir usuários ao app.
  4. Selecione o botão Select para confirmar a atribuição.

Etapa 1: Definir as configurações do SCIM

  • Espaço de trabalho padrão: Selecione o espaço de trabalho ao qual novos usuários devem ser adicionados por padrão. Se você não especificar um espaço de trabalho na sua solicitação da API SCIM, a Braze atribuirá os usuários a esse espaço de trabalho.
  • Service Origin: Insira o domínio de origem das suas solicitações SCIM. A Braze usa esse valor no cabeçalho X-Request-Origin para verificar de onde vêm as solicitações.
  • Lista de permissões de IP (opcional): Você pode restringir as solicitações SCIM a endereços IP específicos. Insira uma lista separada por vírgulas ou um intervalo de endereços IP permitidos. O cabeçalho X-Request-Origin de cada solicitação é usado para comparar o endereço IP da solicitação com a lista de permissões.

Etapa 2: Gerar um token SCIM

Depois de preencher os campos obrigatórios, clique em Gerar token SCIM para gerar um token SCIM e ver seu endpoint da API SCIM. Copie o token SCIM antes de sair da página. Esse token aparece apenas uma vez.

Campos de endpoint da API SCIM e token SCIM exibidos com valores mascarados e botões de cópia. Abaixo do campo do token há um botão "Redefinir token".

A Braze espera que todas as solicitações SCIM contenham o bearer token da API SCIM anexado por meio de um cabeçalho HTTP Authorization.

Documentação da plataforma de engajamento do cliente Braze.

Recursos
Jurídico
Empresa
© 2026 Braze, Inc. Todos os direitos reservados.
Verificando o status do Braze
New Stuff!