docs.autenticacao.gov

Manual da Aplicação Autenticação.gov para computador

Ilustração: Cartão de Cidadão

Ilustração: Aplicação Autenticação.gov

Tabela de conteúdos

Introdução

NOTA: A partir da versão 3.2.0, houve uma alteração de nomenclatura no manual. As referências a “Middleware do Cartão de Cidadão” foram substituídas por “aplicação Autenticação.gov para computador”, excepto quando o termo “middleware” é mais apropriado.

Este manual pretende descrever todas as funcionalidades providenciadas pela aplicação Autenticação.gov para computador.

A instalação da aplicação Autenticação.gov para computador inclui o middleware do Cartão de Cidadão. Este middleware pode definir-se como a “camada” de software entre o computador e o seu Cartão de Cidadão e é através deste que são disponibilizadas ao sistema operativo e outras aplicações funcionalidades de autenticação e assinatura eletrónica.

A aplicação Autenticação.gov para computador permite a gestão do seu Cartão de Cidadão. Nesta poderá visualizar as suas informações, editar as suas notas, modificar os seus PINs pessoais e assinar digitalmente ficheiros.

Este manual pode-se dividir nas seguintes fundamentais áreas de utilização:

Novidades

Suporte ao novo Cartão de Cidadão

Desde a versão 3.12.0 da aplicação é suportado o novo Cartão de Cidadão que tem a possibilidade de leitura por aproximação (contactless) se utilizado um leitor de cartões apropriado.

Continua a existir a possibilidade de leitura na interface de contacto mas deve garantir que o cartão está inserido no leitor de forma correta, porque no novo Cartão de Cidadão os contactos do chip encontram-se no verso do documento.

É recomendada a consulta da nova secção Acesso Contactless

Download, instalação e remoção da aplicação

Neste ponto são apresentadas as instruções para a instalação e remoção da aplicação Autenticação.gov para computador.

Sistemas Operativos oficialmente suportados

Download do pacote de instalação da aplicação

Para obter o pacote de instalação da aplicação, deverá aceder ao site oficial do Cartão de Cidadão em Aplicação Autenticação.gov para computador e fazer download da versão correta para o seu sistema operativo.

Ao clicar no link será efetuada uma tentativa de identificar o sistema operativo através dos dados fornecidos pelo navegador e na área de conteúdos do lado direito será apresentada uma hiperligação que permite efetuar o descarregamento do pacote de instalação adequado ao seu sistema.

Nos casos dos sistemas operativos Linux, não é possível identificar a distribuição, deste modo será apresentada a lista das distribuições suportadas para a arquitetura detetada.

Esta página contém a lista de todos os pacotes de instalação dos sistemas operativos oficialmente suportados e manuais de utilização.

Ilustração: Opções de download

Após efetuado o download da respetiva versão, avance para o ponto seguinte – Instalação da aplicação.

Instalação da aplicação

As instruções apresentadas de seguida pressupõem que o ficheiro de instalação da aplicação foi descarregado previamente da Internet. Caso não tenha sido, efetue os passos descritos no ponto anterior – Download do pacote de instalação da aplicação.

Para a instalação da aplicação Autenticação.gov para computador, deverão ser executados os passos descritos nos pontos seguintes, relativos ao sistema operativo utilizado.

Instalação em Microsoft Windows

  1. Executar o pacote de instalação: Após ter descarregado o ficheiro de instalação, deverá fazer duplo clique sobre este.

  2. No primeiro ecrã interativo, deverá marcar a caixa para aceitar os termos e condições da aplicação. Para uma instalação simples, pressione Instalar (prossiga para o passo 5). Para uma instalação avançada, pressione Avançadas. A instalação avançada permite configurar o caminho para a pasta de instalação e as funcionalidades a serem instaladas.

    Ilustração: Instalação da aplicação em Windows

  3. Após selecionar Avançadas, poderá escolher a pasta onde deseja instalar a aplicação. Se desejar alterar a pasta predefinida, carregue em Alterar e na janela que surgir, navegue até à pasta de destino e carregue OK. Para continuar a instalação na pasta de destino, deverá premir o botão Seguinte.

  4. Deverá aparecer um ecrã para escolher as funcionalidades a serem instaladas. As funcionalidades são representadas numa árvore em que cada funcionalidade possui um botão para a incluir ou excluir da instalação. Ao selecionar uma funcionalidade, será apresentada a sua descrição e o espaço necessário para a sua instalação. Para instalar as funcionalidades selecionadas, clique em Instalar.

    Ilustração: Instalação da aplicação em Windows

  5. Após a conclusão deste assistente, este solicitará a reinicialização do computador.

  6. No próximo arranque do Windows a instalação da aplicação estará finalizada.

Instalação em Linux

Instalação através da linha de comandos

Instalação de pacote Flatpak

A partir da versão 3.9.0 da aplicação foi introduzido um novo formato de pacote para Linux. O formato Flatpak tem o objetivo de suportar um maior número de distribuições Linux de uma forma uniforme.

Para instalar esta versão da aplicação deve seguir este procedimento:

  1. Desinstalar alguma versão nativa do pacote pteid-mw que esteja instalada no sistema. Por exemplo em Ubuntu deverá utilizar o comando: sudo apt remove pteid-mw
  2. Instalar o software Flatpak seguindo as instruções específicas da distribuição: https://flatpak.org/setup/
  3. Instalar o pacote pcsc-lite/pcscd no sistema usando os pacotes nativos da distribuição. A aplicação funciona sem este componente, apenas as funcionalidades que exigem acesso ao Cartão de Cidadão dependem do pcscd.
  4. Executar o comando flatpak install pteid-mw-linux.x86_64.flatpak na diretoria onde estiver o pacote flatpak descarregado.
Notas sobre a comunicação com o cartão
  1. O software Flatpak deverá ter versão igual ou superior à 1.3.2 para permitir que a aplicação aceda ao Cartão de Cidadão. Este requisito é cumprido por distribuições como o Ubuntu 20.04 e 22.04, OpenSUSE Leap 15.3 e 15.4, entre outras.
  2. Em Ubuntu 22.04 é importante executar um comando extra para garantir que o acesso ao Cartão funciona sempre: ` sudo systemctl enable pcscd.socket`

Instalação em Mac OS

  1. Executar o instalador: após ter descarregado o ficheiro de instalação, deverá fazer duplo clique sobre este, surgindo um ecrã semelhante ao apresentado de seguida:

    Ilustração: Instalação da aplicação em MacOS

  2. Escolher a opção Continuar. Em seguida é necessário ler e aceitar os termos da licença do software.

    Ilustração: Instalação da aplicação em MacOS

  3. A partir deste ponto no assistente deverá premir o botão Continuar até concluir a instalação.

  4. Após a conclusão deste assistente, a aplicação estará instalada no computador. Neste momento a aplicação utilitária “Autenticacão.Gov” já estará disponível na pasta Aplicações / Applications.

Instalação em ChromeOS

  1. Instalar o software Flatpak seguindo as instruções específicas do ChromeOS: https://flatpak.org/setup/Chrome%20OS

  2. Obter o instalador Linux em formato Flatpak a partir da página oficial.

  3. Executar o comando flatpak install pteid-mw-linux.x86_64.flatpak na diretoria onde estiver o pacote flatpak descarregado.

  4. Após a instalação, a aplicação pode ser executada com o comando flatpak run pt.gov.autenticacao.

Nota: A funcionalidade da applicação é atualmente limitada em ChromeOS, sendo possível utilizar apenas a Chave Móvel Digital.

Remoção da aplicação

Para proceder à remoção da aplicação do Cartão de Cidadão, deverão ser executados os passos descritos nos pontos seguintes, relativos ao sistema operativo utilizado.

Remoção em Microsoft Windows 7

  1. Aceda ao Painel de Controlo.

  2. Selecione a Opção Adicionar ou Remover Programas.

  3. Selecione o programa Autenticação.Gov, conforme apresentado na janela seguinte: Ilustração: Remoção da aplicação em Windows

  4. Clique em Desinstalar. Confirme todas as janelas de diálogo que irão surgir.

  5. Após estes passos, a aplicação estará removida do computador. Recomenda-se que o computador seja reiniciado no final destes passos.

Remoção em Microsoft Windows 10 ou 11

Através do Painel de Controlo

  1. Aceda ao Painel de Controlo.

  2. Selecione a Opção Adicionar ou Remover Programas.

  3. Selecione o programa Autenticação.Gov, conforme apresentado na janela seguinte: Ilustração: Remoção da aplicação em Windows

  4. Clique em Desinstalar. Confirme todas as janelas de diálogo que irão surgir.
  5. Após estes passos, a aplicação estará removida do computador. Recomenda-se que o computador seja reiniciado no final destes passos.

Através das Definições do Windows

  1. Aceda a Menu Iniciar -> Definições do Windows.

  2. Prima o botão Aplicações (Desinstalar, predefinições, funcionalidades opcionais):

    Ilustração: Definições em Windows

  3. Procure a aplicação Autenticação.Gov; selecione a aplicação e pressione Desinstalar, conforme apresentado na figura seguinte:

    Ilustração: Remoção da aplicação em Windows

  4. Clique em Desinstalar. Confirme todas as janelas de diálogo que irão surgir.
  5. Após estes passos, a aplicação estará removida do computador. Recomenda-se que o computador seja reiniciado no final destes passos.

Nota: a diretoria e ficheiros de log, que se encontram na pasta de instalação (por defeito em C:\Program Files\Portugal Identity Card\log\), não serão removidos ao desinstalar a aplicação Autenticação.Gov.

Remoção em Linux e ChromeOS

Remoção através da linha de comandos

Remoção de pacote Flatpak

  1. Verifique se a aplicação está de facto instalada via flatpak: isto acontece se existir uma entrada com o ID pt.gov.autenticacao na listagem devolvida pelo comando flatpak --columns=app list.
  2. Em caso afirmativo pode remover o pacote com o seguinte comando: flatpak remove pt.gov.autenticacao

Remoção em MacOS

  1. Abra a aplicação “Terminal” no MacOS.

  2. Execute o seguinte comando para desinstalar todos os ficheiros da aplicação.

    sudo /usr/local/bin/pteid_uninstall.sh

Atualização da aplicação

Atualização em Linux

Ao transferir o ficheiro de instalação através do menu Configurações -> Atualizações da aplicação, este ficará disponível na diretoria de Transferências, por defeito em ~/Downloads.

Pode também transferir a última versão da aplicação através da página oficial.

Depois de ter transferido o ficheiro de instalação, para concluir a atualização siga os passos indicados na secção Instalação através da linha de comandos.

Aplicação Utilitária “Autenticação.Gov”

A aplicação utilitária “Autenticação.Gov” pode ser utilizada para visualizar e gerir os dados no Cartão de Cidadão e assinar documentos digitais.

Ilustração: Apresentação da aplicação

Nesta aplicação poderá efetuar as seguintes operações:

O aspeto e comportamentos da aplicação é semelhante nos três tipos de sistemas operativos, à exceção de algumas funcionalidades que estão apenas disponíveis em Windows, visto serem funcionalidades nativas ou configurações específicas do ambiente Windows.

O atalho para a aplicação fica disponível em localizações diferentes consoante o tipo de sistema operativo:

Apresentação da Aplicação

A aplicação é composta por 4 áreas principais de interação:

Ilustração: Áreas principais de interação da aplicação

Funcionalidades da aplicação

As funcionalidades da aplicação estão divididas, em três menus principais: Menu Cartão, Menu Assinatura e Menu Segurança.

Permite visualizar a informação de identidade e foto do cidadão, visualizar a morada do cidadão, edição das notas, bem como imprimir os dados do Cartão de Cidadão. A foto do cidadão pode ser exportada para um ficheiro.

Identidade

Permite visualizar os dados de identificação e foto do cidadão presentes no Cartão de Cidadão. Através desta página é ainda possível exportar foto do cidadão.

Ilustração: Identidade do Cidadão

Outros dados

Permite visualizar outros dados do cartão do cidadão e verificar o estado do Cartão de Cidadão.

Ilustração: Outros dados

Morada e Alteração de morada

⚠ IMPORTANTE: Consulta de Morada do Cartão de Cidadão.

Desde a versão 3.9.0 da aplicação local Autenticação.Gov a morada do Cartão de Cidadão é lida a partir dos serviços centrais. Isto implica uma ligação à Internet funcional para a leitura da morada. É por isso necessário garantir que não existe firewall ou outro software na rede local que impeça a ligação ao endereço morada.cartaodecidadao.pt no porto 443. Para processos de alteração de morada iniciados desde o fim de dezembro de 2022, a confirmação de morada fica apenas disponível no portal eportugal.gov.pt.

Dentro do separador “Morada” é possível visualizar a morada atual e aceder ao portal eportugal.gov.pt para completar o processo de alteração da morada.

Ambas as funcionalidades requerem uma ligação à Internet. Por favor certifique-se que está ligado antes de iniciar o processo.

Para terminar o processo de alteração de morada, consulte a seguinte página Web:

Confirmar a alteração de morada.

Notas

A aplicação permite editar as notas gravadas no cartão do cidadão.

A leitura desta informação não requer qualquer código. Pode, por exemplo, inserir informação sobre contactos em caso de urgência, indicações sobre alergias, medicação, grupo sanguíneo ou outra qualquer informação que entenda pertinente e de acesso livre.

Ilustração: Editar notas

Imprimir

A aplicação permite a exportação dos dados do Cartão de Cidadão para um documento no formato PDF ou a impressão direta do documento.

Para executar estas operações deverá executar os seguintes passos:

  1. No menu principal, selecionar Cartão e no menu secundário a opção Imprimir.

  2. Na área de trabalho deverá selecionar os grupos de campos a incluir no documento e selecionar a opção Imprimir ou Gerar PDF.

    Ilustração: Opções de exportação de PDF ou impressão

    O documento a ser exportado e/ou impresso terá um aspeto gráfico conforme a imagem seguinte.

    Ilustração: Exemplo de exportação de PDF

Assinatura digital

A assinatura digital permite ao titular de um Cartão de Cidadão ou da Chave Móvel Digital, por vontade própria, assinar com a chave pessoal existente no seu Cartão de Cidadão ou com a Chave Móvel Digital.

No menu Assinatura pode assinar um documento PDF ou outro qualquer documento com possibilidade de assinar vários documentos ao mesmo tempo, adicionar atributos profissionais, bem como configurar outras opções. A assinatura digital em documentos PDF foi desenvolvida de acordo com a especificação da Adobe, podendo assim ser validada posteriormente no software Adobe Reader.

Ilustração: Menu de assinatura digital

Os ficheiros a assinar podem ser selecionados arrastando-os para a área de pré-visualização ou utilizando a combinação de teclas CTRL+V (colar). Pode também clicar na área de pré-visualização ou no botão Adicionar ficheiros e selecionar manualmente os ficheiros. Será exibida uma janela para selecionar os ficheiros que pretende assinar. Os ficheiros selecionados serão apresentados na secção “Escolha os ficheiros”, como podemos visualizar na imagem seguinte.

Ilustração: Submemu de assinatura avançada

Após selecionar as opções pretendidas, na área indicada na figura anterior, arraste a pré-visualização do selo de assinatura para a localização pretendida e de seguida prima o botão Assinar com Cartão de Cidadão ou Assinar com Chave Móvel Digital.

O botão Assinar com Cartão de Cidadão só está disponível quando o Cartão de Cidadão estiver inserido no leitor de cartões e for corretamente lido pela aplicação.

Após clicar em Assinar deverá escolher a localização da pasta e do ficheiro onde guardar o ficheiro assinado (Não é possível substituir o ficheiro original) e seguir o procedimento de assinatura (ver secção Introdução de chave). Em seguida é apresentado uma mensagem a indicar que a assinatura digital foi efetuada com sucesso.

Ilustração: Assinatura digital foi efetuada com sucesso

A imagem seguinte é um exemplo de um ficheiro assinado com a aplicação Autenticação.Gov.

Ilustração: Aspeto final da assinatura

Em caso de problemas na validação das assinaturas, verifique se está relacionado com o tópico Problemas com a nova cadeia de confiança.

Introdução de chave

A assinatura digital permite ao titular de um Cartão de Cidadão ou da Chave Móvel Digital, por vontade própria, assinar com a chave pessoal existente no seu Cartão de Cidadão ou com a Chave Móvel Digital.

No caso de pretender assinar com a chave pessoal existente no seu Cartão de Cidadão, ao selecionar a opção Assinar com Cartão de Cidadão, deverá introduzir o PIN de assinatura, conforme a figura seguinte.

Ilustração: Assinatura digital com a chave pessoal do Cartão de Cidadão

No caso, de pretender assinar com a Chave Móvel Digital, ao selecionar a opção Assinar com Chave Móvel Digital, deverá introduzir as respetivas credenciais, conforme a figura seguinte.

Ilustração: Assinatura digital com a Chave Móvel Digital

Verificação de documento PDF assinado em Windows ou MacOS

Após aplicar uma assinatura digital num documento, esta deverá ser identificada automaticamente ao abrir o documento em Adobe Reader. A imagem seguinte ilustra o Adobe Reader com um documento PDF que inclui a assinatura efetuada no passo anterior:

Ilustração: Assinatura de exemplo

Mesmo quando a assinatura não esteja visível (se a opção “Visível” não for selecionada no momento da assinatura), a assinatura deverá ser sempre validada no painel de assinaturas, dado que permite a visualização do estado da assinatura tendo em conta a cadeia de confiança e as propriedades criptográficas da mesma.

Ilustração: Validação da assinatura digital

Nota: Ao utilizar a função do Adobe Reader “bloquear o conteúdo depois de assinar”, evite assinar digitalmente o documento de novo. Apesar de ser permitido adicionar mais assinaturas segundo o standard PAdES, o Adobe Reader invalida a primeira assinatura neste processo.

Segurança

A aplicação permite efetuar operações relativas à segurança do Cartão de Cidadão.

Certificados

Neste menu é possível verificar os certificados do Cidadão e a cadeia de confiança formada pelas várias Entidades de Certificação do Cartão de Cidadão e do Estado Português.

Ilustração: Visualização do certificados

O preenchimento dos campos “Estado do certificado” correspondem a uma validação junto da Infraestrutura do Cartão de Cidadão e como tal exige ligação à Internet. Esta validação é acionada ao pressionar o botão Validar Certificados.

Ilustração: Visualização do certificados

É possível consultar a cadeia de certificados e os detalhes de cada certificado pressionando o botão Ver detalhes, visível na imagem anterior.

Ilustração: Visualização do certificados - detalhes

Código PIN

Neste menu é possível verificar e alterar os códigos PIN do Cartão de Cidadão.

Configurações

Personalização da Assinatura

Neste menu é possível personalizar a assinatura digital, substituindo a imagem do cartão do cidadão por uma imagem à escolha do utilizador.

O botão Adicionar assinatura permite selecionar uma imagem que será utilizada na assinatura personalizada. Após adicionar uma imagem, esta página da aplicação permitirá selecionar a opção Usar assinatura padrão ou Usar assinatura personalizada, conforme a escolha do utilizador.

O tamanho mínimo recomendado para a imagem é de 351 x 77px.

É, também, possível escolher incluir, ou não, a data de assinatura e o número de identificação civil na assinatura. Para tal, basta selecionar as checkboxes pretendidas neste menu.

Ilustração: Personalização da Assinatura digital

Atributos Profissionais

O Sistema de Certificação de Atributos Profissionais (SCAP) permite ao cidadão, através do Cartão de Cidadão ou da Chave Móvel Digital, assinar um documento na qualidade das funções que desempenha enquanto profissional. Para mais informações, consulte o seguinte website:

https://www.autenticacao.gov.pt/a-autenticacao-de-profissionais

Em primeiro lugar, selecione o tipo de atributos:

Seguidamente, deverá clicar num dos botões de carregamento de atributos, consoante pretenda, respetivamente, carregar os atributos com o Cartão de Cidadão ou Chave Móvel Digital (CMD):

Configuração da aplicação

Nesta janela é possível configurar alguns aspetos do funcionamento da aplicação, nomeadamente:

A imagem seguinte permite visualizar o menu de configurações da aplicação.

Ilustração: Janela de configurações da aplicação (com Modo de diagnóstico ativo)

Configuração de assinaturas

Nesta janela é possível configurar alguns aspetos relativos à assinatura com o Cartão de Cidadão:

Dados da aplicação

Neste separador é possível apagar os dados de cache armazenados das leituras dos cartões e do carregamento de atributos profissionais e empresariais.

Os dados armazenados relativos ao Cartão de Cidadão são os dados de identidade, a foto e a cadeia de certificação de autenticação e assinatura.

Relativamente aos atributos profissionais e empresariais são armazenados a lista de atributos pré-carregados.

Existe também a possibilidade de desabilitar a cache dos dados dos cartões, desativando a opção “Utilizar cache de dados do cartão”.

Ilustração: Janela Dados Aplicação

Atualizações

Nesta janela é possível verificar manualmente se existem atualizações para a aplicação. Caso existam atualizações, e se o utilizador o pretender, o download do instalador da aplicação é feito automaticamente e em seguida iniciado o processo de instalação.

Ajuda

A janela ajuda fornece um resumo das funcionalidades da aplicação, indica o caminho para chegar a este mesmo manual e a página de suporte da aplicação.

Ilustração: Janela Acerca

Centro de Notificações

Este menu disponibiliza aos utilizadores informações relativas a notícias, configurações e atualizações, no formato de notificações, e é aberto automaticamente no arranque da aplicação, caso existam notificações novas para mostrar ao utilizador. Ilustração: Centro de Notificações

No que diz respeito às configurações, podem existir notificações de caráter obrigatório cuja interação é necessária para utilizar a aplicação, como é o caso do uso da cache:

Ilustração: Centro de Notificações - Cache

Acesso Contactless

Importante: Funcionalidade disponível desde a versão 3.12.0 da aplicação

Para usar a interface contactless do novo Cartão de Cidadão será apresentada uma nova janela de diálogo na página que estiver em uso, por exemplo, página de Identidade, Morada, Certificados ou Assinatura. Esta janela exige que o utilizador insira o código de acesso ao cartão, que tem o objetivo de prevenir acessos não autorizados na leitura contactless.

Ilustração: Leitura contactless

O código de acesso ao cartão é o código de 6 dígitos que se encontra no canto inferior direito dos novos Cartões de Cidadão.

Ilustração: Infografia Novo Cartão de Cidadão

Este código não será requerido em posteriores utilizações da aplicação com o mesmo cartão.

No entanto se não pretende que seja guardado o código de acesso, pode desligar esta opção no separador “Dados da aplicação” dentro do menu Configurações da aplicação.

NOTA: A utilização do cartão pelo interface contactless para assinatura ou autenticação em aplicações externas tais como o Adobe Acrobat Reader exige que este tenha sido lido uma vez na aplicação Autenticação.gov e que esteja ativa a opção “Guardar códigos de acesso” nas Configurações.

Integração com aplicações

O middleware do Cartão de Cidadão, instalado com a aplicação Autenticação.Gov, permite a integração com outras aplicações do sistema operativo, disponibilizando duas funcionalidades: Autenticação e Assinatura Digital.

O middleware disponibiliza suporte criptográfico às aplicações via suporte criptográfico nativo do sistema operativo Windows ou via interface PKCS#11.

Integração com aplicações em Windows

Integração com aplicações com o Cartão de Cidadão:

A instalação do middleware em Windows permite que, ao introduzir um Cartão de Cidadão no leitor, os certificados deste fiquem automaticamente registados no sistema operativo, ficando assim as funcionalidades de autenticação e assinatura disponíveis às aplicações que utilizam a camada criptográfica do sistema operativo, para operações de autenticação e assinatura.

Alguns exemplos dessas aplicações são: Microsoft Word, Microsoft Excel, Microsoft Outlook e Adobe Acrobat Reader.

Para que os certificados fiquem automaticamente registados é necessário:

Integração com aplicações com a Chave Móvel Digital:

A integração com aplicações é também possível com a Chave Móvel Digital, ao nível da componente de assinatura digital. Para tal, siga o procedimento descrito em Assinatura digital com Chave Móvel Digital.

Na assinatura com Chave Móvel Digital, a mensagem de verificação enviada ao utilizador segue um dos 2 seguintes formatos:

Ilustração: Formato de Mensagem de CMD 1

Ilustração: Formato de Mensagem de CMD 2

Integração com aplicações via interface PKCS#11

No caso das aplicações com suporte PKCS#11, geralmente é necessário configurar a localização do ficheiro da aplicação, que permite o suporte. A localização deste ficheiro, depende do sistema operativo a ser utilizado.

Windows: C:\Windows\System32\pteidpkcs11.dll

Linux: /usr/local/lib/libpteidpkcs11.so

MacOS: /usr/local/lib/libpteidpkcs11.dylib

Assinatura digital em aplicações comuns

Nos pontos seguintes será explicada a utilização das funcionalidades de assinatura digital nas seguintes aplicações:

Assinatura digital:

Assinatura digital na suite Microsoft Office

Nesta secção é apresentada a assinatura digital de documentos em ficheiros Office, nomeadamente, nas aplicações: Word, Excel e PowerPoint.

Para assinar digitalmente um documento, deverá efetuar os seguintes passos:

  1. Aceder ao menu Ficheiro.

  2. Na secção Informações clicar no botão Proteger Documento e selecionar a opção Adicionar uma assinatura Digital, conforme a imagem abaixo:

    Ilustração: Assinatura em Microsoft Office

  3. Aparecerá uma mensagem específica da aplicação que está a utilizar (Word, Excel ou Powerpoint), clique em OK.
  4. Na Caixa de diálogo Assinar, introduza o Objetivo da assinatura, conforme a image abaixo: Ilustração: Assinatura em Microsoft Office
  5. Clique em assinar e introduza o seu PIN de assinatura na respetiva janela.
  6. O documento ficará assinado digitalmente, e ficará só de leitura de forma a impossibilitar alterações ao mesmo.

Poderá encontrar informação mais detalhada no seguinte link: Adicionar/Remover uma Assinatura Digital nos ficheiros do Office.

Assinatura digital na suite LibreOffice / OpenOffice

Nesta secção é apresentada a assinatura digital de documentos em ficheiros LibreOffice, nomeadamente, nas aplicações, Calc, Write e Impress. A versão utilizada neste manual foi a versão LibreOffice 5.3. A interface desta funcionalidade é bastante semelhante em todas as versões a partir de 4.0.0.

Em sistemas operativos Linux, a deteção dos certificados digitais nesta Suite depende das configurações de segurança do Mozilla Thunderbird ou Mozilla Firefox. Assim, para que esta funcionalidade esteja disponível deverá configurar previamente a integração com o Cartão de Cidadão no Mozilla Thunderbird ou Firefox. Ver as instruções em: Assinatura digital de email com Mozilla Thunderbird.

Para assinar digitalmente um documento, deverá efetuar os seguintes passos:

  1. Aceder ao menu Ficheiro → Assinaturas Digitais.

  2. Aparecerá a janela com as assinaturas digitais do documento. Caso não exista ainda nenhuma assinatura, a lista aparecerá vazia conforme a imagem abaixo. Clique no botão Assinar documento... .

    Ilustração: Assinatura em LibreOffice

  3. Será apresentada uma janela para seleção do certificado. Deverá selecionar o certificado que tem o seu nome e emitido por “EC de Assinatura Digital Qualificada do Cartão...” conforme ilustrado na imagem abaixo:

    Ilustração: Assinatura em LibreOffice

  4. Clique em Aceitar e introduza o seu PIN de assinatura na respetiva janela.

  5. O documento ficará assinado digitalmente.

Assinatura digital de email com Microsoft Outlook

A assinatura digital no Outlook, por omissão, obriga a que o certificado digital inclua o endereço de email, e este corresponda com o email que se pretende assinar.

Nos certificados existentes no Cartão de Cidadão e na Chave Móvel Digital não existe qualquer endereço de email. Desta forma, para que seja possível efetuar assinaturas digitais no Outlook com o Cartão de Cidadão e Chave Móvel Digital, é assim necessário desativar esta validação.

Na aplicação poderá desactivar essa validação selecionando a opção Permitir assinatura de e-mails no Outlook no submenu Configuração de assinaturas da aplicação Autenticação.gov para computador.

Ilustração: Localização da opção para desativar a correspondência de e-mails nos certificado no Microsoft Outlook

Alternativamente, para desativar a correspondência com endereço de email do certificado digital, poderá seguir as instruções disponibilizadas no website da Microsoft:

Para poder assinar digitalmente um email no Outlook, é necessário inicialmente efetuar a respetiva configuração. Os passos descritos de seguida, estão divididos em configuração, consistindo na configuração inicial necessária, e assinatura, consistindo na assinatura propriamente.

Nota: As imagens apresentadas são referentes ao Microsoft Outlook 16.

Configuração – Esta operação é realizada apenas uma vez.

  1. Assegurar que a correspondência com endereço de email do certificado digital está desativada, conforme instruções acima.

  2. No Outlook, aceder ao menu Ficheiro → Opções

    Ilustração: Assinatura em Outlook

  3. Clicar em Centro de Confiança.

    Ilustração: Assinatura em Outlook

  4. Selecionar a secção Definições do Centro de Confiança.

    Ilustração: Assinatura em Outlook

  5. Nesta secção, clicar no botão Definições

    Ilustração: Assinatura em Outlook

  6. Adicione uma descrição a esta configuração, p. ex.: “Assinatura com Cartão de Cidadão” e clique no botão Escolher para selecionar o certificado. Selecione o seu certificado de assinatura do Cartão de Cidadão ou Chave Móvel Digital.

    Ilustração: Assinatura em Outlook: Escolha do certificado

  7. Na configuração Algoritmo hash escolha SHA256 e clique em OK.

  8. Clique em OK em todas as janelas de configuração abertas. A configuração está terminada.

Assinatura - a efetuar cada vez que pretenda enviar um email assinado.

  1. No separador Opções da janela de criação de mensagem clicar em Assinar para ativar a assinatura.

  2. Ao clicar em Enviar, será solicitado o PIN de assinatura e o seu email será assinado e enviado.

    Ilustração: Assinatura em Outlook: Escolha do certificado

Assinatura digital em Adobe Acrobat Reader

Nota: para assinar um documento no Adobe Acrobat Reader DC em MacOS, siga as instruções da secção Assinatura digital em Adobe Acrobat Reader em MacOS (desde a versão 3.11.0).

Nota: a assinatura com atributos profissionais só é possível na aplicação Autenticação.Gov.

Para assinar um documento aberto no Adobe Acrobat Reader deve:

  1. Certos documentos PDF foram criados pelo seu autor com campos de assinatura. Se for esse o caso do seu documento deve localizar o campo de assinatura que pretende utilizar e clicar no mesmo. Em seguida pode saltar para o ponto 4 deste procedimento. Caso contrário será necessário criar um novo campo de assinatura num local á sua escolha. Para isso deve aceder ao separador Ferramentas e selecionar Certificados.

  2. Clique em Assinar Digitalmente na barra horizontal por cima do documento.

  3. Clique e arraste o rato para determinar a posição do selo de assinatura no documento.

  4. Certifique-se de que o cartão de cidadão está inserido no leitor e escolha o seu certificado de assinatura, emitido por EC de Assinatura Digital Qualificada do Cartão de Cidadão X (onde “X” é um número com 4 dígitos, por exemplo 0010), e carregue Continuar.

  5. Clique em Assinar e escolha o nome e pasta onde deseja guardar o documento assinado.

  6. Para concluir, introduza o seu PIN de assinatura. A janela de introdução de PIN deverá ter o título de “Segurança do Windows” e a mensagem “Introduza o PIN de assinatura digital”.

Assinatura digital em Adobe Acrobat Reader em MacOS (desde a versão 3.11.0)

Desde a versão 3.11.0 da aplicação é possível utilizar o Cartão de Cidadão em aplicações nativas MacOS utilizando o módulo PteidToken que implementa a framework CryptoTokenKit.

A configuração inicial deste módulo no Acrobat Reader fica bastante facilitada face às versões anteriores. Para poder assinar um documento no Adobe Acrobat Reader, em MacOS, deve primeiro ativar a utilização do módulo CryptoTokenKit da seguinte forma:

  1. No Adobe Acrobat Reader, aceda ao menu Preferências....

  2. Selecione a categoria Assinaturas e na secção “Criação e aparência” pressione Mais....

  3. Clique na caixa de seleção “Habilitar suporte à estrutura CryptoTokenKit”

Se já tinha assinado com CC usando versões anteriores da Autenticação.gov deve também garantir que o Acrobat Reader está a funcionar em modo nativo caso o seu computador tenha um processador Apple M1 ou sucessor. Neste sentido pode consultar a seguinte página de ajuda:

Depois desta configuração que é necessária antes da primeira utilização, deve inserir o Cartão de Cidadão no leitor e já deverá ter disponível o seu certificado de assinatura na funcionalidade do menu Certificados -> Assinar Digitalmente.

Assinatura digital em Adobe Acrobat Reader em MacOS com PKCS#11

Nota: Em computadores MacOS com processador ARM, Apple M1 ou sucessores, só é possível utilizar o módulo de assinatura no Adobe Reader se esta aplicação for executada em modo Intel emulado.

Pode consultar as instruções do fabricante para desligar o modo nativo na página de ajuda:

Para assinar um documento aberto no Adobe Acrobat Reader, em MacOS, deve primeiro carregar o módulo PKCS#11. Para tal, siga as seguintes instruções:

  1. No Adobe Acrobat Reader, aceda a Preferências.

    Ilustração: Janela para assinar em *Adobe Reader*.

  2. Selecione a Categoria Assinaturas e na secção “Certificados confiáveis e de identidade” pressione Mais....

    Ilustração: Janela para assinar em *Adobe Reader*.

  3. No separador “IDs digitais” selecione Módulos e tokens PKCS#11 e clique Adicionar módulo.

    Ilustração: Janela para assinar em *Adobe Reader*.

  4. No campo de texto insira o caminho da biblioteca: /usr/local/lib/libpteidpkcs11.dylib e pressione OK.

    Ilustração: Janela para assinar em *Adobe Reader*.

Se o seu cartão de cidadão estiver inserido no leitor e o módulo tiver sido adicionado com sucesso, ao pressionar Atualizar os certificados ficarão disponíveis e visíveis conforme na imagem seguinte. No caso dos certificados não ficarem disponíveis como na imagem, verifique que o cartão está inserido no leitor, reinicie o Adobe Acrobat Reader e volte a verificar.

Ilustração: Certificados do CC em *Adobe Reader*.

Depois de ter adicionado o módulo PKCS#11, para assinar um documento aberto no Adobe Acrobat Reader DC deve, com o cartão de cidadão inserido no leitor:

  1. Aceder ao separador Ferramentas e selecionar Certificados.

  2. Clique em Assinar Digitalmente na barra horizontal por cima do documento.

  3. Clique e arraste o rato para determinar a posição do selo de assinatura no documento.

  4. Escolha o seu certificado de assinatura, emitido por EC de Assinatura Digital Qualificada do Cartão de Cidadão X (onde “X” é um número com 4 dígitos, por exemplo 0010), e carregue Continuar.

  5. Clique em Assinar e escolha o nome e local onde deseja guardar o documento assinado.

  6. Para concluir, introduza o seu PIN de assinatura.

Assinatura digital com Chave Móvel Digital

Pode assinar documentos ou emails com a Chave Móvel Digital no Windows em aplicações como Microsoft Word, Microsoft Excel, Microsoft Outlook e Adobe Acrobat Reader. O procedimento é muito semelhante aos descritos nas secções anteriores mas difere em dois aspetos:

Registo do certificado – deverá registar no Windows o certificado associado à sua Chave Móvel Digital.

  1. No separador Configuração de assinaturas da aplicação “Autenticacão.Gov” há um segmento destinado a configurações da Chave Móvel Digital com um botão Registar. Pressione o botão para abrir uma janela de registo do certificado.

  2. Insira o número de telemóvel associado à sua conta da Chave Móvel Digital e o PIN de Assinatura da Chave Móvel Digital e pressione OK.

  3. Se as credenciais inseridas no passo anterior estavam corretas, deverá receber no telemóvel um código que deverá introduzir para concluir o processo de registo do certificado. Esse código será enviado por SMS ou através de notificação da aplicação móvel Autenticação.gov.

No caso de ainda não ter registado o seu certificado após uma re-ativação da Assinatura da Chave Móvel Digital ou o certificado atualmente registado estar expirado terá de repetir o procedimento de registo.

Assinatura – similar à assinatura com o Cartão de Cidadão com as seguintes diferenças:

Ilustração: Janela para assinar em *Microsoft Word*.

Assinatura digital de email com Mozilla Thunderbird

Para poder assinar digitalmente um email no Thunderbird, é necessário inicialmente efetuar a respetiva configuração. Os passos descritos de seguida, estão divididos em configuração, consistindo na configuração inicial necessária, e assinatura, consistindo na assinatura propriamente dita. Os printscreens coincidem com a versão 91 do Mozilla Thunderbird.

Configuração – Esta configuração é necessária efetuar uma única vez e os passos descritos aplicam-se também à configuração dos certificados em Firefox.

  1. Abra as Preferências e selecione o separador Privacidade e segurança. Navegue até à secção Segurança -> Certificados.

  2. Pressione o botão Dispositivos de segurança.

    Ilustração: Assinatura de E-mail com Mozilla Thunderbird

  3. Clique no botão Carregar.
  4. Na nova janela, preencha o nome do módulo (p.e. “Cartão de Cidadão”) e o caminho para o módulo PKCS#11, que se encontra numa das seguintes localizações (recomendação: copie o caminho para o módulo, de acordo com o seu sistema operativo, da lista seguinte):

Em Windows:

Em Linux: /usr/local/lib/libpteidpkcs11.so

Em MacOS: /usr/local/lib/libpteidpkcs11.dylib

Ilustração: Assinatura de E-mail com Mozilla Thunderbird

  1. Pressione OK em todas as janelas.
  2. Abra as Definições de conta e selecione a sua conta de email.
  3. Selecione o separador Criptografia de ponta a ponta.

  4. Na secção S/MIME, pressione o botão Selecionar no campo com a indicação “Certificado pessoal para a assinatura digital”.

    Ilustração: Assinatura de E-mail com Mozilla Thunderbird

  5. Selecione o certificado com a descrição “CARTAO DE CIDADAO:CITIZEN SIGNATURE CERTIFICATE” e clique OK.

    Ilustração: Assinatura de E-mail com Mozilla Thunderbird

  6. Se utilizar o Thunderbird 102 ou superior, no separador Criptografia de ponta a ponta selecione a caixa “Adicionar a minha assinatura por predefinição”.
  7. Para o Thunderbird poder utilizar o certificado do Cartão de Cidadão para assinatura é necessário registar e confiar no certificado raiz da cadeia de certificação do Estado Português.

Para importar o certificado raíz clique em “Gerir certificados...” na janela utilizada no ponto 1 e selecione o separador “Autoridades”. Deve importar o certificado raiz correto para o seu cartão e na questão “Pretende confiar em “ECRaizestado/EcRaizEstado 002” para os seguintes propósitos?” selecionar a opção: “Confiar nesta CA para identificar utilizadores de email”.

Assinatura - a efetuar cada vez que pretenda enviar um email assinado. Apenas necessário para versões do Thunderbird anteriores à versão 102.

  1. Abra a janela de composição de email.

  2. Clique na caixa de opções Segurança e clique em Assinar digitalmente esta mensagem. Esta opção ficará ativa.

    Ilustração: Assinatura de E-mail com Mozilla Thunderbird

  3. Ao clicar em Enviar, será solicitado o PIN de assinatura e o seu email será assinado e enviado.

Assinatura digital de ficheiros DWF

NOTA: A assinatura de ficheiros DWF apenas suporta assinatura com Cartão de Cidadão

1. Em primeiro lugar, deverá ter instalado no seu computador o Autodesk Design Review 2013 (as versões mais recentes não disponibilizam a funcionalidade de assinatura digital).

2. Abra o ficheiro DWF na aplicação.

3. Aceda ao menu no campo superior esquerdo:

Ilustração: Assinatura DWF 1

4. Aceda à opção Security:

Ilustração: Assinatura DWF 2

5. Selecione a opção Add Digital Signature:

Ilustração: Assinatura DWF 3

6. Nesta janela vai aparecer os certificados presentes do computador, pode carregar em Mais Opções para selecionar outro certificado. Certifique-se que o certificado selecionado corresponde ao de assinatura digital. Por fim, basta carregar OK:

Ilustração: Assinatura DWF 4

7. Introduza o PIN de assinatura pedido na janela:

Ilustração: Assinatura DWF 5

8. Após este procedimento, o processo de assinatura digital está concluído e vai aparecer uma janela a confirmar que assinatura está valida:

Ilustração: Assinatura DWF 6

Assinatura digital de ficheiros DWG

1. Em primeiro lugar, deverá ter instalado no seu computador uma versão atualizada da aplicação AutoCAD (a versão testada e cujo funcionamento foi confirmado foi a versão AutoCAD 2022).

2. Abra o ficheiro DWG na aplicação.

3. Aceda ao menu no campo superior esquerdo:

Ilustração: Assinatura DWG 1

4. Aceda à opção Salvar como e selecione Desenho:

Ilustração: Assinatura DWG 2

5. Aceda à opção Ferramentas e selecione Assinaturas digitais...:

Ilustração: Assinatura DWG 3

6. Ative a checkbox Anexar assinatura digital após salvar o desenho. Nesta janela vai aparecer os certificados presentes do computador, selecione EC de Chave Móvel Digital..., se pretender assinar com a Chave Móvel, ou EC de Assinatura Digital Qualificada do Cartão..., se pretender assinar com o Cartão de Cidadão. Por fim, basta carregar OK:

NOTA: Para efetuar a assinatura com Chave Móvel Digital deve efetuar o procedimento descrito nesta secção Assinatura digital com Chave Móvel Digital .

Ilustração: Assinatura DWG 4

Ilustração: Assinatura DWG 5

7. No caso da assinatura com o Cartão de Cidadão basta introduzir o PIN de assinatura (denominado na janela como PIN de não rejeição) e carregar OK. No caso da assinatura com Chave Móvel Digital vai-lhe ser pedido o seu pin de assinatura da Chave Móvel Digital e, após o ter introduzido corretamente, ser-lhe-á pedido o código de confirmação, enviado para o número de telemóvel registado.

Ilustração: Assinatura DWG 6

Ilustração: Assinatura DWG 7

Ilustração: Assinatura DWG 8

8. Após este procedimento, o processo de assinatura digital está concluído. Pode confirmar a assinatura, carregando com o botão direito do rato no documento, selecionando Propriedades e acedendo ao menu Assinatura Digital:

Ilustração: Assinatura DWG 9

Ilustração: Assinatura DWG 10

Se o separador Assinatura Digital não estiver presente, ver a secção Propriedades do ficheiro assinado por AutoCAD.

Autenticação em portais WEB

Existem duas formas de se autenticar perante um portal web utilizando o Cartão de Cidadão:

A forma de autenticação depende totalmente da configuração do website, não sendo possível ao utilizador escolher uma ou outra forma.

A Autenticação por certificado cliente através do navegador, tende a ser descontinuada, visto a apresentar desvantagens na recolha de dados, no entanto alguns sítios ainda utilizam esta forma.

Para poder utilizar este método de autenticação, tem de ter obrigatoriamente a aplicação instalada no seu computador.

Neste caso utilizando Sistema Operativo Windows os browsers Internet Explorer, Microsoft Edge e Google Chrome não exigem nenhuma configuração uma vez registado o certificado de autenticação do Cidadão.

Para o Mozilla Firefox em qualquer Sistema Operativo é necessário efetuar algumas configurações descritas em Configurar autenticação para Mozilla Firefox.

A autenticação por certificado através do portal autenticação.gov.pt não exige a instalação da aplicação mas sim do plugin Autenticação.Gov.

Para mais informação, consulte esta página de ajuda:

De forma a que a configuração do seu computador suporte qualquer uma das alternativas, recomenda-se que instale a aplicação no seu computador e também o plugin Autenticação.Gov.

Configurar autenticação para Mozilla Firefox

Para configurar o Mozilla Firefox tem que carregar o módulo PKCS#11 do Cartão do Cidadão.

Na versão 73.0.1 (para outras versões deverá ser semelhante):

  1. Nas opções do Mozilla Firefox aceda a Privacidade e Segurança. Pode aceder diretamente inserindo about:preferences#privacy na barra de endereço.

  2. Navegue até ao final da página e, na secção Certificados, carregue em Dispositivos de segurança... para abrir a janela “Gestor de dispositivos”.

Ilustração: Carregar PKCS#11 no Mozilla Firefox

  1. Pressione Carregar. Preencha o nome do módulo, por exemplo “PKCS#11 do Cartao de Cidadao” (evite o “ç” e “ã”). Seguidamente, carregue em Procurar... e navegue até ao módulo PKCS#11 do Cartão de Cidadão, cuja localização se encontra descrita na secção Integração com aplicações.

Nota: em MacOS o que se recomenda neste passo é copiar e colar no campo “Nome do ficheiro do módulo” o seguinte nome: /usr/local/lib/libpteidpkcs11.dylib

  1. Pressione Ok nas janelas abertas para terminar.

Resolução de Problemas

Exibida mensagem de erro quando se tenta adicionar o módulo PKCS#11 no Firefox / Thunderbird

Para que consiga adicionar o módulo PKCS#11 no Firefox tem de ter um leitor de cartões instalado no seu computador.

Certifique-se que o leitor está ligado e instalado e um cartão inserido antes de adicionar o módulo PKCS#11.

Caso esteja a utilizar uma versão de MacOS ou Linux 64-bit terá de utilizar uma versão 64-bit do Firefox / Thunderbird.

Não é possível adicionar o módulo PKCS#11 ao Adobe Acrobat Reader em MacOS

Em versões anteriores do Adobe Acrobat Reader para MacOS não é possível adicionar o módulo PKCS#11. Recomendamos a atualização do Adobe Acrobat Reader para a versão DC.

Impossibilidade de assinatura em Adobe Reader, Microsoft Office e LibreOffice com Cartão de Cidadão

Deverá aceder ao ficheiro pteidmdrv.inf, presente por defeito na diretoria C:\Program Files\Portugal Identity Card\PTeID Minidriver (ou na directoria selecionada durante a instalação). Após ter aberto a directoria, abra o menu de opções do ficheiro e selecionar a opção Instalar.

Ilustração: Impossibilidade de assinatura

Após a escolha desta opção, poderá aparecer uma janela de diálogo (Ver imagem seguinte) com o título “Ficheiros Necessários”, na qual terá de selecionar a pasta “drivers” que esta na diretoria C:\Windows\System32.

Ilustração: Impossibilidade de assinatura

Em caso de problemas verifique se está relacionado com o tópico Problemas com a nova cadeia de confiança.

O leitor de cartões está instalado mas não é detetado pela aplicação do Cartão de Cidadão

Windows

  1. Verifique se o leitor de cartões é compatível com o standard PC/SC (consulte a documentação do leitor de cartões ou contacte o fabricante).

  2. Verifique se os controladores do leitor estão corretamente instalados (consulte a documentação do leitor de cartões).

  3. Verifique se o serviço “Cartão Inteligente” (Smart Card) está iniciado:

    a) Aceda ao Painel de Controlo e em seguida aceda a Ferramentas de Administração

    b) Clique em Serviços

    c) Verifique se o serviço “Cartão Inteligente” (Smart Card) está iniciado (Started). Caso não esteja, clique com o botão direito no serviço e clique em Start.

    d) Desligue o leitor do computador.

    e) Encerre a aplicação do Cartão de Cidadão.

    f) Volte a inserir o leitor e abra novamente a aplicação.

  4. Se estiver a usar uma ligação a uma máquina remota e prentende partilhar o leitor de cartões, verifique se:

    a) Está a ligar o leitor de cartões no computador local

    b) Escolheu o Smart Card na lista de dispositivos e recursos locais que pretende utilizar na ligação remota (Ver imagem seguinte).

Ilustração: Ligação a máquina remota e partilha de leitor de cartões

Linux

⚠ Para sistemas Ubuntu 22.04 deve consultar a nota 2 desta secção

  1. Verifique se o leitor de cartões é compatível com o standard PC/SC (consulte a documentação do leitor ou contacte o fabricante).
  2. Verifique se o driver/controlador do leitor estão corretamente instalados (consulte a documentação do leitor). A maioria dos leitores de smartcards são suportados hoje em dia pelo driver de código aberto CCID: https://ccid.apdu.fr/

  3. Verifique se o pcsc daemon está instalado e em execução:

    a) Numa janela de terminal execute o seguinte comando:

    ps -e | grep pcscd

    b) Procure uma referência ao processo pcscd.

    c) Caso não esteja listado por favor inicie o serviço através do comando: sudo systemctl start pcscd

    d) Caso obtenha uma mensagem de erro é possível que o daemon não esteja instalado. Utilize o gestor de pacotes da sua distribuição para instalar o pcscd (por vezes está incluído num pacote de nome pcsc-lite).

Não são detetados quaisquer certificados durante a tentativa de assinatura na suite LibreOffice / Apache OpenOffice

A suite LibreOffice / OpenOffice em Linux, utiliza as configurações da aplicação Mozilla Firefox (ou como alternativa, Thunderbird) para a deteção dos certificados.

Para que os certificados passem a ser detetados na Suite LibreOffice / Apache OpenOffice, terá que efetuar a respetiva configuração no Mozilla Firefox, caso tenha esta aplicação instalada. Caso não tenha, poderá configurar o Mozilla Thunderbird para poder assinar documentos no LibreOffice.

Para mais informações consultar a página de ajuda:

Problemas gráficos na aplicação

O modo de renderização que está configurado na aplicação no momento da instalação é o que permite o melhor desempenho na maioria dos casos: a renderização por Hardware. No entanto este modo exige um driver OpenGL funcional no sistema para a placa gráfica do computador.

No caso de existirem problemas gráficos, recomenda-se alterar o modo de renderização gráfica. Pode fazê-lo na secção Aceleração gráfica do submenu Configuração da aplicação.

No caso da aplicação não arrancar ou tiver problemas no arranque, é possível alterar essa opção de três formas distintas:

  1. [Exclusivo para Windows a partir da versão 3.4.0 da aplicação] Na pasta de instalação da aplicação (que por omissão é C:\Program Files\Portugal Identity Card) existem três atalhos que permitem abrir a aplicação alterando o modo de renderização gráfica. Os atalhos são ícones clicáveis com o símbolo da aplicação e têm os seguintes nomes:

    • Autenticação.Gov Software para renderização por Software (OpenGL);
    • Autenticação.Gov Hardware para renderização por Hardware (Placa gráfica);
    • Autenticação.Gov Direct3d para renderização por Software (ANGLE, que emula o OpenGL usando Direct3D);

    No caso de existirem problemas gráficos, ou a aplicação não arrancar, deverá experimentar as três opções e ver qual tem melhor resultado. A última opção escolhida, ficará guardada e poderá voltar a arrancar a aplicação clicando no ícone no ambiente de trabalho ou no menu iniciar.

  2. Usando as configurações do software Autenticação.gov (via Chaves de Registo em Windows ou ficheiro de configuração em Linux e MacOS).

    • Em Windows, a chave de registo:
      HKEY_CURRENT_USER\Software\PTEID\configuretool\graphics_accelaration;
    • Em Linux, a chave com nome “graphics_accelaration” na secção “configuretool” do ficheiro:
      $HOME/.config/pteid.conf;
    • Em MacOS, a chave com nome “graphics_accelaration” na secção “configuretool” do ficheiro:
      $HOME/Library/Preferences/pteid.conf.

    Os valores que a chave pode tomar são:

    • 0 para renderização por Software (OpenGL);
    • 1 para renderização por Hardware (Placa gráfica);
    • 2 (Exclusivo para Windows) para renderização por Software (ANGLE, que emula o OpenGL usando Direct3D).

  3. Usando o Interface de linha de comandos.

Em ambiente empresariais deve alterar esta configuração conforme descrito no capítulo Instruções de configuração em ambientes empresariais.

Problemas com placas gráficas integradas

No caso de existirem problemas com placas gráficas, consulte o tópico Problemas gráficos na aplicação.

Não é possível mover/arrastar a aplicação (Linux em Wayland)

Em sistemas Linux que utilizem um sistema de interface gráfico baseado em Wayland foram detetados vários problemas de interação, entre os quais a impossibilidade de mover a janela arrastando-a a partir da barra de título.

Recomendamos a seguinte solução temporária, assumindo que existe o componente XWayland:
Usar o parâmetro -platform xcb, ou a variável de ambiente QT_QPA_PLATFORM=xcb, para forçar a aplicação a correr em modo X11, usando o XWayland.

$ eidguiV2 -platform xcb

ou

$ QT_QPA_PLATFORM=xcb eidguiV2

Aplicação não arranca

No caso da aplicação não arrancar e consequentemente não ser possível alterar as configurações da aplicação na aplicação, é possível alterar as opções da aplicação usando as configurações do software Autenticação.gov (via Chaves de Registo em Windows ou ficheiro de configuração em Linux e MacOS).

Uma causa que pode causar problemas está relacionado com a placa gráfica do computador, consulte o tópico Problemas gráficos na aplicação.

Problemas com a nova cadeia de confiança

O Sistema de Certificação Eletrónica do Estado colocou em produção um novo certificado raiz do Estado. Em consequência, os certificados do Cartão de Cidadão passaram a ser emitidos, desde 4 de abril de 2020, sob a nova cadeia de confiança do Estado Português. O certificado raiz da nova cadeia, no caso de não ser disponibilizado pelo sistema operativo, deverá ser instalado para que os certificados dos cartões emitidos após essa data sejam automaticamente confiáveis pelo sistema operativo Windows, assim como por algumas aplicações que não utilizam a lista de serviços confiáveis publicada pela União Europeia.

Pode instalar o certificado na Store do Windows através da aplicação do Cartão de Cidadão no submenu Configuração de assinaturas. Para tal, clique no botão Instalar certificado na secção Novo certificado raiz do Estado. O certificado será adicionado à Store “Trusted Root Certification Authorities” associada ao “Current User”. Nota: A funcionalidade de instalar certificado automaticamente só está disponível a partir da versão 3.4.0 da aplicação, versões anteriores deve usar o método manual apresentado em seguida.

Alternativamente, pode instalar o certificado manualmente seguindo as instruções no manual de instalação da cadeia do SCEE disponível em https://www.ecce.gov.pt/certificados/. Deverá seguir as instruções específicas para o “Certificado da Entidade de Certificação Eletrónica do Estado - ECRaizEstado 002” (passos 4.1 a 4.10 do manual).

Problemas na validação das assinaturas

Em caso de problemas na validação das assinaturas, verifique se está relacionado com o tópico Problemas com a nova cadeia de confiança.

Problemas com ficheiros PDF não suportados

A aplicação Autenticação.Gov atualmente não suporta os seguintes ficheiros PDF:

No entanto, é possível assinar estes ficheiros com o cartão de cidadão ou Chave Móvel Digital recorrendo a uma aplicação externa, por exemplo o Adobe Acrobat Reader. Para o fazer siga os passos descritos na secção Assinatura digital em Adobe Acrobat Reader.

Erro na Comunicação em assinatura com Chave Móvel Digital

Neste tipo de ocorrências é comum o cidadão estar ligado numa rede empresarial. Caso se verifique, é provável que exista na rede uma gateway de segurança ou proxy HTTPS que filtra o tráfego HTTPS e interfere com a ligação ao serviço de assinatura com Chave Móvel Digital.

Deve pedir ao Administrador de redes ou suporte informático da sua empresa ou organização para configurar uma exceção à filtragem do tráfego HTTPS para o serviço de Assinatura com Chave Móvel Digital. As informações necessárias estão na secção abaixo Serviços online usados pela aplicação. Recomendamos que adicione à lista de exceções os endereços dos vários serviços online usados pela aplicação.

Serviços online usados pela aplicação

Algumas funcionalidades da aplicação requerem a ligação a serviços online para funcionarem corretamente. É por isso necessário garantir que não existe firewall ou outro software na rede local que impeça a ligação a estes serviços.

Os hostnames e respetivos portos utilizados são listados em seguida por funcionalidade.

Assinatura com Chave Móvel Digital:

Validação de certificados:

Servidores OCSP:

Servidores CRL:

Assinatura com atributos Profissionais:

Leitura da morada:

Atualização da aplicação:

Atualização de certificados e notícias:

Documentação:

Selo temporal (por defeito):

Obtenção do relatório para análise através do menu Configurações

A partir da versão 3.5.0 da aplicação, para todos os sistemas operativos, para ajudar a diagnosticar um problema com a aplicação local Autenticação.gov, é possível criar um Relatório de Suporte. Este Relatório de Suporte contém os ficheiros de log com informações sobre o funcionamento da aplicação, essenciais para o diagnóstico de eventuais problemas.

Para obter o Relatório de Suporte deve:

  1. Abrir a aplicação e navegar até ao menu Configurações -> Configurações da Aplicação.
  2. Na secção “Modo diagnóstico” selecionar a opção Ativar modo diagnóstico.
  3. Reiniciar a aplicação.
  4. Após reiniciar, a aplicação deverá indicar o modo de diagnóstico ativo na barra de topo da aplicação, bem como a cor da mesma barra mudar para vermelho. Ver imagem seguinte.
  5. Repetir a ação que resultou na situação de erro/problema. Desta forma, com o modo diagnóstico ativo, as informações sobre o erro/problema constantes nos ficheiros de log serão mais detalhadas.
  6. Voltar a navegar até ao menu Configurações -> Configurações da Aplicação.
  7. Pressionar o botão Criar relatório. Ao pressionar o botão Criar relatório é criado um ficheiro zip no Ambiente de Trabalho que contém os ficheiros de log da aplicação, com um nome deste tipo: Autenticacao.gov_logs_DATA.zip.

  8. Por fim, deve enviar este ficheiro zip, juntamente com uma descrição o mais detalhada possível do problema, para o contacto de suporte através do email cartaodecidadao@irn.mj.pt.

    Ilustração: Criar Relatório de Suporte

Remoção de metadados de ficheiros PDF

A remoção de metadados de ficheiros PDF, através, por exemplo, da opção “Imprimir para PDF” de alguns browsers, pode remover as assinaturas digitais existentes no ficheiro, mesmo que o selo visual se mantenha.
Por este motivo, caso seja necessária a remoção de metadados, através desse ou de outro processo semelhante, esta deve ser feita antes de realizar qualquer assinatura.

Propriedades do ficheiro assinado por AutoCAD

Ilustração: Assinatura DWG 11

No caso do separador Assinatura Digital não aparecer nas propriedades do ficheiro assinado, é necessário seguir os passos presentes neste link.

Interface de linha de comandos

Nota: Esta funcionalidade só está disponível a partir da versão 3.3.0 da aplicação.

Quando executada a partir da linha de comandos, a aplicação Autenticação.gov para computador aceita alguns modos e opções descritos nas seguintes subsecções.

Consultar ajuda e versão

A opção --help (ou -h) permite, para cada modo, consultar as opções disponíveis na linha de comandos.

A versão instalada pode ser consultada com --version (ou -v).

Exemplo (Linux):

$ eidguiV2 -h

Atalho para configurar modo de renderização gráfica

É possível configurar o modo de renderização gráfica com umas das seguintes opções:

No caso de existirem problemas gráficos, ou a aplicação não arrancar, deverá experimentar as três opções e ver qual tem melhor resultado. A última opção escolhida, ficará guardada e poderá voltar a arrancar a aplicação clicando no ícone no ambiente de trabalho, no menu iniciar ou mesmo pela linha de comandos sem passar este parâmetro.

No caso de existirem problemas com placas gráficas, consulte o tópico Problemas gráficos na aplicação.

Exemplo (Linux):

$ eidguiV2 -c

Exemplo (Windows):

$ "C:\Program Files\Portugal Identity Card\pteidguiV2.exe" -c

Atalho para submenu de assinatura

Através da interface de linha de comandos, é possível iniciar a aplicação diretamente no submenu de assinatura digital.

O atalho para o submenu de assinatura (sign) requer os caminhos dos ficheiros a serem carregados para assinatura.

As opções suportadas são as seguintes:

Exemplos (Linux):

$ eidguiV2 sign -d /home/user/Documents/ ficheiro.pdf

$ eidguiV2 sign --tsa -m "motivo" -l "localidade" -d /home/user/Documents/ \
ficheiro1.pdf ... ficheiroN.pdf

Exemplo (Windows):

> "C:\Program Files\Portugal Identity Card\pteidguiV2.exe" sign^
 -d C:\Users\USER\Documents ficheiro.pdf

Nota: As opções passadas por parâmetros, que contêm um caracter espaço, devem ser colocadas entre aspas. Por exemplo (Linux):

$ eidguiV2 sign -d /home/user/Documents/ "ficheiro para assinar.pdf"

Instruções de configuração em ambientes empresariais

Configurações através de chaves de registo Windows

As configurações do software Autenticação.gov são guardadas em Windows em chaves de registo sendo que as alterações feitas pelo utilizador no interface gráfico se sobrepõem aos valores predefinidos e ficam guardadas em sub-chaves de:

HKCU\Software\PTEID

Pode-se, no entanto, configurar de forma padronizada uma instalação adicionando alguns valores no registo do Windows para todos os utilizadores da máquina após a instalação do software, usando as chaves listadas abaixo, sub-chaves da chave raiz: HKLM\Software\PTEID

Nota: Não se devem nunca remover ou alterar os seguintes registos:

HKLM\Software\PTEID\general\install_dirname

HKLM\Software\PTEID\general\certs_dir

Os seguintes registos podem ser adicionados:

HKLM\Software\PTEID\logging\log_level

HKLM\Software\PTEID\logging\log_dirname

HKLM\Software\PTEID\logging\log_prefix

HKLM\Software\PTEID\general\admin_config

HKLM\Software\PTEID\general\cache_dirname

HKLM\Software\PTEID\general\cache_enabled

HKLM\Software\PTEID\general\scap_host

HKLM\Software\PTEID\general\scap_port

HKLM\Software\PTEID\general\use_pinpad

HKLM\Software\PTEID\general\auth_pin_cache_normal

HKLM\Software\PTEID\configuretool\start_autoupdate

HKLM\Software\PTEID\configuretool\graphics_accelaration

HKLM\Software\PTEID\configuretool\start_with_windows

HKLM\Software\PTEID\configuretool\registrate_certificate

HKLM\Software\PTEID\configuretool\remove_certificate

HKLM\Software\PTEID\proxy\use_system_proxy

HKLM\Software\PTEID\proxy\proxy_host

HKLM\Software\PTEID\proxy\proxy_port

HKLM\Software\PTEID\certificatecache\cert_cache_validity

HKLM\Software\PTEID\xsign\tsa_url

Configurações através de ficheiro de configuração em Linux e MacOS

As configurações do software Autenticação.gov são guardadas em Linux e MacOS num ficheiro de configuração. Este ficheiro de configuração está localizado no seguinte caminho:

Linux: $HOME/.config/pteid.conf

MacOS: $HOME/Library/Preferences/pteid.conf

onde $HOME indica a directoria Home do utilizador de sistema.

O formato do ficheiro segue o formato INI com a respectiva secção de configuração a ser indicada por uma tag. Os valores que se podem especificar em cada secção/tag são os que foram indicados na tabela anterior referente às Configurações através de chaves de registo Windows.

Por exemplo para ativar manualmente o modo de diagnóstico devem ser adicionadas ao ficheiro as 2 seguintes linhas:

[logging]
log_level=debug

Instalação automatizada em ambientes Windows

Para instalar o software de forma automatizada é necessário seguir o seguinte procedimento (com permissões de administrador):

  1. Adicionar o certificado de codesigning da AMA – Agência para a Modernização Administrativa à Store “Trusted Publishers” associada ao “Local Computer” através da ferramenta MMC ou através do seguinte comando:

    certmgr -add AMA\_codesigning.cer -c -s -r localMachine TrustedPublisher

    O certificado pode ser obtido a partir do instalador MSI visualizando a assinatura do ficheiro no menu de contexto em:

    Properties → Digital Signatures → Details

  2. Se o sistema operativo for Windows 7 deverá ser instalado um Hotfix fornecido pela Microsoft para resolver uma incompatibilidade com o certificado de codesigning do software. Para tal seguir as instruções deste artigo:

    https://support.microsoft.com/en-us/help/2921916/the-untrusted-publisher-dialog-box-appears-when-you-install-a-driver-i

  3. Tendo já obtido o instalador em formato MSI podemos instalar o software sem interacção com o utilizador usando o seguinte comando:

    msiexec /i Autenticacao.gov-xxx.msi /qn

    Se se pretende evitar o reinício do sistema após a instalação deve ser adicionado ao comando o parâmetro /norestart .

Informação sobre servidores de Proxy

Configuração em Windows

Se a máquina em questão tiver um proxy correctamente configurado no Windows, seja por IP/Hostname + Porto ou por script de autoconfiguração (PAC file) não é necessária qualquer configuração no MW.

O software tem neste momento uma limitação com alguns tipos de servidores de proxy designadamente com autenticação NTLM ou Kerberos. Para utilizar as funcionalidades que exigem acesso à Internet (leitura de morada, desde a versão 3.9.0 da aplicação, validação de certificados, assinatura com atributos profissionais ou assinatura com Chave Móvel) será necessário nestes ambientes uma reconfiguração de rede ou o uso de uma proxy aberta ou com autenticação Basic.

Configuração em MacOS

Em MacOS é suportada a proxy do sistema mas apenas se for configurada por IP/Hostname + Porto

Desenvolvido pelo Estado Português
(Agência para a Modernização Administrativa, IP e Instituto dos Registos e do Notariado, IP)
© Copyright (C) 2010-2023