Centro de ayuda

Guías paso a paso de cada parte de Ozom: qué hace cada botón, ejemplos reales y qué hacer si algo sale mal.

API keys globalesSolo super-admin

Sin tenant fijo, con todos los permisos — cada llamada decide sobre qué empresa opera.

Todas las API keys normales (ver el artículo "API keys de tu empresa") pertenecen a una sola empresa: solo pueden operar sobre los datos de esa empresa, nunca de otra. Una API key global es distinta: no pertenece a ninguna empresa en particular. Siempre lleva todos los permisos del sistema (no se le puede quitar ninguno; el sistema ni siquiera acepta un intento de crearla con permisos limitados), y quien la usa decide, en cada llamada por separado, sobre cuál empresa quiere actuar.

Esa decisión se indica con un dato técnico llamado header X-Tenant-Id: literalmente, el identificador de la empresa sobre la que quiere operar esa llamada en particular. Sin ese dato, la key global solo alcanza rutas de plataforma (como esta misma sección de Plataforma), no los datos de ninguna empresa específica.

Si alguien usa una key global con un X-Tenant-Id mal escrito (que no tiene el formato correcto de identificador), o que corresponde a una empresa que no existe o está desactivada, el sistema rechaza la llamada con un error explicando cuál de las dos cosas pasó. No se "cae" silenciosamente sobre otra empresa por error.

Trátala como la llave maestra que es

Cualquiera con esta key puede operar CUALQUIER empresa de la plataforma. Solo la creas o revocas tú, con tu propia sesión — no se puede emitir otra key global usando una key global (para que una sola fuga no se auto-replique). Úsala solo para soporte de plataforma o automatización genuinamente cross-tenant (que necesita tocar varias empresas a la vez); para todo lo demás, una key de empresa normal, con permisos acotados a esa sola empresa.

Se crea y revoca desde Plataforma → API keys globales.

Sigue leyendo

¿No resolviste tu duda? Escríbenos y te ayudamos.

Ir a Soporte hola@tupla.dev