Um portal GlobalProtect servido por um equipamento que gera o seu próprio certificado falha no Mac com Could not verify the server certificate of the gateway. O cliente está instalado, o portal responde, as credenciais estão certas — e mesmo assim a ligação não sobe. Falta o único elemento que o macOS não adivinha: a autoridade que assinou aquele certificado.

O que se segue é o procedimento completo, na ordem em que o problema aparece: confirmar a cadeia que o portal serve, extrair a raiz, instalá-la no keychain, provar que ficou confiável e saber distinguir o que se resolve no Mac do que tem de ser corrigido no servidor.

ℹ Quando este procedimento se aplica

Sempre que o certificado GlobalProtect for emitido por uma CA que só existe dentro do equipamento que serve o portal — appliances de operador, CPEs geridas pelo fornecedor, portais internos com PKI própria. Se o certificado vier de uma CA pública, o macOS já o aceita e não há nada para instalar.

✓ O processo em três passos

Extrair o segundo certificado da cadeia (a raiz, com CA:TRUE) → security add-trusted-cert -r trustRoot → confirmar com security verify-cert antes de testar a VPN. Instalar o primeiro certificado, o do servidor, é o erro mais comum e não resolve nada.

Neste artigo

O sintoma aparece em dois sítios e tem a mesma causa

No cliente GlobalProtect o erro é explícito:


Connection Failed
Gateway globalprotect.exemplo.local: Could not verify the server certificate
of the gateway. If the issue persists, contact your administrator.

No browser a mesma coisa com outra roupa: ao abrir https://IP-DO-PORTAL/global-protect/login.esp, o Safari e o Chrome mostram aviso de ligação não segura. Os dois validam contra o mesmo repositório de confiança do sistema, e nenhum deles conhece uma CA que só existe dentro do equipamento que serve o portal.

Isto acontece quase sempre em portais de VPN entregues por operador, em appliances de escritório pequeno e em plataformas cujo portal é gerido pela própria CPE: o fabricante gera uma raiz privada por equipamento, com um CN do tipo UUID.cloudwall.local ou equipamento.local, e assina com ela o certificado GlobalProtect que apresenta no portal. Não há nada de errado com o desenho — simplesmente essa raiz tem de ser distribuída a quem se liga.

Ler a cadeia antes de tocar no keychain

Antes de instalar seja o que for, ver o que o servidor envia. Sem este passo instala-se o certificado errado, o keychain fica com uma entrada inútil e a VPN continua a falhar — a diferença entre uma correcção e uma tarde perdida está aqui.

Ver o certificado que o portal serve


echo | openssl s_client -connect 203.0.113.10:4443 -showcerts 2>/dev/null \
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

Saída esperada, com o leaf à cabeça:


subject=C = PT, O = Operador Exemplo, OU = Servidores Privados, CN = 203.0.113.10
issuer=C = PT, O = Operador Exemplo, OU = Servidores Privados, CN = UUID-da-CA.cloudwall.local
notBefore=Nov  4 16:46:17 2026 GMT
notAfter=Nov  4 16:46:17 2027 GMT
X509v3 Subject Alternative Name:      <-- se esta linha não aparecer, não há SAN

Dois nomes diferentes: o subject é o certificado do portal, o issuer é quem o assinou. O primeiro é descartável. O segundo é a CA que falta ao macOS.

Extrair a raiz — é esta que se instala

A cadeia traz normalmente dois certificados: o do servidor e a raiz auto-assinada. Este comando guarda o segundo:


cd ~/Desktop
openssl s_client -connect 203.0.113.10:4443 -showcerts </dev/null 2>/dev/null \
  | awk '/-----BEGIN CERTIFICATE-----/{n++} n==2' > ca.pem
openssl x509 -in ca.pem -noout -subject -ext basicConstraints

O resultado tem de mostrar CA:TRUE. Se mostrar CA:FALSE, o awk apanhou o certificado do servidor — não continuar, porque instalar um leaf como âncora de confiança cria uma excepção que morre na próxima renovação e não cobre mais nenhum serviço do mesmo equipamento.

Duas fragilidades a conhecer: o -showcerts repete o leaf no fim e o ca.pem fica com esse excesso (o openssl x509 lê apenas o primeiro bloco, por isso funciona, mas confirme sempre o CA:TRUE) e há servidores que nem enviam a raiz na cadeia — nesse caso o segundo certificado pode ser um intermédio, ou não existir.

✓ Alternativa: distribuir a CA pelo próprio portal

Na consola do portal, a aba Agent inclui um campo Trusted Root CA: ao anexar aí a raiz, o cliente instala-a sozinho no primeiro connect, sem trabalho manual no Mac. É a via certa em parque gerido e a solução quando o servidor nem envia a raiz (documentado nas respostas da comunidade Palo Alto e no guia de administração do GlobalProtect).

⚠ Instalar o certificado do portal em vez da CA não resolve

Um certificado GlobalProtect de leaf é emitido por um ano e amarrado ao nome ou IP daquele serviço. Confiá-lo à mão funciona até ao dia em que o equipamento reemite, e nessa manhã a VPN falha outra vez sem que ninguém tenha mudado nada. A raiz cobre o leaf actual e os seguintes.

Sem SAN, o browser continua a avisar

Há uma limitação que não se resolve do lado do Mac. Se o certificado não tiver a extensão subjectAltName, o macOS deixa de confiar em nomes DNS no CommonName desde o macOS 10.15 (e o iOS 13) — para todos os certificados de servidor TLS, sem data de corte por emissão. As regras com data de 1 de Julho de 2019 são outras: o certificado tem de ter a extensão serverAuth no EKU e validade máxima de 825 dias. Em qualquer destes casos, o browser recusa o nome. Confirmar:


openssl x509 -in ca.pem -noout -ext subjectAltName
# O -ext exige OpenSSL 1.1.1+ — o /usr/bin/openssl do macOS costuma ser LibreSSL
openssl version
# Alternativa universal:
openssl x509 -in ca.pem -noout -text | grep -A1 "Alternative Name"

Nesse caso instalar a CA resolve o GlobalProtect e não resolve o aviso do Safari. O que o cliente da Palo Alto valida é a âncora de confiança — no teste deste guia, com a CA confiada o Connect subiu mesmo com CN de IP no certificado servido. Os browsers, esses, exigem SAN por nome. É a diferença entre «a VPN funciona» e «o browser está contente» — quem promete as duas coisas com um certificado destes está a prometer o que o servidor não tem.

Instalar a CA no macOS

Método A — terminal, dois comandos

Converter para DER e entregar ao security. O -d escreve no domínio de administração, que é o que interessa num Mac gerido:


openssl x509 -inform PEM -outform DER -in ca.pem -out ca.cer

sudo security add-trusted-cert -d -r trustRoot \
  -k /Library/Keychains/System.keychain ~/Desktop/ca.cer

Aparece uma folha do sistema com o título Certificate Trust Settings, o utilizador já preenchido e um campo de password. Carregar em Update Settings depois de escrever a password. Sem esse clique não fica nada configurado — o comando não falha, simplesmente não aplica.

⚠ -k ~/Library/Keychains/login.keychain-db falha no macOS 26

O keychain do utilizador deixou de estar nesse ficheiro — em instalações recentes a pasta tem system-keychain-2.db e mais nada. O comando devolve SecCertificateAddToKeychain: The specified keychain could not be found. Duas saídas: usar o caminho de sistema como acima, ou omitir o -k e deixar o security resolver o keychain por omissão.

Método B — arrastar do Safari, sem terminal

  1. Abrir o portal no Safari e, no aviso, escolher Mostrar Detalhes → visitar este website.
  2. Clicar em Não Seguro na barra de endereço → Mostrar Certificado.
  3. Na hierarquia do certificado, seleccionar a entrada de topo (a .local, não a do IP) e arrastar o ícone grande para o Desktop.
  4. Duplo clique no ficheiro .cer → Acesso às Keychains → adicionar ao keychain Sistema.
  5. Duplo clique no certificado dentro do Acesso às Keychains → expandir Confiança → Ao usar este certificado = Confiar Sempre → fechar com a password.

Sistema ou utilizador?

A escolha não é indiferente e explica metade dos «instalei e não funcionou».

Domínio Quem beneficia Quando usar
Sistema (/Library/Keychains) Todos os utilizadores e serviços Mac geridos, serviços que correm fora da sessão, política de empresa
Utilizador (keychain de sessão) Só aquele utilizador Correcção rápida num portátil pessoal, sem acesso de administração

Um trust de utilizador não chega ao ecrã de login, nem a nenhum processo que arranque antes da sessão. Num parque gerido, instalar no domínio do utilizador é dívida técnica: funciona hoje, falha quando o mesmo Mac é usado por outra conta.

Verificar antes de dizer que está resolvido

O teste que conta é a validação da cadeia, não a presença do certificado na lista:


security verify-cert -c ca.cer
# ...certificate verification successful.

Se imprimir o erro, o trust não ficou aplicado — voltar ao passo da password, porque o mais provável é a folha ter sido cancelada.

⚠ security dump-trust-settings mente neste macOS

Mesmo com o trust activo, o comando responde SecTrustSettingsCopyCertificates: No Trust Settings were found. O backend de confiança mudou e o utilitário não o lê. Quem se guiar por esta saída vai concluir que falhou e repetir a instalação do certificado GlobalProtect três vezes. Usar verify-cert e o teste real do cliente.

Depois disso, abrir o GlobalProtect e carregar em Connect. O resultado esperado é Connected com o gateway identificado — se continuar a falhar, o passo seguinte é ler o erro — e o parágrafo abaixo diz qual é o próximo suspeito.

Firefox não usa o keychain do macOS

Quem usa Firefox no mesmo Mac continua a ver o aviso depois de instalar o certificado GlobalProtect no sistema, porque o Firefox tem armazenamento de autoridades próprio. Importar em about:preferences#privacy → Ver Certificados → Autoridades → Importar, com a opção Confiar nesta CA para identificar sites marcada. É trabalho separado e não se herda do sistema.

Remover o trust quando já não é preciso


# 1. Remover as trust settings (o delete-certificate sozinho não as garante)
sudo security remove-trusted-cert -d ca.cer
# 2. Remover o certificado do keychain
sudo security delete-certificate \
  -c "UUID-da-CA.cloudwall.local" \
  /Library/Keychains/System.keychain

A alternativa em um só comando é security delete-certificate -t, que remove as trust settings em conjunto com a entrada. Confiando uma CA confia-se tudo o que ela assinar. Num equipamento de operador a chave privada está fechada no equipamento e o risco é limitado — num endpoint público é outra conversa. Quando o contrato acaba ou o equipamento é substituído, apagar a entrada faz parte do encerramento — não é limpeza cosmética.

Quando instalar a CA não chega

Há cinco situações em que instalar o certificado GlobalProtect está certo e o problema continua. Todas se diagnosticam com os mesmos dois comandos do início.

Situação Como se reconhece O que fazer
O nome do gateway não está no certificado O cliente fala de gateway.exemplo.local e o certificado GlobalProtect só tem CN com o IP, sem SAN Pedir ao fornecedor um certificado com SAN para esse nome. No Mac não há solução limpa
Porta 443 fechada openssl s_client na 443 não abre — só a 4443 responde Confirmar o endereço configurado no cliente — o portal e o gateway podem partilhar porta
SNI não muda o certificado Ligar com -servername do gateway devolve o mesmo CN de IP Não há certificado alternativo escondido: o que falha é o que está lá
A CA foi regenerada Equipamento substituído, factory reset, ou o CN da raiz mudou Repetir o processo do início — a entrada antiga deve ser apagada
Mac sob MDM Confiar Sempre volta atrás sozinho ou o botão está inactivo O perfil tem de trazer a CA — o trust manual é revertido na sincronização seguinte

Vale a pena dizer o óbvio sobre o cliente Windows da mesma VPN: usa o repositório do Windows, não o keychain, e resolve-se em certlm.msc → Autoridades de Certificação de Raiz Fidedignas. O mesmo certificado, outro sítio.

Os erros que aparecem sempre

  • Confiarem o certificado do portal. Dá a impressão de resolver e desfaz-se na renovação anual. A raiz é a única escolha estável.
  • Cancelarem a folha de autenticação. O comando devolve ao prompt sem erro e sem efeito. Verificar sempre com verify-cert.
  • Assumirem que o browser fica limpo. Com CN sem SAN, o Safari avisa para sempre — o GlobalProtect é que passa a ligar.
  • Esquecerem o Firefox. Store próprio, importação própria, aviso próprio.
  • Instalarem no utilizador e testarem com outro. O segundo utilizador do mesmo Mac não herda nada.

Artigos relacionados

Referências

Nota: os comandos e as particularidades (caminho do keychain no macOS 26, comportamento do dump-trust-settings) vêm de um teste real em macOS 26 com o cliente GlobalProtect 6.3, sobre um portal servido em :4443 com CA privada do equipamento. Os endereços e nomes dos exemplos são ilustrativos.