Configurar o login com Microsoft (SSO)
Caminho: Opa! Store → Microsoft → Instalar
Visão geral
O app Microsoft permite que os usuários entrem no Opa! Suite com a conta Microsoft, sem digitar a senha do Opa! Suite. Esse tipo de acesso é chamado de login único, ou SSO (Single Sign-On). Ele funciona com o Microsoft Entra ID (antigo Azure AD) e, se você quiser, com contas Microsoft pessoais.
O Opa! Suite identifica o usuário pelo endereço de e-mail da conta Microsoft: ele precisa ser o mesmo e-mail cadastrado para o usuário no Opa! Suite.
Pré-requisitos
- Permissão para visualizar o Opa! Store no seu grupo de permissões.
- Acesso ao Microsoft Entra admin center com permissão para registrar aplicativos.
- Usuários cadastrados e ativos no Opa! Suite, com o mesmo e-mail das contas Microsoft. O login com Microsoft não cria usuários.
- Nenhum outro app de SSO instalado. O Opa! Suite aceita um app de SSO por vez.
Passo a passo
1. Registrar o aplicativo no Microsoft Entra
- No Microsoft Entra admin center, acesse Entra ID → App registrations e clique em New registration.
- Dê um Name ao aplicativo (ex.: "Opa! Suite").
- Em Supported account types, escolha quem poderá usar o aplicativo. A escolha precisa ser compatível com a Preferência de acesso que você vai definir no Opa! Suite (veja a tabela no passo 2).
- Clique em Register. Na página Overview, copie o Application (client) ID. Se for usar a opção Customizado no Opa! Suite, copie também o Directory (tenant) ID.
- Em Authentication, clique em Add Redirect URI, escolha a plataforma Web e informe o endereço abaixo, trocando pelo endereço do seu Opa! Suite:
https://endereco-do-seu-opa-suite/auth/login/sso/callback/microsoft - Em Certificates & secrets → Client secrets, clique em New client secret, escolha a validade e clique em Add.
- Copie o Value do segredo. A Microsoft não mostra esse valor de novo depois que você sai da página.
As instruções completas estão em Registrar um aplicativo no Microsoft Entra ID e Adicionar credenciais ao aplicativo.
A Microsoft limita a validade do segredo a no máximo 24 meses. Quando ele expira, o login com Microsoft para de funcionar. Anote a data e cadastre um novo segredo no Opa! Suite antes do vencimento.
2. Instalar o app no Opa! Suite
- Acesse Opa! Store e abra o app Microsoft, na categoria SSO.
- Clique em Instalar. A janela de instalação abre.
- Preencha os campos:
- ID do cliente: o Application (client) ID.
- Chave secreta do cliente: o Value do segredo.
- Preferência de acesso: quais contas Microsoft podem entrar, conforme a tabela abaixo.
- Domínio ou Tenant ID: aparece só na opção Customizado. Informe o domínio da empresa no Microsoft Entra ou o Directory (tenant) ID.
- Clique em Instalar.
| Preferência de acesso | Quem pode entrar |
|---|---|
| Todos os e-mails Microsoft | Contas corporativas (Microsoft Entra ID) e contas Microsoft pessoais. |
| Somente e-mails corporativos | Só contas corporativas do Microsoft Entra ID. |
| Somente e-mails pessoais | Só contas Microsoft pessoais. |
| Customizado | Só contas do diretório (tenant) informado em Domínio ou Tenant ID. |
Resultado esperado
O app aparece como instalado e o Opa! Suite abre a tela de ajustes, com a seção Dados de integração.
Na tela de login do Opa! Suite passa a aparecer, abaixo de Entrar, o texto ou entre com e o botão Microsoft. Ao clicar, o usuário é levado para o login da Microsoft e, depois de autenticado, volta ao Opa! Suite já conectado.
O login com Microsoft segue as mesmas regras de segurança do login comum:
- Se o usuário tiver autenticação em dois fatores configurada, o código é pedido depois do login na Microsoft.
- O limite de usuários conectados ao mesmo tempo continua valendo.
- Se houver restrição de acesso por IP, ela também vale para o login com Microsoft.
Configurações disponíveis
Para alterar, acesse Opa! Store → Microsoft → Acessar e edite Dados de integração.
| Campo | O que faz |
|---|---|
| Client ID | Identificador do aplicativo registrado no Microsoft Entra. |
| Client Secret | Segredo do aplicativo. Aparece mascarado. |
| Preferência de acesso | Quais contas Microsoft podem entrar. |
| Domínio ou Tenant ID | Diretório permitido, na opção Customizado. |
Para remover o login com Microsoft, clique em Desinstalar App e confirme em Desinstalar.
Problemas comuns
| Sintoma ou mensagem | O que verificar |
|---|---|
| "Seu usuário não foi encontrado. Entre em contato com um administrador do sistema." | Não existe usuário ativo no Opa! Suite com o mesmo e-mail da conta Microsoft. Confira o e-mail em Usuários e o e-mail da conta no Microsoft Entra. |
| "Houve um erro ao coletar os dados do seu usuário. Tente novamente mais tarde." | A Microsoft recusou a troca de dados. Confira o ID do cliente e se o segredo ainda está válido. |
| A Microsoft mostra erro de URI de redirecionamento | A URI cadastrada no Microsoft Entra precisa ser exatamente igual à do Opa! Suite. |
| A Microsoft não aceita a conta | A conta não se encaixa na Preferência de acesso ou no Supported account types do aplicativo. |
| "Quantidade de usuários ultrapassou o limite contratado!" | O limite de usuários conectados ao mesmo tempo foi atingido. |
| A página do app mostra "Um app desta categoria já está instalado" | Já existe outro app de SSO instalado. Desinstale-o antes de instalar o Microsoft. |
Boas práticas
- Prefira Somente e-mails corporativos ou Customizado quando a empresa usa o Microsoft Entra ID, para evitar acesso com contas pessoais.
- Antes de divulgar o login com Microsoft, confira se o e-mail de cada usuário no Opa! Suite é o mesmo da conta Microsoft.
- Programe a troca do segredo do cliente antes da data de validade.