Skip to main content

Migração do provedor de identidade do BarTender

O BarTender Cloud vai mudar de provedor de identidade em 6 de outubro de 2024

Como parte de sua próxima versão, o BarTender Cloud vai mudar de provedor de identidade, tornar a autenticação mais simples e aumentar a segurança das suas operações de etiquetagem. A mudança terá início no dia 6 de outubro de 2024.

Esse processo foi concebido para ser simples e direto. Usuários do BarTender Cloud só precisam concluir duas tarefas: 

  1. Registrar novamente a conta usando o novo URL de login da conta 
  2. Migrar todos os tokens de acesso conectados a qualquer uma das APIs do BarTender Cloud. 

Consultar as informações, a documentação técnica e os recursos abaixo para saber como se preparar melhor. 

Ações necessárias para migrar

Para administradores de nuvem do BarTender

  1. Somente na região das Américas: Em todas as integrações com o BarTender, adicione os novos endereços IP de saída. Consulte as perguntas frequentes para acessar a lista de endereços IP
  2. Limpe o cache do seu navegador  
  3. Reinstale o Print Gateway
  4. Abra o e-mail automatizado do BarTender Cloud — o assunto será: “Ação necessária: notificação atualizada do sistema de autenticação BarTender”
  5. Clique no botão "Criar senha" para redefinir sua senha (ou utilize o link fornecido abaixo do botão, formatado como https://NomeOrg.conta.am1.bartendercloud.com )
  6. Marque o novo URL de login da conta 

Para usuários do BarTender Cloud Automation 

  1. Somente na região das Américas: Em todas as integrações com o BarTender, adicione os novos endereços IP de saída. Consulte as perguntas frequentes para acessar a lista de endereços IP
  2. Limpe o cache do seu navegador 
  3. Reinstale o Print Gateway
  4. Abra o e-mail automatizado do BarTender Cloud — o assunto será: “Ação necessária: notificação atualizada do sistema de autenticação BarTender”
  5. Clique no botão Criar senha para redefinir a sua senha (ou use o link fornecido abaixo do botão que está formatado como https://NomeOrg.conta.am1.bartendercloud.com)
  6. Marque o novo URL de login da conta
  7. Migre todos os tokens de acesso adicionais (por exemplo, aplicativos da web)

Lista de verificação de migração do provedor de identidade

Aqui está tudo que você precisa para fazer a sua transição sem problemas.

  • ID de domínio da organização BarTender Cloud  
  • Atualização das credenciais de acesso  
  • Lista de aplicativos clientes impactados (web, console, servidor etc.) 
  • Lista de membros da equipe que usam o BarTender Cloud 

Documentos técnicos de migração do provedor de identidade

PERGUNTAS FREQUENTES

GERAL 

Entendemos que as considerações de segurança diferem de cliente para cliente. Ao alterar nosso provedor de identidade, seremos capazes de proporcionar mais flexibilidade e escalabilidade na segurança personalizada para os clientes do BarTender Cloud.

O BarTender Cloud vai apresentar IDs de domínio da organização para permitir o acesso a contas e APIs específicas do BarTender Cloud. Cada conta do BarTender Cloud terá um ID de domínio da organização, que será necessário para se solicitar um token de acesso para usuários e tipos de aplicativos (web, console, serviço etc.). 

Ao fazer login pela primeira vez após a migração, você receberá um e-mail do BarTender Cloud contendo sua ID de domínio da organização e o novo link de login da conta. O novo link de login estará no formato https://ORGID.conta.REGIAO.bartendercloud.com.

Caso esteja utilizando tokens de acesso adicionais para se conectar a alguma das APIs do BarTender Cloud, é necessário migrá-los antes do dia 31 de dezembro de 2024. Seus tokens atuais continuarão ativos, porém quaisquer tokens não migrados deixarão de funcionar após essa data.

Será necessário registrar novamente sua conta do BarTender Cloud. A nova ID de domínio da organização altera a URL utilizada para acessar o BarTender Cloud. 

Se você não registrar novamente sua conta, perderá completamente o acesso ao BarTender Cloud.

Após a data de migração programada para a sua região, você poderá registrar sua conta novamente. No dia da migração programada da sua região, você receberá um e-mail do BarTender Cloud contendo sua ID de domínio da organização e o novo link de login da conta. O novo link de login estará no formato https://ORGID.conta.REGIAO.bartendercloud.com

Reserve um tempo para verificar a data de migração da sua região:

  • Domingo, 6 de outubro: Ásia-Pacífico
  • Domingo, 13 de outubro: Europa, Oriente Médio, África
  • Sábado, 19 de outubro: América do Norte, América do Sul
  • 52.33.105.26
  • 54.244.69.255
  • 44.225.174.104
  • 34.217.238.27
  • 35.82.91.66
  • 44.227.20.62

No dia da migração programada para sua região, você receberá por e-mail do BarTender Cloud a sua ID de domínio da organização.

Reserve um tempo para verificar a data de migração da sua região:

  • Domingo, 6 de outubro: Ásia-Pacífico
  • Domingo, 13 de outubro: Europa, Oriente Médio, África
  • Sábado, 19 de outubro: América do Norte, América do Sul

O URL mostrado quando você acessa o BarTender Cloud pela primeira vez indica a região (data center) que a sua empresa utiliza. No momento, o BarTender Cloud está hospedado em três data centers cujos URLs utilizam prefixos regionais, conforme segue:  

  • am1.bartendercloud.com: Atende organizações hospedadas na região das Américas
  • ap1.bartendercloud.com: Atende organizações hospedadas na região da Ásia/Pacífico (APAC)
  • eu1.bartendercloud.com: Atende organizações hospedadas na região da Europa/Oriente Médio/África (EMEA)

Não se esqueça de verificar suas pastas de spam e lixo eletrônico em sua caixa de entrada de e-mail, para ter certeza de que não perdeu o e-mail. 

Caso você não consiga encontrar o e-mail do BarTender Cloud. Ainda é possível reativar sua conta utilizando a URL original do BarTender Cloud que você já utiliza, ao pesquisar sua organização e atualizar sua senha. 

Sim. O conector de impressão do Dynamics 365 Business Central passou a exigir um segredo de cliente para geração de tokens. É possível adicionar o segredo do cliente acessando a página de configuração do BarTender no Business Central e preenchendo as informações no campo Segredo do Cliente no formulário de configuração. É possível obter informações adicionais sobre como alterar o conector de impressão aqui 

Tokens de acesso comportam as credenciais de segurança de uma sessão de autenticação e identificam o usuário.  

Um token de acesso é gerado quando você faz login no BarTender Cloud e é gerenciado em seu nome durante a sessão. Ao interagir com aplicações da web que utilizam uma API do BarTender Cloud, a referida API emprega o token de acesso para identificar o usuário que está fazendo a solicitação, possibilitando que os administradores verifiquem as permissões configuradas.

O novo fornecedor de identidade preserva as mesmas tecnologias e protocolos padrão do setor que o provedor de identidade anterior enquanto possibilita novas funcionalidades para:

  • Usar endereços de e-mail individuais em várias organizações 
  • Simplificar o acesso por meio do login federado suportado pelo Google
  • Restringir o acesso a determinados aplicativos para impedir o uso de programas não autorizados pela sua equipe

A versão mais atual do BarTender Cloud traz os seguintes recursos e melhorias: 

  • Novas configurações de controle avançadas para facilitar o gerenciamento da impressora, com permissões de usuário no nível da impressora, agrupamentos de impressoras e configurações baseadas em funções
  • Recursos melhorados no histórico de trabalhos de impressão, possibilitando que os usuários pesquisem tiragens passadas com base em critérios específicos e exportem registros detalhados das atividades da impressora 
  • Novas funcionalidades de reimpressão, possibilitando que os usuários reimprimam arquivos individuais com registros completos de todos os trabalhos reimpressos
  • A interface do usuário do assistente de modelo foi atualizada, inclusive uma nova visualização de dados incorporados, para permitir inserção e importação de vários registros simultaneamente 
  • Suporte recém-adicionado para fontes de dados MySQL — Azure DB e Amazon RDS

Não, será necessário sair do espaço de inquilino do BarTender Cloud atual e fazer login no novo espaço de inquilino do BarTender Cloud que você deseja acessar

Para receber assistência técnica durante ou após a migração do seu provedor de identidade, acesse o Centro de Suporte e entre em contato com nossa equipe de suporte técnico.

APLICATIVOS

Sim. Caso esteja utilizando tokens de acesso adicionais para se conectar a alguma das APIs do BarTender Cloud, é necessário migrá-los antes do dia 31 de dezembro de 2024. Seus tokens atuais continuarão ativos, porém quaisquer tokens não migrados deixarão de funcionar após essa data. 

A maioria dos aplicativos clientes não deve necessitar de recriações de aplicativos. No entanto, dependendo de como você implementar, pode ser que algumas pequenas alterações sejam necessárias para que o seu aplicativo solicite um token de acesso.

Para ter referência, consulte o exemplo de artigo recente sobre aplicativos web e aprenda a criar um aplicativo que seja compatível com o BarTender Cloud. Abaixo está um resumo das mudanças: 

  1. O escopo "user:query" não vai funcionar com o novo fornecedor de identidade e precisa ser tirado. Se for incluído no login, vai causar um erro.
  2. Durante o fluxo de login, é possível enviar uma ID de domínio fixo da organização para ignorar a solicitação da organização.
  3. O manipulador OnRedirectToIdentityProviderForSignOut foi levemente modificado com alteração do nome do parâmetro de consulta utilizado para enviar o local de redirecionamento de logout. 

Para obter mais informações, consulte o exemplo de artigo atualizado sobre o aplicativo de console para aprender a criar um aplicativo compatível com o BarTender Cloud. Abaixo está um resumo das mudanças: 

  1. O escopo "user:query" não vai funcionar com o novo fornecedor de identidade e precisa ser tirado. Se for incluído no login, vai causar um erro.
  2. Como qualquer endereço de e-mail pode ser utilizado em diversas organizações, as solicitações de token precisam conter a ID de domínio da organização de destino 

Caso você esteja utilizando a abordagem de documento de descoberta do OIDC, seu aplicativo permanecerá funcional até que o token de acesso vigente que está sendo utilizado expire. 

A falha ocorrerá quando o aplicativo tentar obter um novo token de acesso, pois o escopo “user:query” continua sendo fornecido, e a amostra anterior de autenticação por meio de senha não contemplava o parâmetro de consulta “organizationDNSName”, o qual agora se faz necessário, conforme descrito anteriormente neste documento.