Mosaico
  • 👋Bem-vindo ao Guias do Mosaico
  • Plataformas comuns da Administração Pública
    • Serviço de Autenticação
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
    • Assinatura Digital
      • Quais os pré-requisitos técnicos da adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
    • Plataforma de Integração da AP (iAP-PI)
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
      • Camada de negócio
        • Atores de negócio
        • Serviços de negócio
    • Plataforma de Pagamentos da AP (PPAP)
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
        • Adesão à PPAP
        • Simplex de urbanismo: Adesão à PPAP e ao DUC no âmbito do RJUE (DL 10/2024)
          • FAQs DL 10/2024
      • Como está estruturada a plataforma?
      • Como usar o serviço?
    • Plataforma de Mensagens (GAP)
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
      • Como usar o serviço?
    • Plataforma Multicanal (PMC)
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
        • Política de gestão de acessos da PMC
    • Bolsa de Documentos
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
    • Catálogo de Entidades e Serviços (CES)
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
    • Sistema de Certificação de Atributos Profissionais (SCAP)
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
    • Sistema de Autorizações
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
    • Dados.Gov
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
    • Serviço Público de Notificações Eletrónicas (SPNE)
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
    • ePortugal
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
        • Modelo Ligar
        • Modelo Aproximar
        • Modelo Integrar
      • Como está estruturada a plataforma?
    • Livro Amarelo Eletrónico
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
    • Interoperabilidade Documental
      • Quais os pré-requisitos técnicos de adesão?
      • Qual o processo de adesão?
      • Como está estruturada a plataforma?
  • 📖Guias Práticos
    • Como funciona o Serviço de Autenticação
      • Autenticação de um utilizador junto de uma entidade utilizando o Cartão do Cidadão
      • Autenticação de um utilizador junto de uma entidade utilizando a Chave Móvel Digital
    • Integrar com o Serviço de Autenticação
      • Entidade no papel de fornecedora de serviços de autenticação web
      • Entidade no papel de fornecedora de atributos
    • Consumir um serviço da iAP-PI
    • Boas práticas para a publicação de API a consumir pela Administração Pública
      • Crie APIs RESTful robusta
      • Reforce a segurança
      • Crie esquemas de mensagens bem definidos e fáceis de consumir
      • Padronize os dados e codificação
      • Teste o desempenho e escalabilidade das APIs
      • Publicar e documentar a API
    • Usabilidade - Como realizar testes de usabilidade?
    • Usabilidade - Como desenvolver aplicações para dispositivos móveis?
      • Boas Práticas
      • Componentes da Interface
    • Cloud - Guia para modelos de implementação
      • Cloud pública
      • Cloud privada
      • Cloud comunitária
      • Cloud híbrida
      • Comparativo dos modelos de implementação
    • Cloud - Guia para modelos de serviço
      • IaaS - Infrastructure as a Service
      • PaaS - Plataform as a Service
      • SaaS - Software as a Service
      • Comparativo dos Modelos de Serviços Cloud
    • GuIA Responsável para a IA
      • Responsabilização
      • Transparência
      • Explicabilidade
      • Justiça
      • Ética
    • O que é o ciberataque?
    • Como criar um plano de testes?
    • Como documentar testes funcionais?
    • Quais os tipos de testes que pode realizar?
    • Como disponibilizar e reutilizar dados abertos
      • Publicar dados abertos no dados.gov
      • Findability - Tornar os dados localizáveis
      • Accessibility – Tornar os dados acessíveis
      • Interoperability – Promover a interoperabilidade dos dados
      • Reusability – Facilitar a reutilização de dados
      • Recomendações para ficheiros CSV
      • Recomendações para melhorar o nível de abertura dos dados
      • Reutilizar dados abertos
    • Como aderir ao Fornecedor de Atributos de Funcionário (FAF)?
      • Como aderir?
      • Como fazer o Registo de Entidades?
        • Tipo de Entidade
        • Registo de Entidade
        • Adicionar os Funcionários à Entidade
          • Editar Entidade
          • Adicionar Funcionário
            • Dados Pessoais
            • Cargos Profissionais
            • Poderes
            • Resumos e conclusões
          • Upload do Excel
          • Termos e Condições
      • Como fazer a Gestão de Entidades?
        • Ações sobre funcionários
        • Cancelar Registo
    • Decreto-Lei nº 49/2024 - Perguntas Frequentes
      • Inventário de Portais e Serviços
      • Calendarização da Concretização das Medidas
      • Desenho dos Serviços Federados
        • Serviços e a aplicação do Ágora Design System
        • Requisitos
        • Fluxo do serviço federado
        • Protótipos
      • Inventário de Linhas de Atendimento
  • SDG - Plataforma Digital Única
    • Regulamentos e diretrizes
    • Requisitos dos serviços digitais
  • Adesão ao Fornecedor de Evidências – Emissor de Evidência
    • Tipos de evidências
    • Endpoints
      • GetEvidence
        • Estrutura dos parâmetros de entrada
        • Estrutura dos parâmetros de saída
  • Adesão ao Fornecedor de Evidências – Localizador de Evidência
    • Comunicação com o Localizador de Evidência
      • Redireccionamento para o Localizador de Evidência
      • Endpoints do Portal de Serviços
      • Redireccionamento para o Portal de Serviço
      • Consulta do Estado da Evidência
    • Códigos de Resposta
  • 🚀Serviços de Nova Geração
    • Arquitetura de Referência para a nova geração de Serviços Públicos Digitais
      • Conceitos
      • Princípios Orientadores
      • Standards
      • Metamodelo
      • Plataformas comuns
        • Estrutura Classificativa
        • Descrição
        • Serviços e Interfaces
      • Padrão de referência de solução aplicacional
      • Caso de utilização
    • Representação de novos serviços públicos
      • Consultar pontos da carta de condução e contraordenações
      • Ativar Chave Móvel Digital (CMD) com biometria
        • Ativar CMD com recurso à biometria via Aplicação
        • Ativar CMD com recurso a biometria via Videochamada
      • Confirmar a alteração de morada
      • Adquirir o certificado de registo criminal por telefone
  • 🗃️Casos de Estudo
    • Como o Ticapp usa a ferramenta ágil Jira
      • Gestão do Backlog
      • Release
      • Sprint
      • Reports
Powered by GitBook
On this page
  • Infraestrutura para integração com a PI
  • Ligação VPN
  • Plataforma Tecnológica das entidades aderentes à PI
  • Desenvolvimento do serviço
  1. Plataformas comuns da Administração Pública
  2. Plataforma de Integração da AP (iAP-PI)

Quais os pré-requisitos técnicos de adesão?

Infraestrutura para integração com a PI

Existem atualmente dois modelos de ligação entre as entidades aderentes e a Plataforma de Integração, de modo a garantir a segurança dos sistemas de informação e da informação que circula entre a Plataforma de Integração e as entidades, são eles:

  • Circuito dedicado: modelo de ligação mais oneroso, mas com maior segurança e mais adequado para ligações que requerem elevado volume de tráfego e garantia de qualidade de serviço. Os custos da ligação dedicada são suportados pela entidade aderente;

  • VPN sobre Internet: modelo de ligação em que a segurança da informação é garantida através da transmissão por canais cifrados e pela autenticação dos pacotes que circulam garantindo, igualmente, a integridade e privacidade dos dados. Neste modelo de ligação não é possível assegurar o nível de serviço (largura de banda). No entanto, não implica investimento das entidades aderentes.

É igualmente necessário existirem regras de redes que permitam a comunicação entre os sistemas de informação na Entidade e os sistemas da Plataforma de Interoperabilidade, utilizando o protocolo HTTP.

A utilização de certificado digital para suporte a comunicação segura (HTTPS) é opcional.

Ligação VPN

Os requisitos necessários para a ligação VPN à Plataforma de Interoperabilidade são:

  • Acesso à Internet, com largura de banda disponível suficiente para assegurar a ligação em boas condições de funcionamento;

  • Um endereço IP público, com conectividade para qualquer destino da Internet, para assegurar a criação do túnel Internet Protocol Security (IPSec);

  • Suporte de protocolos e funcionalidades no equipamento de estabelecimento da VPN de acordo com as definições que serão providenciadas durante o processo de adesão;

O equipamento deverá suportar o envio de keepalives de Dead Peer Detection e deverá ter a capacidade de manter e renegociar automaticamente as Security Associations (SAs) de IPSec, mesmo na ausência de tráfego.

Os equipamentos deverão ainda ter capacidade para resolver os problemas de sobreposição de endereçamento que poderão existir entre os diversos clientes no acesso aos servidores da AMA - funcionalidade Network Address Translation (NAT).

Plataforma Tecnológica das entidades aderentes à PI

A Plataforma de Integração está baseada no modelo de comunicação assíncrono. As entidades asseguram o presente modelo e os seguintes requisitos na sua arquitetura:

    • Binding Soap 1.1 ou 1.2;

    • XML document-style;

  • Implementação assíncrona (one-way);

  • Canal de transporte HTTP;

  • Utilização opcional de HTTPS;

  • Utilização opcional de autenticação http basic auth;

Comunicação Síncrona / Assíncrona

Dada a natureza dos pedidos, e tendo em conta possíveis demoras na entrega de resposta, é necessário compreender se as respostas aos pedidos são fornecidas de forma síncrona, obtendo a resposta diretamente ou se de forma assíncrona, com um acknowledge do pedido original e envio de resposta em callback a um endereço a disponibilizar por parte da PIataforma de Integração.

Autenticação

Dado o requisito de conetividade via VPN, a autenticação é opcional. No entanto, se a entidade assim o entender, poderá implementar Basic Authentication no seu serviço.

Desenvolvimento do serviço

No âmbito de configuração de serviços e processos a serem integrados com a Plataforma de Integração, e de acordo com as necessidades, será necessário que a entidade aderente disponibilize:

  • WSDL do serviço a consumir pela Plataforma de Integração, respeitando as recomendações WS-I BP 1.1;

  • Caso a entidade pretenda que o serviço exposto ou consumido utilize um modelo de dados específico, necessitará de proceder à disponibilização desse Modelo de Dados (baseado em XSD), bem como as regras de normalização entre ambos os modelos de dados canónico e o modelo de dados específico.

Estas regras serão baseadas em XSLT.

No caso de um serviço fornecido (serviço novo a disponibilizar pela entidade ou para aceder a um serviço existente) é necessário entregar à equipa da Plataforma de Interoperabilidade da Administração Pública: o modelo de comunicação, análise funcional ou diagrama de sequência do processo ao qual o serviço se encontra associado.

No que diz respeito à integração orientada a serviços são aqui incluídas as normas respeitantes aos Web Services que são suportadas pelas Entidades visadas:

  • A norma XML é utilizada na especificação do Web Service que é invocado para executar uma determinada tarefa ou um conjunto de tarefas e assim obter um resultado específico. O XML é usado como linguagem de base para a especificação dos principais padrões que estruturam os web services:

    • WSDL – Web Service Description Language

    • SOAP – Simple Object Access Protocol

  • Nesse âmbito, a descrição de um web servisse é efetuada através de uma estrutura WSDL que contém os detalhes de interação que é possível estabelecer com o respetivo serviço. Esta descrição contém o formato das mensagens trocadas e os respetivos protocolos de transporte. A comunicação entre os vários web services e as entidades que os invocam é regrada pelo protocolo SOAP que descreve o seu modo de interação.

A utilização do protocolo SOAP na Plataforma de Integração é suportada sobre transporte em HTTP (ou HTTPS de forma opcional), que é um protocolo independente e compatível com qualquer servidor aplicacional. A utilização de SOAP sobre HTTP possui ainda como vantagens o estabelecimento simplificado a nível de regras de infraestrutura em proxies e firewall, para além de ser atualmente considerado um protocolo que é independente do tipo de plataforma ou de linguagem usado nos diferentes sistemas.

PreviousPlataforma de Integração da AP (iAP-PI)NextQual o processo de adesão?

Last updated 2 months ago

Representado via ;

, como forma de correlacionamento de mensagens em modelo de comunicação assíncrona.

Garanta as recomendações WS-Interoperability Basic-Profile 1.1 ()

WSDL 1.1
WS-Addressing v1.0
Interoperability Testing Tools 1.1