Ambiente para homologação de integração com o SerproID¶
O PSC SerproID 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¶
- Obter os certificados da cadeia de homologação
- 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 SerproID de usuário final.
Solicitação¶
Segue abaixo link para solicitação dos pedidos de certificado na autoridade certificadora de homologação:
- Certificado SSL para auto-cadastro de aplicação
- Certificado SerproID de usuário final
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 SerproID 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 SerproID.
Aplicação móvel SerproID
Baixe aqui o APK de homologação da aplicação móvel SerproID 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://hom.serproid.serpro.gov.br/oauth/v0/oauth/authorize |
| Token de acesso | https://hom.serproid.serpro.gov.br/oauth/v0/oauth/token |
| Assinatura digital | https://hom.serproid.serpro.gov.br/oauth/v0/oauth/signature |
| Localização de titular | https://hom.serproid.serpro.gov.br/oauth/v0/oauth/user-discovery |
| Recuperação de certificado | https://hom.serproid.serpro.gov.br/oauth/v0/oauth/certificate-discovery |
| Auto-cadastro de aplicação | https://hom.serproid.serpro.gov.br/oauth/v0/oauth/application_cert |
| Token de acesso de aplicação | https://hom.serproid.serpro.gov.br/oauth/v0/oauth/client_token |
| Manutenção de aplicação | https://hom.serproid.serpro.gov.br/oauth/v0/oauth/client_maintenance |