Hay dos tipos de clave y viven en lugares diferentes. Una clave de proyecto traduce contenido para un sitio. Una clave de espacio de trabajo administra la cuenta. Si un plugin o una integración solicita una clave para traducir, quiere la del proyecto.
La clave de proyecto
Abre el proyecto, luego Configuración de API. La clave está enmascarada hasta que eliges Mostrar clave de API, y Copiar la pone en tu portapapeles.
Esta es la clave que usa el plugin de WordPress y con la que se autentica la API de Traductor. Cada proyecto tiene la suya: una clave de un proyecto no traducirá el sitio de otro proyecto.
Regenerar la reemplaza. La clave antigua deja de funcionar en el momento en que existe la nueva, por lo que cualquier cosa que todavía la use deja de traducir hasta que pegues la nueva. Úsala cuando una clave se haya filtrado, no para organizar.
La clave de espacio de trabajo
Abre el espacio de trabajo, luego Claves de API, luego Crear clave. Estas son claves con ámbito de espacio de trabajo para acceder a la API de Plataforma, que administra idiomas, reglas de glosario, sitios y traducciones almacenadas.
Cuatro diferencias con la clave de proyecto:
- La ves una vez. La clave se muestra cuando la creas y nunca más, así que cópiala en ese momento. Si la pierdes, revócala y crea otra.
- No hay regeneración. Las claves se crean y se revocan. La revocación es inmediata y rompe cualquier cosa que use esa clave, que es lo que la convierte en la respuesta correcta a una filtración.
- Caducan. Caduca en es un campo obligatorio al crear una, que ofrece 30, 90, 180 o 365 días, y 180 es el valor predeterminado. No se puede extender y nada más largo que un año. Una clave caducada devuelve un error de autenticación, así que crea un reemplazo y cámbiala antes de la fecha. Una integración que deja de funcionar aproximadamente seis meses después de haberla creado suele ser esto.
- Solo tienen los permisos que marcas. Los permisos se eligen al crear y no pueden exceder tus propios permisos en ese espacio de trabajo, por lo que una clave creada sin ninguno seleccionado no puede acceder a nada. Dale a una clave lo mínimo que necesita.
Mantener una clave segura
Una clave es una contraseña con tu total de palabras adjunto. Cualquiera que la tenga puede gastarla.
- Mantenla del lado del servidor. Una clave en JavaScript del lado del cliente, en un paquete de aplicación móvil o en un repositorio público es una clave que ha sido entregada.
- No la pegues en un ticket de soporte, una captura de pantalla o un mensaje de chat. Si ya lo hiciste, reemplázala.
- Rota ante sospecha, no por calendario: Regenerar para una clave de proyecto, Revocar para una clave de espacio de trabajo.