Credenciales de terceros
Transloadit puede exportar archivos a tu bucket en la nube o servidor. Para autenticarnos, necesitaremos 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 credentials
de Robot. Puedes consultar la
documentación de cada Robot para obtener más información.
El uso de credenciales de Template es completamente opcional.
Creamos las credenciales de Template para que puedas:
- Disfrutar de mayor cifrado y protección (para ver las credenciales, es necesario volver a ingresar la contraseña).
- Reutilizar fácilmente tus credenciales en varios Templates.
- Compartir fácilmente Templates con nosotros sin tener que ocultar las credenciales cada vez.
- 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:
{
"steps": {
"imported": {
"robot": "/s3/import",
"credentials": "my_s3_credentials",
"path": "/some/path"
},
"exported": {
"robot": "/youtube/store",
"use": "imported",
"credentials": "my_youtube_credentials"
}
}
}
Cómo crear credenciales de Template
- Ve a la página de Credenciales de tu Workspace.
- Elige tu proveedor de nube en el menú desplegable de la parte superior de la página y completa todos los campos de nombres de buckets, claves e información secreta.
- Asigna un nombre a tus credenciales de Template para usarlas como referencia en el futuro en tus Templates y presiona Guardar.
Ahora puedes establecer el nombre como la propiedad credentials en tu
Robot de exportación.
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.
- 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.
- En Authentication, abre Generate Access Token y selecciona Authenticated (you).
- Selecciona Public, Private y Video Files (
public,privateyvideo_files). Para usar también/vimeo/store, selecciona Upload, Edit e Interact (upload,editeinteract) y asegúrate de que tu app tenga acceso de subida a Vimeo. - 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 Vimeo Access Token.
- Guárdala con un nombre reconocible y usa ese nombre como valor de
credentialsen tu Robot.
Al guardar se comprueban tu cuenta de Vimeo y los permisos del token. El token se almacena como
access_token y nunca vuelve a mostrarse en la Console. Las descargas 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. Consulta la guía de tokens de Vimeo.
Volver a conectar Vimeo
Actualizar no reinicia OAuth ni concede permisos adicionales. Elimina la credencial de Template y créala de nuevo con el mismo nombre para que tus Templates sigan haciendo referencia a ellas. Al eliminar una credencial de Template 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. En el caso poco probable de que Transloadit se vea comprometido, queremos que el peor escenario sea que un hacker almacene algunos archivos adicionales en tu bucket.