Ir para o conteúdo

Ambiente para homologação de integração com o NeoID

O PSC NeoID disponibiliza um ambiente para que os desenvolvedores de aplicações realizem a homologação da integração antes de utilizarem o ambiente de produção. Neste ambiente é possível simular todos os procedimentos necessários para a integração.


Passos para integração

  1. Obter os certificados da cadeia de homologação
  2. Integrar a aplicação utilizando os endpoints do ambiente de homologação

Certificados da cadeia de homologação

O ambiente de homologação utiliza uma cadeia de certificação de homologação mantida pelo SERPRO. O desenvolvedor deverá utilizar essa cadeia para gerar os certificados utilizados no processo: de equipamento SSL utilizado para o auto-cadastro da aplicação e o NeoID de usuário final.

Solicitação

Segue abaixo link para solicitação dos pedidos de certificado na autoridade certificadora de homologação:

  1. Certificado SSL para auto-cadastro de aplicação
  2. Certificado NeoID de usuário final
    1. Pessoa Física
    2. Pessoa Jurídica

Aprovação

Para realizar a aprovação dos certificados, deve ser feito uma solicitação em https://atendimento.serpro.gov.br/neoid, com a seguinte sugestão de texto:

Solicito a aprovação do pedido de solicitação de certificado para o cliente <informe_nome_cliente>.
O certificado tem a função de homologação de integração com o sistema <informe_nome_sistema>.

Número de Referência do Pedido: <informe_aqui_numero_do_pedido_gerado>
Tipo de Certificado: <informe_tipo_do_certificado_solicitado>
Ambiente da Solicitação: <informe_autoridade_solicitada> Ex.: https://certificadoshom.serpro.gov.br/arserprorfb
Sistema: <informe_nome_sistema>

Instalação

Após a aprovação do certificado NeoID de usuário final, será necessário a sua geração. O procedimento é realizado ao apresentar os dados do pedido na sua primeira instalação no aplicativo móvel do NeoID.

Aplicação móvel NeoID

Baixe aqui o APK de homologação da aplicação móvel NeoID no sistema operacional Android

Endpoints do ambiente de homologação

O ambiente de homologação possui um host diferente dos listados nesta documentação.

Segue abaixo tabela descrevendo os endpoints de homologação dos serviços:

Serviço Endpoint
Código de autorização https://psc-neoid.estaleiro.serpro.gov.br/psc-hom/v0/oauth/authorize
Token de acesso https://psc-neoid.estaleiro.serpro.gov.br/psc-hom/v0/oauth/token
Assinatura digital https://psc-neoid.estaleiro.serpro.gov.br/psc-hom/v0/oauth/signature
Localização de titular https://psc-neoid.estaleiro.serpro.gov.br/psc-hom/v0/oauth/user-discovery
Recuperação de certificado https://psc-neoid.estaleiro.serpro.gov.br/psc-hom/v0/oauth/certificate-discovery
Auto-cadastro de aplicação https://psc-neoid.estaleiro.serpro.gov.br/psc-hom/v0/oauth/application_cert
Token de acesso de aplicação https://psc-neoid.estaleiro.serpro.gov.br/psc-hom/v0/oauth/client_token
Manutenção de aplicação https://psc-neoid.estaleiro.serpro.gov.br/psc-hom/v0/oauth/client_maintenance