Permissões e acesso do Connector
Verifique os Spaces, a função e as consequências antes de uma chamada de ferramenta.
Nesta página
Os Spaces escolhidos e a sua função determinam o que uma aplicação ligada pode fazer na TEISENDA. Um Space é uma área de trabalho partilhada na app.
Escolha os Spaces da ligação
Ao ligar, escolha os Spaces em A ligação aplica-se a estes Spaces. Mais tarde, altere-os em Gerir ligações.
- Precisa de pelo menos um Space ou de Também para os Spaces a que me juntar mais tarde.
- Pode selecionar Spaces confirmados a que pertence e que não estejam marcados para eliminação.
- Se sair de um Space, a ligação perde o acesso a ele. Se voltar a aderir, o acesso pode regressar sem novo consentimento; as condições estão abaixo.
O que significa a opção de Spaces futuros?
Com Também para os Spaces a que me juntar mais tarde, as adesões futuras são adicionadas à ligação. Se alterar a seleção, o futuro conta a partir desse momento; um Space então desmarcado continua excluído.
O que acontece se voltar a aderir a um Space?
O Space pode voltar a pertencer à ligação sem novo consentimento se ainda constar da seleção guardada ou se Também para os Spaces a que me juntar mais tarde se aplicar.
Se voltou a guardar a seleção de Spaces enquanto não era membro e esta opção está desativada, o Space não regressa automaticamente. Verifique e altere a seleção da ligação.
Cada chamada indica um Space
As ferramentas de alojamento exigem a Space-ID de dez dígitos em space. As instruções do Connector pedem à aplicação que a obtenha de whoami ou da sua indicação e que pergunte se houver vários Spaces.
O resultado indica o Space. Verifique-o: se a escolha estiver errada, a aplicação deve parar conforme as suas instruções.
A TEISENDA verifica cada chamada de ferramenta
Antes da execução, a app verifica a conta, a ligação, o Space, a adesão, os bloqueios e a função. As ferramentas aplicam as permissões e limites dos planos da app.
Uma alteração guardada aplica-se como uma alteração na TEISENDA. As rejeições estão explicadas em Resolver problemas.
A sua função determina as ferramentas permitidas
- Proprietário, Administrador e Utilizador podem chamar todas as ferramentas de alojamento.
- Apenas leitura podem chamar
hosting_list_projects,hosting_project_status,hosting_list_deploys,hosting_get_visibilityehosting_list_redirects. whoamie a gestão das suas próprias ligações não exigem uma função específica no Space.
Por que vejo ferramentas que não posso chamar?
A lista de ferramentas é independente da função. Mesmo as ferramentas de leitura de ficheiros exigem pelo menos Utilizador; se faltar permissão, a app responde com A sua função neste Space não o permite..
Verifique as indicações de uma ferramenta
A referência de ferramentas indica, para cada ferramenta, se lê, elimina ou altera o que é visível.
O que significam as indicações técnicas?
readOnlyHint: lê sem alterar nada.destructiveHint: elimina, substitui ou altera o que os visitantes veem.idempotentHint: reconhece uma chamada seguinte igual sem fazer mais alterações.openWorldHint: produz efeitos sobre visitantes, DNS ou certificados.
Uma alteração pode aplicar-se sem confirmação
Atenção
Exceto nos três casos abaixo, as ferramentas executam logo na primeira chamada. A aplicação decide se pede antes o seu consentimento.
hosting_deploy_status também consulta o estado e pode eliminar definitivamente versões antigas nesse processo. hosting_create_upload fornece um endereço através do qual um arquivo substitui todo o rascunho.
Três ferramentas exigem uma frase de confirmação
Na primeira chamada sem confirm, nada muda. Verifique o projeto, o Space e a consequência; só uma segunda chamada com a frase devolvida executa a ação.
| Ferramenta | Confirmação necessária |
|---|---|
hosting_delete_project | sempre |
hosting_remove_domain | sempre |
hosting_set_visibility | na mudança de privado para público |
Nenhuma ferramenta de alojamento trabalha num Space bloqueado
whoami continua a mostrar Spaces bloqueados. Como remover cada bloqueio:
- Space por confirmar: abra a ligação de confirmação do e-mail.
- Marcado para eliminação: a pessoa que o eliminou restaura o Space.
- Bloqueado pela TEISENDA: contacte o suporte.
Termine uma ligação na TEISENDA
Atenção
Não pode anular o fim de uma ligação. Para voltar a utilizar a aplicação, ligue-a novamente.
Termine a ligação em Gerir ligações. Também pode terminar se a aplicação revogar a autorização ou esta expirar.
Basta remover o Connector da aplicação?
No ChatGPT, a ligação TEISENDA pode terminar; no Claude, pode manter-se. Verifique-a na TEISENDA e termine-a aí se necessário.
Volte a ligar se a autorização expirou
Após 60 dias sem utilização, a TEISENDA indica a ligação como não utilizada. A autorização da aplicação pode ser renovada até 60 dias após a última renovação. Se tiver expirado, ligue novamente a aplicação.
Os bloqueios podem interromper o acesso
Uma conta marcada para eliminação deixa de trabalhar através do Connector. Um Space bloqueado mantém-se na ligação, mas as suas ferramentas não funcionam.