Pular para o conteúdo principal

Configuração do Gecert Connect no servidor - GeCert

O Gecert Connect lê do servidor GeCert, sem autenticação, o endereço a usar e os dados para o login pelo GrantID. Esses dados ficam na seção GecertConnect da configuração do servidor.

Aplicação do Gecert Connect no GrantID​

O Gecert Connect faz o login pelo OpenID Connect com os escopos openid, profile, offline_access e o escopo da API do GeCert (o mesmo ApiName da configuração de OpenID Connect). Ele precisa de uma aplicação própria no GrantID, diferente da aplicação da interface web, com:

  • o fluxo authorization code com PKCE, próprio de aplicativos nativos;
  • acesso offline permitido, para que o aplicativo receba um refresh token e renove a sessão sem pedir a senha de novo;
  • o escopo de API do GeCert entre os escopos de API permitidos;
  • uma URI de redirecionamento. O Gecert Connect intercepta a navegação para essa URI dentro da própria janela de login, de modo que ela não precisa responder: pode ser, por exemplo, https://endereco-do-seu-gecert/gecert-connect/callback.

Crie a aplicação no console do GrantID como descrito na configuração de OpenID Connect, anotando o App-id dela.

Seção GecertConnect​

  • ServerUrl: o endereço público da instância do GeCert, que o Gecert Connect passa a usar, por exemplo https://gecert.suaempresa.com.br/
  • GrantIdAuthority: a autoridade OIDC do GrantID (o mesmo valor de Oidc:Authority)
  • GrantIdClientAppId: o App-id da aplicação do Gecert Connect no GrantID
  • GrantIdApiName: o nome da API do GeCert no GrantID (o mesmo valor de Oidc:ApiName)
  • GrantIdRedirectUri: a URI de redirecionamento registrada na aplicação do Gecert Connect
  • MinSupportedVersion (opcional): a menor versão do Gecert Connect aceita pelo servidor. Aplicativos mais antigos mostram a tela Atualização Necessária e param de funcionar até serem atualizados. O padrão é 1.1.0.0
  • UnderMaintenance (opcional): True para colocar o Gecert Connect em modo de manutenção: o aplicativo para de chamar o servidor, mostra a tela de manutenção e volta sozinho quando o valor for False. O padrão é False

Os cinco primeiros valores são obrigatórios para o Gecert Connect: enquanto algum faltar, a rota GET /api/app-configuration/gecert-connect/server responde com o erro GecertConnectServerNotConfigured, e o aplicativo mostra Erro ao configurar o servidor.

Exemplo (arquivo de configuração .ini ou .conf):

[GecertConnect]
ServerUrl=https://gecert.suaempresa.com.br/
GrantIdAuthority=https://login.id.patorum.com
GrantIdClientAppId=gecert-connect
GrantIdApiName=gecert
GrantIdRedirectUri=https://gecert.suaempresa.com.br/gecert-connect/callback
MinSupportedVersion=1.2.0.0

Exemplo (variáveis de ambiente):

GecertConnect__ServerUrl=https://gecert.suaempresa.com.br/
GecertConnect__GrantIdAuthority=https://login.id.patorum.com
GecertConnect__GrantIdClientAppId=gecert-connect
GecertConnect__GrantIdApiName=gecert
GecertConnect__GrantIdRedirectUri=https://gecert.suaempresa.com.br/gecert-connect/callback
GecertConnect__MinSupportedVersion=1.2.0.0

Distribuindo a configuração aos usuários​

Depois de configurar o servidor, envie aos usuários o link de configuração, que eles abrem com o Gecert Connect instalado:

gecertconnect://server/gecert.suaempresa.com.br

O aplicativo consulta o servidor, guarda a configuração e confirma com a mensagem Servidor configurado. Veja Configuração do servidor.

Veja também​

Ver em Markdown