App na nuvem Zimbra

Com o padrão SAML 2.0, é possível configurar o Logon único (SSO) em vários apps na nuvem. Depois que você configurar o SSO, seus usuários poderão usar as credenciais do Google Workspace para fazer login em um app.

Usar SAML para configurar o SSO para o Zimbra

Para realizar essa tarefa, você precisa fazer login como superadministrador.

Etapa 1: configurar o Google como um provedor de identidade SAML

  1. No Google Admin Console, acesse Menu e depois Appse depoisApps da Web e para dispositivos móveis.

    Para realizar essa tarefa, você precisa fazer login como superadministrador.

  2. Clique em Adicionar appe depoisPesquisar apps.
  3. Em "Enter app name", digite Zimbra.
  4. Nos resultados da pesquisa, passe o cursor sobre Zimbra e clique em Selecionar.
  5. Na janela Detalhes do provedor de identidade do Google, para a Opção 2: copie o URL do SSO, o ID da entidade e o certificado:
    1. Ao lado de URL do SSO, clique em Copiar e salve o URL.
    2. Ao lado de ID da entidade, clique em Copiar e salve o URL.
    3. Ao lado de Certificado, clique em Copiar e salve o documento.

    Você precisa desses detalhes para concluir a configuração no Zimbra.

  6. Clique em Continuar.
  7. Na página Detalhes do provedor de serviços, em URL do ACS e ID da entidade, substitua {your-hostname} pelo URL que você usa para acessar sua instância do Zimbra.
  8. Clique em Continuar.
  9. (Opcional) Para mapear atributos do diretório do Google para os atributos correspondentes do app, na janela Mapeamento de atributos:
    1. Clique em Adicionar mapeamento.
    2. Clique em Selecionar campoe depoisselecione um atributo do diretório do Google.
    3. Em Atributos do app, insira o atributo correspondente.
  10. (Opcional) Para inserir nomes de grupos relevantes para este app:
    1. Em Associação ao grupo (opcional), clique em Pesquisar um grupo, digite uma ou mais letras do nome do grupo e selecione o nome.
    2. Adicione outros grupos conforme necessário (máximo de 75 grupos).
    3. Em Atributo do app, digite o nome do atributo de grupo correspondente do provedor de serviços.

    Independentemente do total de nomes de grupo informados, a resposta SAML inclui apenas grupos de que o usuário faz parte (direta ou indiretamente). Para mais informações, acesse Sobre o mapeamento de associações a grupos.

  11. Clique em Concluir.

Etapa 2: configurar o Zimbra como um provedor de serviços SAML 2.0

  1. Faça login no console do servidor do Zimbra com privilégios raiz e digite os seguintes comandos:
    • mkdir /opt/zimbra/lib/ext/saml
    • cp /opt/zimbra/extensions-network-extra/saml/samlextn.jar /opt/zimbra/lib/ext/saml/
  2. Saia e volte a fazer login no servidor Zimbra como usuário "zimbra".
  3. No certificado a seguir, substitua {domain-name} pelo seu nome de domínio do Google e {certificate} pelo conteúdo do certificado que você salvou localmente na Etapa 1:

    zmprov md {domain-name} zimbraMyoneloginSamlSigningCert "{certificate}"

  4. (Opcional) Para atualizar os URLs de login e logout, substitua {domain-name} pelo seu nome de domínio do Google e {SSO-URL} pelo URL do SSO que você baixou na Etapa 1 nos certificados a seguir.
    • zmprov md {domain-name} zimbraWebClientLoginURL {SSO-URL}
    • zmprov md {domain-name} zimbraWebClientLogoutURL {SSO-URL}
  5. Digite os seguintes comandos:
    • zmprov mcf zimbraCsrfRefererCheckEnabled FALSE
    • service zimbra restart
  6. (Opcional) Para confirmar as configurações, digite os comandos a seguir, substituindo {domain-name} pelo nome de domínio do Google:
    • zmprov gd {domain-name} zimbraMyoneloginSamlSigningCert
    • zmprov gd {domain-name} zimbraWebClientLoginURL
    • zmprov gd {domain-name} zimbraWebClientLogoutURL
    • zmprov gcf zimbraCsrfRefererCheckEnabled

Etapa 3: ativar o app para os usuários

Antes de começar:se quiser ativar ou desativar um serviço para determinados usuários, coloque as contas deles em uma unidade organizacional (para controlar o acesso por departamento) ou em um grupo de acesso (para permitir o acesso dos usuários de um ou vários departamentos).
  1. No Google Admin Console, acesse Menu e depois Appse depoisApps da Web e para dispositivos móveis.

    Para realizar essa tarefa, você precisa fazer login como superadministrador.

  2. Clique em Zimbra.
  3. Clique em Acesso de usuário.
  4. Para ativar ou desativar um serviço para todos na organização, clique em Ativar para todos ou Desativar para todos e depois em Salvar.

  5. (Opcional) Para ativar ou desativar um serviço em uma unidade organizacional:
    1. Selecione a unidade organizacional à esquerda.
    2. Para mudar o status do serviço, selecione Ativado ou Desativado.
    3. Escolha uma opção:
      • Se o status do serviço estiver definido como Herdado e você quiser manter a configuração atualizada, mesmo que a configuração mãe seja alterada, clique em Substituir.
      • Caso o status do serviço esteja definido como Substituído, clique em Herdar para reverter e usar a configuração mãe ou clique em Salvar para manter a nova configuração, mesmo que a configuração mãe seja alterada.
        Saiba mais sobre estrutura organizacional.
  6. (Opcional) Se você quiser ativar um serviço para alguns usuários em uma ou várias unidades organizacionais, selecione um grupo de acesso. Saiba mais em Personalizar o acesso ao serviço usando grupos de acesso.
  7. Verifique se os domínios de e-mail da sua conta de usuário do Zimbra correspondem ao domínio principal da Conta do Google gerenciada da sua organização.

Etapa 4: verificar se o SSO está funcionando

O Zimbra permite o SSO iniciado pelo provedor de identidade e pelo provedor de serviços.

Verificar o SSO iniciado pelo provedor de identidade

  1. No Google Admin Console, acesse Menu e depois Appse depoisApps da Web e para dispositivos móveis.

    Para realizar essa tarefa, você precisa fazer login como superadministrador.

  2. Clique em Zimbra.
  3. Na seção Zimbra, clique em Testar login SAML.

    O app vai abrir em uma guia separada. Caso contrário, resolva o problema da mensagem de erro e tente novamente. Confira mais detalhes sobre a solução de problemas em Mensagens de erro do app SAML.

Verificar o SSO iniciado pelo provedor de serviços

  1. Feche todas as janelas do navegador.
  2. Acesse sua instância do Zimbra.

    A página de login no Google será aberta.

  3. Digite seu nome de usuário e senha do Google Workspace.

Depois que suas credenciais forem autenticadas, o app será aberto.


Google, Google Workspace e marcas e logotipos relacionados são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos são marcas registradas das empresas a que estão associados.