Microsoft Authentication – Citrus.cx https://hml-docs.citrus.cx Base de Conhecimento Thu, 23 Oct 2025 22:27:55 +0000 pt-BR hourly 1 https://wordpress.org/?v=6.9.4 https://hml-docs.citrus.cx/wp-content/uploads/2023/08/cropped-doc-citrus_LOGO-FAVICON-1-32x32.png Microsoft Authentication – Citrus.cx https://hml-docs.citrus.cx 32 32 Login com conta corporativa Microsoft https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/login-com-conta-corporativa-microsoft/ https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/login-com-conta-corporativa-microsoft/#respond Tue, 29 Apr 2025 02:58:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/login-com-conta-corporativa-microsoft/

A autenticação na plataforma Citrus com credenciais de conta corporativa da Microsoft respeita algumas regras. 

Quando critérios de pré-requisitos não são cumpridos, alertas são mostrados na tela para notificar o usuário sobre o motivo de falha na tentativa de login. 

A seguir são apresentadas demonstrações sobre o funcionamento do login com conta da Microsoft: 

Tela de login Citrus com a opção Entrar com Microsoft

A opção Entrar com Microsoft só é exibida na tela de login quando existe cadastro ativo do Provedor de Identidade no Citrus. 

Consulte Integração com Provedor de Identidade

No momento que um usuário clicar no botão Entrar com Microsoft, o painel de login on–line da Microsoft será carregado na tela, e permitirá selecionar ou inserir o endereço de e-mail. 

Antes do acesso ao Citrus ser permitido, ou não, será realizada verificação para confirmar se o e-mail informado existe no Banco de Dados do Citrus. 

Caso este pré-requisito seja atendido, o login será concluído com sucesso. 

Se algum critério não for respeitado, alertas serão carregados na tela. Confira: 

1. Fechar tela de login on-line da Microsoft

Quando o usuário clicar em Entrar com Microsoft e fechar a tela de login on-line da Microsoft, verá a notificação de falha no login e será orientado a tentar novamente. 

2. Conta de e-mail não encontrada

Se a conta não for encontrada, o alerta de “e-mail não cadastrado no sistema” será carregado na tela. 

Recuperação de senha com conta Microsoft

Quando um usuário de ambiente que utiliza Microsoft como Provedor de Identidade não lembrar suas credenciais de acesso poderá clicar em “Esqueceu sua senha?” na tela de login. 

Ao fazer isso, uma mensagem na tela informará que precisa entrar em contato com o Administrador da conta Microsoft na sua organização.

Confira também Autenticação de e-mail Microsoft Office 365

]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/login-com-conta-corporativa-microsoft/feed/ 0 Integração com Provedor de Identidade https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/ https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/#respond Tue, 29 Apr 2025 01:28:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/

Visão Geral

A integração com Provedores de Identidade (inicialmente Microsoft), pode ser configurada por Administrador para que usuários acessem a plataforma Citrus com as mesmas credenciais de conta corporativa do provedor. 

Pré-requisitos e Permissões

Para configurar e utilizar a integração é necessário:  

 

Configuração 

  • Ter perfil de Administrador na plataforma Citrus. 
  • Ter uma conta no Provedor de Identidade que será integrado. 

 

Utilização 

  • Possuir Integração com Provedor de Identidade ativa na plataforma Citrus. 

Integração com Provedor de Identidade Microsoft

  1. Na plataforma Citrus acesse os menus Administração > Usuários > Provedor de Identidade.
  2. Em “Tipos de Provedores” selecione o que será usado na integração.

    *Neste momento, a integração está disponível para Microsoft Entra ID (Azure), que já aparecerá selecionado no campo.

  3. Marque a caixa de seleção de “Ativo” para habilitar a integração.

    * É possível configurar a integração e só habilitá-la posteriormente. Basta deixar a opção desmarcada.

  4. Preencha os demais campos do cadastro, como a seguir:

    • Client Id: É o identificador único e público de um aplicativo registrado no Azure Active Directory.

    O valor do ID do aplicativo é exibido após o registro no Azure. Serve para o Citrus saber qual aplicação registrada no Azure está tentando autenticar os usuários.

    Exemplo:: 311b2d83-a22e-4040-8953-133a79f7619c


    • Client Secret: Senha secreta gerada para o aplicativo no Azure. Usada junto com o Client ID para autenticação segura.

    Exemplo: 30L8Q~DBED1FLPMu.xJU2W9kQUFJB9rwANcYZcYH


    • Tenant Id: Identifica o ID do Locatário ou diretório do Azure AD (empresa/organização).

    No Citrus, para Microsoft, por padrão o campo é autopreenchido com o valor fixo "organizations" porque apenas conta organizacional (e-mail empresarial) é permitida.


    • Callback URL: Endereço para o qual a Microsoft irá redirecionar o usuário após ele realizar o login com sucesso, durante o processo de autenticação.

    Exemplo: https://app.sistemax.com/auth/callback


    Após o login, a Microsoft redirecionará o usuário autenticado de volta para esse endereço. Esse endpoint é onde o Citrus:

    - Receberá o código de autorização.

    - Trocará o código por um token de acesso.

    - Validará o login e autenticará o usuário na plataforma.


    Outros exemplos comuns:

    https://plataforma.empresa.com.br/login/oauth2/callback

    https://meusistema.com/callback

    https://portal.organizacao.net/oauth2/redirect


    IMPORTANTE

    IMPORTANTE

    O Callback URL precisa ser exatamente o mesmo que foi cadastrado na configuração do aplicativo no portal da Microsoft Azure, ou a autenticação falhará com erro de segurança.

  5. Pressione Salvar no topo direito da tela para concluir a configuração da integração. Ou, Cancelar, caso desista de registrar.

A Integração com Provedor de Identidade respeita as seguintes regras de funcionamento: 

Quando a integração estiver habilitada 

  • Todos os campos de preenchimento se tornam obrigatórios. 
  • O sistema bloqueia o salvamento caso algum campo esteja vazio. 

Quando a integração estiver desabilitada 

  • Os campos podem ficar vazios. 
  • Não será exigido nenhum preenchimento. 

Registrar aplicativo e obter dados no Azure

  1. Acessar o portal Azure .
  2. Registrar aplicativo: No menu da lateral esquerda clique em Azure Active Directory > Registros de aplicativos e pressione Novo registro.

    Preencha os campos:

    • Nome: Escolha um nome para identificar a integração (ex.: Login Citrus)

    •Tipos de conta compatíveis: Selecione "Contas em qualquer diretório organizacional (qualquer diretório do Azure AD) e contas pessoais da Microsoft".

    • URI de Redirecionamento: (opcional nessa etapa, pode ser ajustado depois).

  3. Obter Client ID para a integração no Citrus:

    - Acesse o portal Azure com suas credenciais corporativas.

    - No menu lateral, clique em Azure Active Directory, depois em App registrations.

    - Selecione o aplicativo desejado na lista de App registrations.

    - Na aba Overview, localize o campo "Application (client) ID". Este é o valor do seu Client ID.

  4. Gerar o Client Secret:

    - No aplicativo registrado acesse Certificados e segredos e em Segredos do cliente clique em “+ Novo segredo de cliente”.

    - Digite uma descrição (Ex: “Login Citrus”) e defina um período de expiração (6, 12 ou 24 meses).

    - Pressione Adicionar.

    - Copie imediatamente o valor do segredo gerado (o campo “Valor”, não o Secret ID). Este é o Client Secret a ser inserido no Citrus.


Confira também Autenticação de e-mail Microsoft Office 365

Informações reunidas nesta documentação

]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/feed/ 0 Versão 2.109.30 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-30/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-30/#respond Mon, 28 Apr 2025 13:09:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-30/
NOVIDADES

Administração: Criada tela para cadastro de integração com Provedores de Identidade

A configuração pode ser feita no menu Administração > Usuários > Provedor de Identidade, por usuário com perfil de Administrador.

Inicialmente, a integração está disponível para Microsoft Azure.

Confira o passo a passo no Guia Integração com Provedor de Identidade

Login: Implementado login com credenciais de conta da Microsoft

Quando a Microsoft estiver habilitada como Provedor de Identidade,  

usuários do ambiente corporativo associados à integração poderão acessar a plataforma Citrus com suas credenciais de e-mail Microsoft.  

O login segue alguns critérios, descritos no Guia Login com Conta Microsoft. 

MELHORIA

Administração: Configuração de Autoatendimento de voz no Citrus terá prioridade sobre configuração individual de Atendente

Quando o Administrador no Citrus marcar a opção “Permitir o autoatendimento de voz”, no menu Administração > LemonDesk > Configurações de atendimento, essa definição prevalecerá sobre a configuração individual do cadastro do Atendente. Ou seja, não será considerada a configuração herdada da associação do usuário no Citrus com um usuário da plataforma Smartspace Manager (Administração > Usuários > Associação com usuário do Unity).

Assim, mesmo se o usuário na Smartspace Manager não estiver com Autoatendimento habilitado (Smartspace Manager > Metrics > Opções de agentes > Autoatendimento), chamadas poderão ser automaticamente atendidas no Citrus, sem o Atendente precisar clicar em Aceitar. 

Caso o Administrador não habilite a permissão de autoatendimento no Citrus, o autoatendimento seguirá condicionado à configuração herdada do cadastro do usuário na Smartspace Manager. Essa configuração pode ser observada ao abrir o cadastro do Atendente no Citrus (Administração > Usuários > Usuário > Cadastro do Atendente), pela flag “Permitir o autoatendimento de voz”. 

A flag não é editável, mas sinaliza se o Autoatendimento está, ou não, habilitado no cadastro do Atendente associado à Smartspace Manager. Em caso afirmativo o autoatendimento será executado para o Atendente no Citrus. Caso contrário, para atender uma ligação o Atendente precisará clicar em Aceitar no card de voz. 

Na demonstração é possível ver que o cadastro do Atendente no Citrus não tem Autoatendimento habilitado herdado da Smartspace Manager. Mas, o Autoatendimento está configurado como prioritário no Citrus. 

  • Se a opção “Permitir o autoatendimento de voz” estiver marcada no Citrus (Administração > LemonDesk > Configurações de atendimento), o autoatendimento de voz será automaticamente ativado para todos os Atendentes, independentemente da configuração em seus cadastros. 
  • Uma descrição do recurso “Permitir o autoatendimento de voz” foi adicionada em Administração > LemonDesk > Configurações de atendimento. Será exibida ao passar o mouse sobre a opção. 
  • A flag no cadastro do Atendente no Citrus não é editável. É automaticamente marcada, ou não, a partir da configuração na Smartspace Manager (sincronização entre as duas plataformas).
CORREÇÕES

Atendimentos: Normalizado login de Atendente em fila de voz via tela de Monitoramento do Metrics

Normalizada a execução da ação do Supervisor de Logar agente em fila de voz na tela de Atendimentos do Citrus (LemonDesk > Atendimentos) via tela de Monitoramento do Metrics (Smartspace Manager > Metrics > Monitoramento do Call Center). 

Agora o Citrus vai verificar se o Atendente está logado na fila de voz em que um card de atendimento está sendo ofertado para ele a partir da tela de Monitoramento do Metrics, quando receber a oferta de atendimento da plataforma Smartspace Manager. 

Caso o Atendente no Citrus não esteja logado na fila de voz em que o Supervisor o logou via monitoramento, o login será realizado automaticamente. Dessa forma, o card de atendimento será exibido e poderá ser aceito na tela de Atendimentos (Citrus). 

Consulte o Guia da Nova tela de Monitoramento do Metrics 

Monitoramento: Status de Atendente aparecerá atualizado na tela de Monitoramento, independente de Grupo de monitoramento

O status atual de Atendentes será corretamente apresentado na tela de Monitoramento, mesmo quando visualizado pelo Supervisor em mais de um Grupo de monitoramento nos quais os Atendentes estão vinculados para operar através de filas diferentes. 

Ajuste corrigiu o cenário em que um Atendente era exibido como “Disponível” em um Grupo de monitoramento e “Em atendimento” em outro, porque a fila em que o atendimento acontecia não estava associada a um dos grupos.

Agora, o status apresentado será o que corresponde ao Atendente, independentemente da fila estar vinculada ao grupo monitorado.  

Confira o Guia de Monitoramento do Citrus 

Veja como funcionam os Grupos de monitoramento

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-30/feed/ 0