Registro do Signer Printer no GrantID
O Signer Printer é um aplicativo para Windows que envia documentos ao Signer a partir da janela de impressão de qualquer programa. As pessoas entram nele com a mesma conta do GrantID que usam no aplicativo web do Signer.
Para isso funcionar, o tenant do GrantID por trás da sua instância do Signer precisa de mais uma aplicação: o registro de login do Signer Printer. Ele é feito uma única vez, à mão, no console do GrantID. Enquanto ele não existir, o Signer Printer informa que a instância não está pronta e indica esta página.
Requisitos
- Signer 2.11.0 ou superior.
- GrantID 4.6.0 ou superior. É a primeira versão que permite registrar uma aplicação sem client secret.
Quem pode fazer o registro
Um Administrador da assinatura do GrantID que contém a aplicação do aplicativo web do Signer.
Versões do GrantID anteriores à 4.11.0 verificam uma permissão mais ampla, de modo que nelas um Gerente da assinatura também consegue criar aplicações. Mesmo assim, quem faz este registro deve ser quem cuida das regras de login do aplicativo web do Signer, já que as duas aplicações precisam ficar iguais (veja abaixo).
Uma segunda porta para o mesmo Signer
O registro de login é uma segunda porta para o mesmo Signer. Quem entra por ele pode enviar documentos em seu próprio nome, como no aplicativo web. Por isso ele precisa ter as mesmas regras de login da aplicação do aplicativo web do Signer: segundo fator, login com certificado digital, e-mail obrigatório e verificado, telefone obrigatório, bloqueio de usuário e claims obrigatórias.
Uma aplicação nova do GrantID começa sem nenhuma dessas regras, e nada no GrantID mantém as duas aplicações iguais. Sempre que você reforçar as regras de login do aplicativo web, reforce também as deste registro.
O segundo fator é o mais importante. Ele fica numa aba própria e só pode ser visto e configurado no console.
Antes de começar
Obtenha dois valores da sua instância do Signer. Abra https://<seu Signer>/api/configuration no navegador (não é preciso entrar) e anote:
clientId: o App-Id da aplicação do aplicativo web do Signer, por exemplosigner. O App-Id do Signer Printer é esse valor seguido de-printer, por exemplosigner-printer.apiName: o escopo da API do Signer, por exemplosigner-api.
Depois, no console do GrantID, abra a aplicação do aplicativo web do Signer (o App-Id igual ao clientId) e deixe-a aberta em outra aba. Você vai copiar várias configurações dela.
Criação do registro
A criação da aplicação leva dois salvamentos. Depois do primeiro, a aplicação já existe, mas exigindo client secret e sem endereço de redirecionamento, então ainda não é possível entrar por ela. Siga direto para o segundo salvamento.
1. Criar a aplicação
No console do GrantID, abra a assinatura e crie uma nova aplicação:
| Campo | Valor |
|---|---|
| Name | Lacuna Signer Printer |
| App-Id | o clientId seguido de -printer, por exemplo signer-printer |
| Type | Code flow |
Salve. A aplicação é aberta.
2. A aba Settings
Configure estes valores na aba Settings. Os nomes são os do console.
| Configuração | Valor |
|---|---|
| Require Client Secret? | desligado |
| Require PKCE? | ligado |
| Allow offline access? | ligado |
| Require consent? | ligado |
| Allow access tokens via browser? | desligado |
| Access Token Type | JWT |
| Access Token Lifetime | 3600 segundos |
| Refresh token expiration type | Sliding |
| Sliding refresh token lifetime | 7776000 segundos (90 dias sem uso encerram a sessão) |
| Refresh Token Lifetime | 31536000 segundos (no máximo um ano) |
| Refresh token usage | One time |
| Redirect | os três endereços abaixo, exatamente como estão escritos |
| Post Logout, CORS Origins, Application Url, Logo Url | vazios |
| Allowed API Scopes | o apiName de /api/configuration |
| Allowed Identification Scopes | os mesmos da aplicação do aplicativo web do Signer |
Os três endereços de redirecionamento, um por linha, exatamente como estão escritos:
http://127.0.0.1:43873/callback
http://127.0.0.1:43874/callback
http://127.0.0.1:43875/callback
O GrantID compara os endereços de redirecionamento caractere por caractere, então qualquer diferença (localhost no lugar de 127.0.0.1, uma / no final) impede o login.
Você pode definir tempos de vida menores para os tokens, se a sua organização exigir. O Signer Printer funciona com qualquer valor.
As duas opções "Front-channel logout session required?" e "Back-channel logout session required?" podem ficar no valor padrão. O registro não tem endereços de logout, então elas não têm efeito.
3. As opções de login
Copie cada uma destas da aplicação do aplicativo web do Signer. Elas ficam em três lugares no console:
- Login Options, na aba Settings: login com certificado digital (habilitar, priorizar, exigir), desabilitar login com senha, modo de digitação da senha, e-mail obrigatório e verificado, telefone obrigatório e verificado, desabilitar cadastro na página de login, provedores de identidade externos e claims obrigatórias.
- Enable user lockout?, em General Settings na aba Settings.
- O segundo fator, na aba própria Authentication Factors.
Salve a aba Settings e depois a aba Authentication Factors.
Numa aplicação nova, todas essas opções começam desligadas. Numa instância do Signer, cinco delas precisaram ser alteradas para ficar iguais ao aplicativo web: bloqueio de usuário, login com certificado digital, e-mail obrigatório, e-mail verificado e telefone obrigatório. Confira cada uma em vez de supor que o padrão coincide.
Conferência
Recarregue a aplicação no console e confira cada valor com as tabelas acima. Depois entre pelo Signer Printer: o navegador abre a página de login do GrantID e, após o login, uma página de consentimento mostra "Lacuna Signer Printer".
Alterações futuras
Mantenha os valores desta página como estão. Todo Signer Printer depende deles, e uma versão futura só pedirá uma alteração se não houver como evitá-la; as notas da versão vão informar.
A única alteração que sempre cabe a você: quando as regras de login do aplicativo web do Signer mudarem, faça a mesma mudança aqui.