Mudanças entre as edições de "Integração"
| Linha 15: | Linha 15: | ||
==Como utilizar== | ==Como utilizar== | ||
| − | Após a liberação de acesso às APIs pela Gennera, o [[administrador do sistema]] | + | Após a liberação de acesso às APIs pela Gennera, sugere-se que o [[administrador do sistema]] crie um novo usuário (específico para o desenvolvedor WEB) e conceda as permissões de acesso aos dados da Instituição. |
| − | De posse de seu login e senha, | + | De posse de seu login e senha, este usuário deverá acessar o sistema educacional da Gennera (Menu:'''''Utilitário\ Integração\ Webservice-Acesso por Usuário''''' ou '''''Segurança\ WebService - Acesso Por Usuário''''') e gerar o [[Token | TOKEN]] de acesso. |
| − | O usuário | + | O usuário deverá seguir as orientações de uso encontradas na documentação técnica das APIs disponível em http://api.gennera.com.br/. |
Esta documentação contém descrições sobre: | Esta documentação contém descrições sobre: | ||
| Linha 29: | Linha 29: | ||
==Responsabilidade e segurança== | ==Responsabilidade e segurança== | ||
| − | O [[Token | TOKEN]], | + | O [[Token | TOKEN]], gerado pelo usuário terá o nível de permissão de acesso conforme autorizado pelo administrador do sistema no momento da criação deste usuário. Ou seja, todos os dados que o respectivo usuário (desenvolvedor WEB) estiver autorizado a acessar no sistema, estarão visíveis aos serviços das APIs que utilizarem o TOKEN. |
| − | |||
| − | |||
| + | Portanto, os administradores do sistema, assim como os demais que cuidam do acesso dos usuários ao sistema da Gennera, deverão tomar todos os cuidados necessários com a criação e permissão de acesso de usuários que poderão gerar os TOKENS. Bem como os usuários/desenvolvedores WEB deverão ser responsáveis pelo seu TOKEN assim como o são com suas SENHAS. | ||
[[Categoria:Educação Corporativa]] | [[Categoria:Educação Corporativa]] | ||
Edição das 14h37min de 3 de junho de 2015
Integração significa trabalho em parceria ou de forma colaborativa entre duas partes.
Em termos de software, integrações dizem respeito a dois ou mais sistemas que "trocam" ou "transferem" dados entre si.
A transferência de dados entre o sistema educacional da Gennera e outros aplicativos utilizados pelas instituições de ensino ocorre através de APIs (Application Programming Interface) na arquitetura REST (Representational State Transfer).
As APIs fornecidas pela Gennera permitem acesso aos dados contidos no banco de dados da instituição através de programação. Portanto, sua utilização requer conhecimento técnico de desenvolvimento WEB.
Como solicitar
As integrações são comercializadas separadamente, desta forma, caso haja interesse, deverá ser aberto um chamado no GSAG - Serviço de Atendimento Gennera para que sejam analisadas a disponibilidade, a viabilidade de implementação, os prazos e os valores para realização deste serviço.
Caso os serviços solicitados já estejam disponíveis, a Gennera irá liberar o acesso da instituição ao menu de integração do sistema, após aprovação.
Como utilizar
Após a liberação de acesso às APIs pela Gennera, sugere-se que o administrador do sistema crie um novo usuário (específico para o desenvolvedor WEB) e conceda as permissões de acesso aos dados da Instituição.
De posse de seu login e senha, este usuário deverá acessar o sistema educacional da Gennera (Menu:Utilitário\ Integração\ Webservice-Acesso por Usuário ou Segurança\ WebService - Acesso Por Usuário) e gerar o TOKEN de acesso.
O usuário deverá seguir as orientações de uso encontradas na documentação técnica das APIs disponível em http://api.gennera.com.br/.
Esta documentação contém descrições sobre:
- os serviços disponíveis;
- as formas de acesso;
- as entidades relacionadas;
- exemplos de utilização.
Responsabilidade e segurança
O TOKEN, gerado pelo usuário terá o nível de permissão de acesso conforme autorizado pelo administrador do sistema no momento da criação deste usuário. Ou seja, todos os dados que o respectivo usuário (desenvolvedor WEB) estiver autorizado a acessar no sistema, estarão visíveis aos serviços das APIs que utilizarem o TOKEN.
Portanto, os administradores do sistema, assim como os demais que cuidam do acesso dos usuários ao sistema da Gennera, deverão tomar todos os cuidados necessários com a criação e permissão de acesso de usuários que poderão gerar os TOKENS. Bem como os usuários/desenvolvedores WEB deverão ser responsáveis pelo seu TOKEN assim como o são com suas SENHAS.
