Permisos del Connector

Limita el acceso de las aplicaciones conectadas y comprueba las acciones con consecuencias.

En esta página

Los Spaces elegidos y tu rol determinan qué puede hacer una aplicación conectada en TEISENDA. Un Space es un espacio de trabajo compartido en la app.

Elige los Spaces de la conexión

Al conectar, elige los Spaces en La conexión es válida para estos Spaces. Más adelante puedes cambiarlos en Gestionar conexiones.

  • Necesitas al menos un Space o También para los Spaces a los que me una más adelante.
  • Puedes seleccionar Spaces confirmados de los que seas miembro y que no estén programados para eliminarse.
  • Si sales de un Space, la conexión pierde el acceso a él. Al volver a unirte, el acceso puede restablecerse sin un nuevo consentimiento; las condiciones aparecen abajo.
¿Qué significa la opción para Spaces futuros?

Con También para los Spaces a los que me una más adelante, las nuevas pertenencias a Spaces se añaden a la conexión. Si cambias la selección, «futuros» cuenta desde ese momento; un Space desmarcado entonces queda fuera.

¿Qué ocurre si vuelvo a unirme a un Space?

El Space puede volver a formar parte de la conexión sin un nuevo consentimiento si sigue en la selección guardada o se aplica También para los Spaces a los que me una más adelante.

Si has vuelto a guardar la selección de Spaces mientras estabas fuera y esta opción está desactivada, el Space no vuelve automáticamente. Comprueba y cambia la selección de tu conexión.

Cada llamada indica un Space

Las herramientas de hosting requieren en space el ID del Space de diez dígitos. Las instrucciones del Connector piden a la aplicación que lo obtenga de whoami o de tu indicación y que pregunte si hay varios Spaces.

El resultado indica el Space. Compruébalo: si se ha elegido uno incorrecto, las instrucciones piden a la aplicación que se detenga.

TEISENDA comprueba cada llamada a una herramienta

Antes de ejecutarla, la app comprueba la cuenta, la conexión, el Space, la pertenencia, los bloqueos y tu rol. Las herramientas aplican los permisos y los límites de los planes de la app.

Un cambio guardado se aplica como un cambio en TEISENDA. Encontrarás los rechazos en Resolver errores.

Tu rol determina las herramientas permitidas

  • Propietario, Administrador y Usuario pueden llamar a todas las herramientas de hosting.
  • Las personas con el rol Solo lectura pueden llamar a hosting_list_projects, hosting_project_status, hosting_list_deploys, hosting_get_visibility y hosting_list_redirects .
  • whoami y la gestión de tus propias conexiones no requieren un rol concreto en el Space.
¿Por qué veo herramientas que no puedo ejecutar?

La lista de herramientas no depende de tu rol. Incluso las herramientas de lectura de archivos requieren al menos Usuario; si falta el permiso, la app responde con Tu rol en este Space no lo permite..

Comprueba las indicaciones de una herramienta

La referencia de herramientas indica para cada herramienta si lee, elimina o cambia lo que ven los visitantes.

¿Qué significan las indicaciones técnicas?
  • readOnlyHint: lee sin cambiar nada.
  • destructiveHint: elimina, sobrescribe o cambia lo que ven los visitantes.
  • idempotentHint: reconoce una llamada posterior idéntica sin hacer más cambios.
  • openWorldHint: afecta a visitantes, DNS o certificados.

Un cambio puede aplicarse sin preguntar

Atención

Salvo en los tres casos de abajo, las herramientas actúan ya en la primera llamada. La aplicación decide si pide antes tu consentimiento.

hosting_deploy_status también actualiza el estado y puede eliminar definitivamente versiones antiguas al hacerlo. hosting_create_upload proporciona una dirección donde un archivo comprimido sustituye todo el borrador.

Tres herramientas requieren una frase de confirmación

La primera llamada sin confirm no cambia nada. Comprueba el proyecto, el Space y las consecuencias; solo una segunda llamada con la frase devuelta ejecuta la acción.

HerramientaConfirmación necesaria
hosting_delete_projectsiempre
hosting_remove_domainsiempre
hosting_set_visibilityal cambiar de privado a público

Ninguna herramienta de hosting trabaja en un Space bloqueado

whoami sigue mostrando los Spaces bloqueados. Así puedes quitar cada bloqueo:

  • Space sin confirmar: abre el enlace de confirmación del correo.
  • Programado para eliminarse: la persona que pidió eliminarlo restaura el Space.
  • Bloqueado por TEISENDA: contacta con soporte.

Finaliza una conexión en TEISENDA

Atención

No puedes deshacer la finalización. Para volver a usar la aplicación, debes conectarla de nuevo.

Finaliza la conexión en Gestionar conexiones. También puede finalizar si la aplicación revoca su sesión o esta caduca.

¿Basta con eliminar el Connector de la aplicación?

Con ChatGPT, la conexión de TEISENDA puede finalizar; con Claude, puede mantenerse. Compruébala en TEISENDA y finalízala allí si es necesario.

Vuelve a conectar si la sesión ha caducado

Tras 60 días sin uso, TEISENDA muestra la conexión como no utilizada. La sesión de la aplicación se puede renovar hasta 60 días después de su última renovación. Si ha caducado, vuelve a conectar la aplicación.

Los bloqueos pueden interrumpir el acceso

Una cuenta programada para eliminarse ya no trabaja mediante el Connector. Un Space bloqueado permanece en la conexión, pero sus herramientas no funcionan.

Continúa