Executando na AWS

Para executar o Connector com o perfil da AWS basta:

1. 1Abrir o terminal e navegar até a pasta em que o arquivo do Connector foi descompactado.
2. 2Substituir os valores marcados com <…> por suas configurações e executar o comando abaixo.

CLIENT_ID=<Seu clientId criptografado e convertido para base64> \
CLIENT_SECRET=<Seu clientSecret criptografado e convertido para base64> \
CAFFEINE_MAXIMUM_SIZE=100 \
CAFFEINE_EXPIRE_DURATION_MINUTES=20 \
KMS_ENCRYPTION_KEY=<Chave de criptografia KMS> \
KMS_SERVICE_ENDPOINT=<Endereço da chave de chave KMS> \
KMS_SIGNING_REGION=<Região da chave KMS> \
S3_SIGNING_REGION=<Região do bucket> \
S3_SERVICE_ENDPOINT=<Endereço do bucket> \
S3_BUCKET_NAME=<Nome do bucket> \
DYNAMODB_REGION=<Região do DynamoDB> \
DYNAMODB_TABLE=<Nome da tabela DynamoDB> \
SPRING_PROFILES_ACTIVE=production,aws \
./guiabolso_connector_client_1.0.0/bin/application

Você deverá ver uma mensagem no final do console parecida com a exibida abaixo, o que significa que a aplicação está executando e pronta para receber requests na porta 9000.

2020-03-27 12:59:10.797 [main] INFO o.e.jetty.server.AbstractConnector {} - Started
ServerConnector@496401ee{HTTP/1.1,[http/1.1]}{0.0.0.0:9000}
2020-03-27 12:59:10.798 [main] INFO org.eclipse.jetty.server.Server {} - Started @6964ms

Configurações Gerais

• DATAPACKAGES_PATH OPCIONAL Caminho absoluto do arquivo datapackage.yml.

Criptografia das Credenciais

Neste perfil é obrigatório passar variáveis de ambiente KMS que definem o serviço de criptografia usado para criptografar as credenciais de acesso.

• KMS_ENCRYPTION_KEY OBRIGATÓRIO
  ARN (Amazon Resource Name) da chave de KMS usada.
• KMS_SERVICE_ENDPOINT OBRIGATÓRIO
  Endereço do KM, ex: `kms.us-east-1.amazonaws.com`.
• KMS_SIGNING_REGION OBRIGATÓRIO
  Região que a chave de KMS foi criada, ex: `us-east-1`.
• KMS_CACHE_CAPACITY OPCIONAL
  Capacidade do cache, por padrão: 100.
• KMS_CACHE_MAXAGEMINUTES OPCIONAL
  Vida útil máxima em minutos das entradas no cache, por padrão: 30 minutos.
• KMS_CACHE_MESSAGEUSELIMIT OPCIONAL
  Número máximo de entradas que podem ser criptografadas com a mesma chave de dados em cache, por padrão: 1000.

Base para Mapeamento de Tokens

Neste perfil é obrigatório passar variáveis de ambiente DYNAMODB que definem o banco de dados usado no mapeamento de tokens e usuários.

• DYNAMODB_REGION OBRIGATÓRIO
  Região do banco de dados, ex: `us-east-1`.
• DYNAMODB_TABLE OBRIGATÓRIO
  Nome da tabela no DynamoDB.

A tabela criada no DynamoDB deve ter uma primary key chamada "UserId" do tipo String.

Serviço de Cache a Longo Prazo

Neste perfil é obrigatório passar variáveis de ambiente S3 que definem as configurações do bucket para caching de dados a longo prazo.

• S3_SIGNING_REGION OBRIGATÓRIO
  Região que o bucket do S3 foi criado, ex: `us-east-1`.
• S3_BUCKET_NAME OBRIGATÓRIO
  Nome do bucket usado.
• S3_SERVICE_ENDPOINT OBRIGATÓRIO
  Endereço do S3, ex: `s3.us-east-1.amazonaws.com`.
• S3_EXPIRE_DURATION_MINUTES OPCIONAL
  Tempo em minutos de expiração do arquivo no S3, por padrão: 1 minuto.