Dados e registos do Connector
Que dados são transmitidos e onde fica registada a utilização.
Nesta página
Um Space é uma área de trabalho partilhada na app.
O que a aplicação recebe através do Connector
- o nome TEISENDA, um ícone e o endereço da documentação com que o Connector se apresenta
- as instruções do Connector
- o catálogo das ferramentas
- através de
whoami, o seu nome e, para cada Space da ligação, a Space-ID, o nome, a indicação de que está ou não bloqueado e os seus produtos - o resultado de cada chamada de ferramenta
O resultado de uma ferramenta de alojamento começa pelo Space
Os resultados de alojamento indicam primeiro o Space e uma mensagem no idioma da sua conta; se esse idioma não for suportado, a mensagem está em alemão. Seguem-se dados em JSON com nomes de campos em inglês.
whoamiresponde com um único bloco de texto que contém JSON, sem a linha do Space nem uma parte estruturada.- O conteúdo de um ficheiro que a aplicação lê com
hosting_read_fileé fornecido pela TEISENDA apenas num bloco próprio, delimitado e assinalado como dados; cada chamada contém, no máximo, 40.000 caracteres. hosting_get_visibilityindica apenas o número de pessoas e equipas selecionadas, nunca os nomes de outros membros. Os códigos de erro em inglês do nó de alojamento nunca aparecem num resultado.- Uma rejeição é uma frase no idioma da sua conta ou, se for o Connector a rejeitar, uma frase fixa em inglês. Por vezes, é devolvido apenas um estado HTTP. Consulte os casos em Resolver erros do Connector.
Isto é o que o Connector fornece. O que lê na conversa é formulado pela aplicação.
O que a TEISENDA recebe da aplicação
A TEISENDA recebe os argumentos da chamada da ferramenta, bem como o utilizador, a ligação e o número do pedido.
Vários registos guardam informações sobre a utilização
Os detalhes no registo do projeto e as mensagens de erro da aplicação podem conter valores individuais dos argumentos das ferramentas. O número de um pedido é o mesmo no Connector e no registo do projeto; permite encontrar uma chamada em ambos.
| Registo | Quem o mantém | O que contém |
|---|---|---|
| Autenticações | Connector | Para cada autenticação, revogação e fim de sessão: o utilizador. Numa autenticação, também o nome da aplicação e o host para o qual regressou. |
| Chamadas de ferramentas | Connector | Nome da ferramenta, utilizador, número do pedido e momento; em caso de erro, podem seguir-se linhas com mensagens de erro da aplicação. Estas podem conter dados individuais, como uma Space-ID. whoami não gera uma entrada deste tipo. As revogações são registadas com o estado da autenticação, a identificação da aplicação e, quando aplicável, o utilizador. |
| Acessos | Servidor web do Connector | Endereço IP, momento, método, endereço completo com parâmetros, estado HTTP, tamanho da resposta, página de referência e programa que fez o pedido. Um campo adicional pode conter a identificação da aplicação na autenticação HTTP Basic. Nas chamadas de ferramentas, o IP pertence ao fornecedor; na autenticação, ao navegador. |
| Registo do projeto | Aplicação | Alterações com Space, projeto, conta, canal, número do pedido, operação, detalhe e momento. Os detalhes podem conter valores individuais dos argumentos, mas não nomes nem conteúdos de ficheiros. A mera consulta, bem como a escrita e eliminação de ficheiros, não gera entradas; são registados a criação de um rascunho e a remoção de versões anteriores. |
| Versões e ligações | Aplicação | Uma versão conserva o canal, a conta e o número do pedido com que foi criada. Uma ligação conserva o momento da última utilização. |
| Saída de erros | Aplicação | Apenas erros: se uma ferramenta falhar, é escrita uma linha com o nome da ferramenta, o número do pedido e o erro, que pode conter valores dos argumentos. |
| Erros de tarefas em segundo plano | Base de dados da aplicação | Se uma tarefa em segundo plano falhar, a sua mensagem de erro é guardada. |
Na autenticação, também são registados os parâmetros dos endereços de autenticação e de regresso, incluindo o código de utilização única da aplicação. O servidor web não regista corpos de pedidos ou respostas, tokens, cookies nem o cabeçalho Authorization. Os argumentos e resultados das ferramentas não são guardados como conteúdos completos no registo do serviço; as mensagens de erro podem, porém, conter valores individuais.
Prazos aplicáveis aos registos
- Registo de autenticação: as entradas com mais de doze meses são eliminadas no início de uma nova autenticação.
- Registo do serviço do Connector com chamadas de ferramentas e revogações: no máximo, três meses; menos, se atingir o limite de tamanho. A cópia adicional no registo do sistema é conservada durante cerca de quatro a cinco semanas devido à rotação semanal.
- Registo de acessos do servidor web à frente do Connector: 14 ficheiros diários, além do ficheiro atual. A rotação diária elimina entradas após 14 a 15 dias. Este prazo não se aplica aos registos de erros do servidor web.
O registo do projeto não tem um prazo fixo de conservação: as entradas permanecem até à eliminação do Space, mesmo que o projeto seja eliminado antes.
Quando uma conta é eliminada, a associação à pessoa que efetuou a ação é removida da entrada. Contudo, um ID de conta nos detalhes de uma entrada anterior de autorização permanece.
Não existe um prazo em dias para a saída da aplicação, do seu listener do Connector e das tarefas em segundo plano. Em cada contentor, o ficheiro de registo é rodado ao atingir 10 MB; a saída mais antiga é então removida. A remoção do contentor também elimina a sua saída. Uma nova implementação, por si só, não a elimina: os contentores anteriores parados conservam os registos até serem removidos.
As mensagens de erro das tarefas em segundo plano também permanecem na base de dados sem uma regra automática de eliminação. A eliminação de um Space não remove estas entradas.
O que a TEISENDA guarda para cada ligação
- o nome indicado pela aplicação, sem alterações e sem que a TEISENDA alguma vez o verifique
- o host para o qual regressou após a autenticação
- o momento da ligação e o da última utilização
- os seus Spaces e se também abrange Spaces dos quais venha a fazer parte
A última utilização inclui também pedidos rejeitados e é atualizada, no máximo, uma vez a cada cinco minutos. Não comprova que uma ferramenta tenha sido executada.
A política de privacidade encontra-se no website
Encontra a política de privacidade da TEISENDA em teisenda.com/datenschutz.