Credenciais de terceiros

A Transloadit pode importar arquivos do seu bucket na nuvem ou do seu servidor ou exportar arquivos para eles. Para autenticar, vamos precisar de credenciais. Para exportações, use credenciais somente de escrita quando possível. Você pode defini-las diretamente nos parâmetros dos seus Robots de importação e exportação (muitas vezes via key e secret), mas recomendamos que você use Credenciais de Template no lugar disso. Com Credenciais de Template, você armazena as credenciais separadamente, atribui a elas um nome único e depois as referencia por esse nome por meio do credentials, um Robot Parameter. Você pode consultar a documentação de cada Robot para mais informações.

Observação

Usar Credenciais de Template é totalmente opcional.

Criamos as Credenciais de Template para que você possa:

Manter os segredos do provedor fora do JSON do Template que você compartilha.
Reutilizar facilmente suas credenciais em vários Templates.
Ser mais liberal ao enviar Assembly Instructions diretamente (sem usar um Template). Embora Templates sejam recomendados, isso permite a prototipagem sem transmitir segredos toda vez.
Revogar credenciais vazadas e substituí-las sem modificar todos os seus Templates ou seu código.
Adicionar tokens. Alguns provedores de nuvem exigem um fluxo OAuth interativo para dar acesso à Transloadit. A interface web das Credenciais de Template permite isso.

Aqui estão Assembly Instructions que usam Credenciais de Template salvas anteriormente na sua conta como my_s3_credentials e my_youtube_credentials. Elas importam vídeos de um bucket S3 e fazem upload deles para o YouTube como vídeos privados:

{
  "steps": {
    "imported": {
      "robot": "/s3/import",
      "credentials": "my_s3_credentials",
      "path": "/some/path"
    },
    "exported": {
      "robot": "/youtube/store",
      "use": "imported",
      "credentials": "my_youtube_credentials",
      "title": "My processed video",
      "description": "A video processed with Transloadit",
      "category": "science & technology",
      "keywords": "transloadit",
      "visibility": "private"
    }
  }
}

Como criar Credenciais de Template

Acesse a página de Credenciais do seu Workspace. Selecione Nova credencial, ou Adicionar nova credencial se você ainda não criou nenhuma.
Escolha o provedor em Serviço. Insira um Nome reconhecível e preencha os campos do provedor.
Selecione Criar. Quando você insere uma chave ou um token diretamente, o Console salva a credencial e retorna à lista de Credenciais. Quando você se conecta por OAuth, ele primeiro redireciona você ao provedor para aprovar o acesso.

Use o nome salvo como valor de credentials no Robot de importação ou exportação apropriado. Para saber os valores obrigatórios e as permissões do provedor, consulte o guia de configuração do Google Cloud Storage, o guia de configuração do DigitalOcean Spaces ou a documentação do Robot correspondente.

As Credenciais de Template autenticam a Transloadit junto ao provedor; elas não autorizam os uploads dos seus usuários. Para uploads pelo navegador baseados na Auth Key, autorize as solicitações no seu backend e use Signature Authentication, mantendo o Auth Secret no servidor. Defina "allow_steps_override": false no Template salvo quando os usuários que fazem uploads não puderem alterar os Steps desse Template.

Vimeo

O OAuth do Vimeo no Console permite uploads com /vimeo/store. O /vimeo/import exige um token de acesso pessoal do seu próprio app do Vimeo. O Vimeo só permite que apps OAuth de parceiros acessem os arquivos de vídeo de outros membros, e a Transloadit não é parceira do Vimeo. Repetir o OAuth não adicionará essa permissão.

Entre em developer.vimeo.com/apps com a conta do Vimeo que possui os vídeos e crie um app ou selecione um app seu já existente.
Em Authentication, abra Generate Access Token e selecione Authenticated (you).
Selecione Public, Private e Video Files (public, private e video_files). Para também usar o token com /vimeo/store, selecione Upload, Edit e Interact (upload, edit e interact) e confirme que seu app tem acesso de upload ao Vimeo.
Gere e copie o token. No Console, crie uma Credencial de Template, selecione Vimeo, escolha Colar um token de acesso pessoal e cole o token em Token de acesso do Vimeo.
Salve com um nome reconhecível e use esse nome como valor de credentials no seu Robot.

Ao salvar, sua conta do Vimeo e os escopos do token são verificados. O token é armazenado como access_token e nunca é exibido novamente no Console. Os downloads de vídeo ainda dependem do seu plano do Vimeo e das permissões do vídeo. O download do original (source) também exige que o Vimeo tenha mantido o upload original. Consulte o guia de tokens do Vimeo.

Reconectar o Vimeo

Atualizar não reinicia o OAuth nem concede escopos adicionais. Para reconectar, remova a credencial com Remover e crie-a novamente com o mesmo nome para que seus Templates continuem fazendo referência a ela. A remoção da credencial do Vimeo revoga o token no Vimeo, incluindo qualquer outro uso do mesmo token. Gere um novo token de acesso pessoal antes de colá-lo novamente. Se a revogação falhar, a remoção também falhará e você poderá tentar de novo. Você também pode substituir o token com Atualizar; deixe o campo do token em branco para manter o token salvo.

Não nos dê as chaves de tudo o que você tem

Levando a sério alguns paradigmas de segurança, queremos ter o mínimo de privilégios possível para fazer nosso trabalho. Se você exporta arquivos para o seu bucket do Amazon S3, por exemplo, é perfeitamente possível criar um usuário IAM que tenha apenas acesso de escrita para isso. Limitar as permissões reduz os danos que uma chave vazada pode causar. Quando um provedor combina acesso de escrita com acesso de leitura ou exclusão, limite a credencial a um bucket dedicado em vez de conceder acesso à sua conta inteira.

» Saiba mais sobre segurança