Armazenamento em nuvem

O Riversoft® STCP DirectLink troca arquivos com buckets e containers de armazenamento em nuvem. A conexão é sempre iniciada pelo Riversoft STCP DirectLink, que grava e busca objetos no repositório indicado para cada usuário.

Conector	Repositório
Amazon S3	Buckets do Amazon S3 e de serviços compatíveis com a API do S3.
Azure Blob Storage	Containers de uma conta de armazenamento do Azure.
Google Cloud Storage	Buckets do Google Cloud Storage.
Oracle Cloud Object Storage	Buckets do Oracle Cloud Infrastructure (OCI) Object Storage.

Conexões de saída

Envio

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      SA["Diretório saida"] --> C[Conector de nuvem]
    end
    C -->|envio| P[Bucket ou container de envio]

Busca

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      C[Conector de nuvem] --> EN["Diretório entrada"]
    end
    P[Bucket ou container de recebimento] -->|busca| C

Nota

O envio e a busca podem acontecer na mesma conexão: primeiro o Riversoft STCP DirectLink envia os arquivos, depois busca os do parceiro. Conforme o modo configurado no usuário, a conexão pode também só enviar ou só buscar.

O Riversoft STCP DirectLink se conecta ao repositório por agendamento, ou quando o operador inicia a conexão no Riversoft Console Portal. Na mesma conexão, ele:

envia os arquivos disponíveis na caixa postal do usuário (diretório saida) para o bucket ou container de envio;
busca os objetos do bucket ou container de recebimento e os grava no diretório entrada da caixa postal.

Etapa	Comportamento
Envio	Cada arquivo é gravado como um objeto, com o prefixo (pasta) configurado. No Google Cloud Storage, o envio é recusado se já existir um objeto com o mesmo nome.
Busca	Somente os objetos do prefixo e da máscara configurados são buscados.
Depois da busca	O objeto pode ser copiado para um prefixo de backup e, se configurado, removido da origem.

Os buckets ou containers de envio e de recebimento podem ser os mesmos ou diferentes, e cada um tem o seu prefixo.

Autenticação por provedor

Provedor	Formas de autenticação
Amazon S3	Chave de acesso (access key e secret key, com token de sessão opcional); credenciais do ambiente ou de um profile; papel assumido (AssumeRole); IAM Roles Anywhere, com certificado.
Azure Blob Storage	Nome e chave da conta de armazenamento (Shared Key) ou token SAS.
Google Cloud Storage	Chave JSON de uma conta de serviço, ou as credenciais padrão do ambiente.
Oracle Cloud Object Storage	Chave de API: tenancy, usuário, fingerprint e chave privada, com a região do bucket.

No Amazon S3, um endpoint próprio permite usar serviços compatíveis com a API do S3, inclusive no formato de caminho (path-style). O conector também pode verificar se os buckets existem antes de transferir.

O que combinar com o responsável pelo repositório

Item	Descrição
Repositório	Bucket ou container de envio e de recebimento, região e endpoint, quando não for o padrão do provedor.
Prefixos	Pastas de envio, de recebimento e de backup.
Credencial	A forma de autenticação do provedor, com permissão somente para os buckets ou containers usados.
Pós-processamento	Se os objetos buscados devem ser removidos ou copiados para backup.

Esses dados são cadastrados no usuário, no Riversoft Console Portal, junto com o agendamento das conexões.

Segurança

Dê à credencial do conector somente as permissões necessárias nos buckets ou containers usados (leitura, gravação e exclusão, quando houver remoção).
Prefira credenciais temporárias (papel assumido ou IAM Roles Anywhere no Amazon S3, token SAS com validade no Azure Blob Storage).
Guarde as credenciais em um provedor de segredos. Veja KMS e segredos.
As conexões usam HTTPS. Veja Segurança: conectores.

API REST AS2