Guia Integração com Provedor de Identidade – Citrus.cx https://hml-docs.citrus.cx Base de Conhecimento Sun, 26 Oct 2025 13:31:32 +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 Guia Integração com Provedor de Identidade – Citrus.cx https://hml-docs.citrus.cx 32 32 Versão 2.109.32 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-32/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-32/#respond Wed, 14 May 2025 14:33:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-32/
NOVIDADE

Administração | Atendimentos: Código registrado na configuração de canal será exibido em Protocolo de atendimento

A partir de agora, quando o campo “Código” estiver preenchido na configuração de um canal de atendimento (Administração > Configurações Gerais > Canal do atendimento > +Novo/editar > (campo) Código), o Protocolo de atendimento seguirá o formato: código do canal 202506021357491000003. 

Caso a configuração do canal não possua um código definido, a composição do número do Protocolo dos atendimentos seguirá o padrão. Por exemplo: 202506021357491000003. 

CORREÇÕES

Login: Ajuste evitará que sessão de Atendente com Microsoft seja encerrada automaticamente

O processo de login com Provedor de Identidade Microsoft foi ajustado para garantir que sessões de Atendentes na plataforma Citrus sejam corretamente criadas e armazenadas nos cookies do navegador. 

O tratamento garantirá o funcionamento contínuo do sistema após login, evitando que sessões expirem e Atendentes sejam desconectados da plataforma automaticamente. 

Consulte o Guia Integração com Provedor de Identidade

Confira mais detalhes sobre Login com conta corporativa Microsoft

Administração: Cadastro de usuário só listará Domínios do ambiente no qual está vinculado

O sistema fará verificação e removerá Domínios que não estão associados ao ambiente do cliente Citrus.

O ajuste assegura que ao acessar o cadastro de usuário no Citrus (Administração > Usuários > Usuário > +Novo/Editar), o campo “Domínio” liste apenas os vinculados ao ambientes a que o usuário pertence. 

Atendimentos: Distribuição de cards de atendimentos está respeitando regras configuradas para as filas

A oferta de cards para Atendentes logados em filas dos canais de atendimento (tela de Atendimentos) foi normalizada para que volte a considerar as regras configuradas para as filas.  

O cenário em que o primeiro Atendente da fila a realizar atendimento voltava a receber novos cards antes dos demais Atendentes também receberem oferta de atendimento foi resolvido.  

Confira os critérios respeitados na distribuição de atendimentos no Guia de Regras para Oferta de Cards de Atendimentos 

Processos: Normalizada a atualização de etapas de processos reabertos após finalizados ou cancelados

A exibição dos botões Iniciar etapa e Finalizar etapa está acontecendo como esperado ao reabrir Processos com status Cancelado ou Finalizado, permitindo que etapas de atendimentos que estavam pendentes possam ser atualizadas. 

Acesse mais informações em Etapas dos Fluxos 

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-32/feed/ 0 Versão 2.109.31.1 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-31-1/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-31-1/#respond Fri, 09 May 2025 14:21:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-31-1/
CORREÇÃO

Login: Ajuste evitará que sessão de Atendente com Microsoft seja encerrada automaticamente

O processo de login com Provedor de Identidade Microsoft foi ajustado para garantir que sessões de Atendentes na plataforma Citrus sejam corretamente criadas e armazenadas nos cookies do navegador. 

O tratamento garantirá o funcionamento contínuo do sistema após login, evitando que sessões expirem e Atendentes sejam desconectados da plataforma automaticamente. 

Acesse o Guia de Integração com Provedor de Identidade

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-31-1/feed/ 0 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