Ambiente para homologação de integração com o SerproID¶
O PSC SerproID disponibiliza um ambiente para homologação do processo de integração com a API do SerproID. Neste ambiente é possível simular todos os procedimentos necessários.
Passos para integração em ambiente de HOMOLOGAÇÃO¶
- Obter o certificado SerproID de homologação
- Gerar as credenciais de aplicação em homologação
- Integrar a aplicação utilizando os endpoints do ambiente de homologação
Obter o certificado SerproID de homologação¶
- Preencha o formulário disponibilizado no link abaixo para solicitar o certificado SerproID
IMPORTANTE!! Após a solicitação do certificado digital **não** é necessário realizar a etapa de Agendamento.
Aprovação¶
Para realizar a aprovação das solicitações de certificado, deve ser aberto um Acionamento de Solicitação de Aprovação, informando o Assunto "Homologação - Aprovação de solicitação". com a seguinte sugestão de texto:
Solicito a aprovação da solicitação de certificado SerproID de homologação.
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>
Instalação¶
Após a aprovação do certificado SerproID de homologação você receberá um e-mail com a confirmação da aprovação.
Aplicação móvel SerproID - Android
Baixe aqui o APK de homologação da aplicação móvel SerproID no sistema operacional Android
Aplicação móvel SerproID - iOS
Baixe aqui o IPA de homologação da aplicação móvel SerproID no sistema operacional iOS, a partir do TestFlight
Gerar as credenciais de aplicação¶
Para gerar as credenciais de aplicação de homologação é necessário realizar o Cadastro da Aplicação. Após o cadastro você receberá um e-mail com as credenciais de aplicação.
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 |