Integração FTP (File Transfer Protocol)
O CESS possui integração com FTP para leitura dos arquivos originais e escrita dos assinados.
Configuração FTP
Para utilizar as funcionalidades de integração com FTP é necessário configurar uma variável de ambiente chamada "ftpCredentials". Essa variável deverá conter o seguinte json encodado em base64.
Por exemplo, se tivermos o seguinte json: {"server":"<url servidor ftp>","username":"<usuario ftp>","password":"<senha ftp>"}
Deveremos configurar a variável de ambiente como: 'ftpCredentials=eyJzZXJ2ZXIiOiI8dXJsIHNlcnZpZG9yIGZ0cD4iLCJ1c2VybmFtZSI6Ijx1c3VhcmlvIGZ0cD4iLCJwYXNzd29yZCI6IjxzZW5oYSBmdHA+In0='
CESS lendo do FTP
Para o CESS ler o arquivo original do FTP é necessário, além das configuração anterior, especificar duas chaves na criação da transação: "documents_source" : "FTP_STORAGE" e no documents[] {"data": "nome_do_objeto_no_repositorio_ftp".
Por exemplo, se deseja que seja assinado o arquivo chamado "meu_arquivo.txt", então poderá utilizar o seguinte json como chamada:
CESS escrevendo no FTP
Para o CESS escrever o arquivo assinado no FTP é necessário, além das configuração anterior, especificar duas chaves na criação da transação: "documents_destination" : "FTP_STORAGE" e no documents[] {"destination_file_name": "nome_do_objeto_no_repositorio_ftp" (opcional).
Por exemplo, se deseja que o arquivo assinado seja armazenado com o nome "minha_assinatura.p7s", então poderá utilizar o seguinte json como chamada:
Observação:
Caso não seja definido um valor para variável "destination_file_name", será gerado um aleatório com a seguinte lei de formação: <ano>/<mês>/<dia>/<timestamp>_<numeroAleatório8Dígitos>. Por exemplo: 2020/07/10/1594398391_dc80d9b0.
Quando cliente optar pelo documents_source FTP_STORAGE, deverá passar, caso queira especificar um nome para o objeto, o "destination_file_name" no mesmo nível do "id" e "data". Quando optar pelo UPLOAD_REFERENCE, ele tem a opção de criar a chave "documents[]" e passar o "id" e o "destination_file_name" no mesmo nível; pois quando realizar o upload via rota /file-transferer/<tcn> ocorrerá o match entre o document[id] e o id definido na chave "documents[]' na criação da transação
Last updated