Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Totvs custom tabs box
tabsPré-requisitos,Instalação,Configuração,Utilização
idsprerequisitos,instalacao,configuracao,utilizacao
Totvs custom tabs box items
defaultyes
referenciaprerequisitos

Para implantação da API OAuth2 é necessário:

  1. Sistema operacional 64 bits compatível (Linux/Microsoft Windows);
  2. Servidor web Apache 64 bits versão 2.4 (versão homologada: 2.4.47 e superiores);
  3. Servidor Redis versão 3.2 (versão homologada: 3.2.100 e superiores)
  4. 512 MB de memória RAM (mínimo);
  5. Processador 1,6 GHz (mínimo) e;
  6. 25 MB de espaço disponível em disco.
Totvs custom tabs box items
defaultno
referenciainstalacao
Totvs custom tabs box
tabsLinux,Microsoft Windows
idslinux,windows
Totvs custom tabs box items
defaultyes
referencialinux

A instalação da API em sistemas operacionais Linux depende, em todos os casos, da distribuição adotada. Em distribuições baseadas na distribuição Ubuntu, é necessário disponibilizar a API no diretório /usr/lib/apache2/modules, conforme imagem abaixo:

Além disso, é necessário criar os arquivos authentication.loadauthentication.conf no diretório /etc/apache2/mods-available, conforme imagem abaixo:

O conteúdo do arquivo authentication.load é:

Bloco de código
titleArquivo authentication.load
LoadModule authentication_module modules/mod_authentication.so

Já o conteúdo do arquivo authentication.conf é:

Bloco de código
titleArquivo authentication.conf
<IfModule authentication_module>
  <Location /api/sara/authentication/v1>
    SetHandler mod_authentication-handler
  </Location>
</IfModule>

Configuradas as opções de carregamento da API através do servidor web Apache, é necessário criar o arquivo de configuração da API em /etc/authentication/authentication.conf conforme indicado abaixo:

Bloco de código
# Este é o arquivo de configuração da API de autenticação OAuth2 do 
# ecossistema Recintos Aduaneiros. Assim como o arquivo de configuração
# do Apache, as configurações aqui seguem o padrão "chave valor",
# sendo assim, tanto chaves quanto valores contém uma única palavra.
#
# Comentários podem ser feitos adicionando o símbolo # como primeiro
# caractere da linha. Isso também pode ser utilizado para desativar
# configurações.

# Definições de acesso ao banco de dados 
#
# DriverID: Driver utilizado para a conexão com o banco de dados
# Server: Nome do servidor onde a instância do banco de dados está instalada
# Port: Porta pela qual o banco de dados pode ser acessado
# Name: Nome do banco de dados a ser acessado
# User: Nome do usuário de acesso ao banco de dados
# Password: Senha usada pelo usuário para acesso ao banco de dados (criptografada)
# Charset: Conjunto de caracteres utilizado pelo banco de dados

CharSet SQL_Latin1_General_CP1_CI_AS
DriverID MSSQL
Database sara_db
Hostname NOME_DO_HOST\NOME_DA_INSTANCIA
Password SENHA_DO_USUARIO
Port 1433
Username NOME_DO_USUARIO

# Definições de parâmetros de sessão
#
# TokenTTL: Tempo de vida do token gerado pela API, em minutos
# RefreshTokenTTL: Tempo de vida do token de atualização gerado pela API
# CanRefreshBeforeExpirates: Flag que indica se o token de sessão pode ser atualizado antes da expiração
#
TokenTTL 20
RefreshTokenTTL 5
CanRefreshBeforeExpirates false

Com as configurações efetivadas, é necessário ativar o módulo da API através do comando abaixo:

sudo a2enmod authentication

E reiniciar o servidor web Apache através do comando abaixo:

$ sudo service apache2 restart


04. DEMAIS INFORMAÇÕES

Para maiores informações acerca do protocolo OAuth2, o artigo disponível aqui traz informações mais abrangentes sobre o assunto.

...