# Manual de Administração do Hermes

## Hermes.IFPE

Hermes é um sistema de emissão e validação de certificados emitidos pelo IFPE.

### Administração do Hermes

Primeiramente acesse a \[página de administração\](https://hermes.ifpe.edu.br/admin/) do Hermes e logue utilizando suas credenciais do LDAP. Uma vez logado, se tem acesso às entidades que norteiam o sistema, conforme imagem abaixo:

![](https://wiki.ifpe.edu.br/uploads/images/gallery/2019-01-Jan/scaled-840-0/image-1547228146206.png)

- **Api accesss:** Tokens de acesso para sistemas externos ao Hermes, que enviam dados através de um endpoint;
- **Documents**: Documentos que representam o certificado em si. São identificados por um token UUID;
- **Metas**: Metadados atribuídos aos Documents. Estes são os dados que preenchem os Documents em si;
- **Permissions**: Permissões de acesso dos usuários ao preenchimento de um determinado tipo de Document;
- **Report types**: Representa o tipo do Document em si;
- **Sources**: Representa o sistema externo que pode criar Documents no Hermes;
- **Templates**: Representa a estrutura do formulário de preenchimento dos dados de um determinado Document;

#### Cadastro de Novos Modelos

Para realizar as etapas seguintes, presume-se que o desenvolvedor realizou a confecção do modelo do certificado no JasperStudio e tenha feito a importação do mesmo no Jasper Server.

Antes de tudo, crie um novo **Source** e depois um novo **Api access**. Logo após isso, o associe ao **Source** criado anteriormente.

##### Report Type

Crie um novo Report Type. Informe seu nome, Source, URL do PDF proveniente do JasperServer, Meta Key do E-mail e Meta Key do Nome, conforme exemplo abaixo:

![](https://wiki.ifpe.edu.br/uploads/images/gallery/2019-01-Jan/scaled-840-0/image-1547229344962.png)

Os campos relativos às meta keys, representam os nomes das entidades Meta que contém os dados de e-mail e nome da pessoa que receberá o certificado. Estas informações são essenciais para o envio de certificados por e-mail.

Salve o report type.

##### Templates

Cada instância de Template representa um campo do formulário de preenchimento do certificado. Há três possíveis tipos destes campos: String, Date e Email.

Crie um novo campo do Template e o associe ao Report type criado, conforme exemplo:

![](https://wiki.ifpe.edu.br/uploads/images/gallery/2019-01-Jan/scaled-840-0/image-1547230601549.png)

O campo **Key** deve sempre ser iniciado com o prefixo "META\_". Este nome é basicamente o nome do parâmetro correspondente a um campo, definido no Jasper Studio.

##### Permission

Após criar todos os campos campos do certificado, é hora de dar permissão de acesso ao preenchimento do certificado. Para isso, cria-se uma instância de Permission, onde se associa o Report type a um usuário do sistema, de acordo com seu CPF, conforme exemplo:

![](https://wiki.ifpe.edu.br/uploads/images/gallery/2019-01-Jan/scaled-840-0/image-1547230881593.png)

Salve a permissão.

#### Preenchendo o Certificado

Após configurar todo o certificado, acesse o endereço \[[https://hermes.ifpe.edu.br/dashboard/\](](https://hermes.ifpe.edu.br/dashboard/%5D()[https://hermes.ifpe.edu.br/dashboard/)](https://hermes.ifpe.edu.br/dashboard/)) e selecione o Report type que foi criado anteriormente, e clique em "Avançar":

![](https://wiki.ifpe.edu.br/uploads/images/gallery/2019-01-Jan/scaled-840-0/image-1547231069244.png)

O formulário de preenchimento, gerado a partir dos Meta criados, será apresentado:

![](https://wiki.ifpe.edu.br/uploads/images/gallery/2019-01-Jan/scaled-840-0/image-1547231944080.png)

Agora, para gerar o certificado basta preencher seus dados e clicar em "Gerar Token". Um identificador UUID será gerado para o certificado e enviado para o usuário, de acordo com seu e-mail cadastrado.