Credenciales de terceros

Transloadit puede importar archivos desde tu bucket en la nube o servidor, o exportarlos a ellos. Para autenticarnos, necesitaremos credenciales. Para las exportaciones, usa credenciales solo de escritura si es posible. Puedes configurarlas directamente en los parámetros de tus Robots de importación y exportación (a menudo mediante key y secret), pero te recomendamos usar credenciales de Template en su lugar. Con las credenciales de Template, almacenas la credencial por separado, le asignas un nombre único y luego haces referencia a ella por ese nombre mediante el parámetro de Robot credentials. Puedes consultar la documentación de cada Robot para obtener más información.

Creamos las credenciales de Template para que puedas:

• Mantener los secretos del proveedor fuera del JSON del Template que compartes.
• Reutilizar fácilmente tus credenciales en varios Templates.
• Tener más libertad para enviar Assembly Instructions directamente (sin usar un Template). Aunque se recomienda usar Templates, esto permite crear prototipos sin transmitir información secreta cada vez.
• Revocar credenciales filtradas y reemplazarlas sin modificar todos tus Templates ni tu código.
• Agregar tokens. Algunos proveedores de nube requieren un flujo interactivo de OAuth para dar acceso a Transloadit. La interfaz web de las credenciales de Template permite hacerlo.

Estas son Assembly Instructions que usan credenciales de Template guardadas previamente en tu cuenta como my_s3_credentials y my_youtube_credentials. Importan videos desde un bucket de S3 y los suben a YouTube como videos 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"
    }
  }
}

Cómo crear credenciales de Template

1. Ve a la página de Credenciales de tu Workspace. Selecciona Nueva credencial, o Agregar nueva credencial si aún no has creado ninguna.
2. Elige el proveedor en Servicio. Ingresa un Nombre reconocible y completa los campos del proveedor.
3. Selecciona Crear. Cuando ingresas una clave o un token directamente, la Console guarda la credencial y vuelve a la lista de credenciales. Cuando te conectas mediante OAuth, primero te dirige al proveedor para que apruebes el acceso.

Usa el nombre guardado como valor de credentials en el Robot de importación o exportación correspondiente. Para conocer los valores obligatorios y los permisos del proveedor, consulta la guía de configuración de Google Cloud Storage, la guía de configuración de DigitalOcean Spaces o la documentación del Robot correspondiente.

Las credenciales de Template autentican a Transloadit ante el proveedor; no autorizan las subidas de tus usuarios. Para las subidas desde el navegador basadas en una Auth Key, autoriza las solicitudes en tu backend y usa Signature Authentication, manteniendo el Auth Secret en el servidor. Establece "allow_steps_override": false en el Template guardado cuando quienes suben archivos no deban cambiar los Steps del Template guardado.

Vimeo

Vimeo OAuth en la Console permite la subida de archivos con /vimeo/store. /vimeo/import requiere un token de acceso personal de tu propia app de Vimeo. Vimeo solo permite a las apps OAuth de sus socios acceder a los archivos de video de otros miembros, y Transloadit no es socio de Vimeo. Repetir OAuth no añadirá este permiso.

1. Inicia sesión en developer.vimeo.com/apps⁠ con la cuenta de Vimeo propietaria de los videos y crea una app o selecciona una app propia existente.
2. En Authentication, abre Generate Access Token y selecciona Authenticated (you).
3. Selecciona Public, Private y Video Files (public, private y video_files). Para usar también el token con /vimeo/store, selecciona Upload, Edit e Interact (upload, edit e interact) y asegúrate de que tu app tenga acceso de subida a Vimeo.
4. Genera y copia el token. En la Console, crea una credencial de Template, selecciona Vimeo, elige Pegar un token de acceso personal y pégalo en Token de acceso de Vimeo.
5. Guárdala con un nombre reconocible y usa ese nombre como valor de credentials en tu Robot.

Al guardar se comprueban tu cuenta de Vimeo y los ámbitos del token. El token se almacena como access_token y nunca vuelve a mostrarse en la Console. Las descargas de videos siguen dependiendo de tu plan de Vimeo y de los permisos del video. Las descargas del original (source) también requieren que Vimeo conserve el archivo original subido. Consulta la guía de tokens de Vimeo⁠.

Volver a conectar Vimeo

Actualizar no reinicia OAuth ni concede ámbitos adicionales. Para volver a conectar Vimeo, usa Eliminar para eliminar la credencial y créala de nuevo con el mismo nombre para que tus Templates sigan haciendo referencia a ella. Al eliminar una credencial de Vimeo, se revoca su token en Vimeo, incluidos otros usos del mismo token. Genera un nuevo token de acceso personal antes de pegarlo de nuevo. Si la revocación falla, la eliminación también falla y puedes reintentarlo. También puedes reemplazar el token mediante Actualizar; deja el campo del token vacío para conservar el token guardado.

No nos des las llaves de todo

De acuerdo con algunos paradigmas de seguridad, queremos tener la menor cantidad posible de privilegios para realizar nuestro trabajo. Por ejemplo, si exportas archivos a tu bucket de Amazon S3, puedes crear un usuario de IAM que solo tenga acceso de escritura para ese fin. Limitar los permisos reduce el daño que puede causar una clave filtrada. Cuando un proveedor combina el acceso de escritura con el de lectura o eliminación, limita la credencial a un bucket dedicado en lugar de a toda tu cuenta.

» Obtén más información sobre seguridad