Dati che passano attraverso il Connector
Scopri quali dati passano tra TEISENDA e l’applicazione collegata e quali registri vengono creati.
In questa pagina
Cosa riceve l’applicazione tramite il Connector
- il nome TEISENDA, un’icona e l’indirizzo della documentazione con cui il Connector si presenta
- le istruzioni del Connector
- il catalogo degli strumenti
- da
whoami, il tuo nome e, per ogni Space del collegamento, ID dello Space, nome, indicazione di blocco e prodotti - il risultato di ogni chiamata a uno strumento
Il risultato di uno strumento di hosting inizia con lo Space
I risultati di hosting indicano prima lo Space e un messaggio nella lingua del tuo account oppure in tedesco se la lingua non è supportata. Seguono dati JSON con nomi dei campi in inglese. Uno Space è un ambiente di lavoro condiviso nell’app.
whoamirisponde con un unico blocco di testo contenente JSON, senza la riga dello Space e senza una parte strutturata.- TEISENDA restituisce il contenuto di un file letto dall’applicazione con
hosting_read_filesolo in un blocco separato, delimitato e contrassegnato come dati; al massimo 40.000 caratteri per chiamata. hosting_get_visibilityindica solo il numero di persone e team selezionati, mai i nomi degli altri membri. I codici di errore in inglese del nodo di hosting non appaiono mai in un risultato.- Un rifiuto è una frase nella lingua del tuo account oppure, se rifiuta il Connector, una frase fissa in inglese. A volte arriva solo uno stato HTTP. I casi sono in Risolvere i problemi del Connector.
Questo è ciò che fornisce il Connector. L’applicazione formula ciò che leggi nella conversazione.
Cosa riceve TEISENDA dall’applicazione
TEISENDA riceve gli argomenti della chiamata allo strumento, oltre a utente, collegamento e numero della richiesta.
Diversi registri conservano dati sull’utilizzo
I dettagli nel registro del progetto e i messaggi di errore dell’app possono contenere singoli valori degli argomenti degli strumenti. Il numero di una richiesta è uguale nel Connector e nel registro del progetto; permette di ritrovare una chiamata in entrambi.
| Registro | Chi lo gestisce | Contenuto |
|---|---|---|
| Autenticazioni | Connector | L’utente per ogni autenticazione, revoca e uscita. Per un’autenticazione anche il nome dell’applicazione e l’host a cui è tornata. |
| Chiamate agli strumenti | Connector | Nome dello strumento, utente, numero della richiesta e momento; in caso di errore possono seguire righe con messaggi di errore dell’app. Possono contenere singoli dati come un ID dello Space. whoami non crea una voce di questo tipo. Le revoche vengono registrate con stato dell’autenticazione, identificativo dell’applicazione ed eventualmente utente. |
| Accessi | Server web del Connector | Indirizzo IP, momento, metodo e indirizzo completo con parametri, stato HTTP, dimensione della risposta, pagina di provenienza e programma richiedente. Un altro campo può contenere l’identificativo dell’applicazione durante l’autenticazione HTTP Basic. Nelle chiamate agli strumenti l’IP appartiene al fornitore, nell’autenticazione al browser. |
| Registro del progetto | App | Modifiche con Space, progetto, account, canale, numero della richiesta, operazione, dettaglio e momento. I dettagli possono contenere singoli valori degli argomenti, ma non nomi o contenuti dei file. La sola lettura e la scrittura o eliminazione di file non creano voci; vengono annotate la creazione di una bozza e la rimozione di versioni precedenti. |
| Versioni e collegamenti | App | Una versione conserva il canale, l’account e il numero della richiesta con cui è nata. Un collegamento conserva il momento dell’ultimo utilizzo. |
| Output degli errori | App | Solo errori: se uno strumento si interrompe, appare una riga con nome dello strumento, numero della richiesta ed errore, che può contenere valori degli argomenti. |
| Errori delle attività in background | Database dell’app | Se un’attività in background non riesce, il suo messaggio di errore viene salvato. |
Durante l’autenticazione vengono registrati anche i parametri degli indirizzi di autenticazione e ritorno, incluso il codice monouso dell’app. Il server web non registra i corpi di richieste o risposte, token, cookie o l’intestazione Authorization. Argomenti e risultati degli strumenti non sono registrati come contenuti completi nel registro del servizio; i messaggi di errore possono però contenere singoli valori.
Periodi di conservazione dei registri
- Registro delle autenticazioni: le voci più vecchie di dodici mesi vengono eliminate all’inizio di una nuova autenticazione.
- Registro del servizio del Connector con chiamate agli strumenti e revoche: al massimo tre mesi; prima se viene raggiunto il limite di dimensione. La copia aggiuntiva nel registro di sistema resta per circa quattro o cinque settimane grazie alla rotazione settimanale.
- Registro degli accessi del server web davanti al Connector: 14 file giornalieri più quello corrente. La rotazione giornaliera elimina le voci dopo 14 o 15 giorni. Questo periodo non vale per i registri degli errori del server web.
Il registro del progetto non ha un periodo di conservazione fisso: le voci restano fino all’eliminazione dello Space, anche se il progetto viene eliminato prima.
Quando un account viene eliminato, l’associazione alla persona che ha agito viene rimossa dalla voce. Un ID dell’account nei dettagli di una precedente voce di concessione dell’accesso resta però conservato.
Per l’output dell’app, del suo listener del Connector e delle attività in background non c’è un periodo in giorni. Per ogni container il file di registro ruota al raggiungimento di 10 MB; l’output precedente viene rimosso. Anche la rimozione del container elimina il suo output. Una nuova distribuzione da sola non lo elimina: i container precedenti arrestati conservano i registri fino alla loro rimozione.
I messaggi di errore delle attività in background restano inoltre nel database senza una regola di eliminazione automatica. L’eliminazione di uno Space non rimuove queste voci.
Cosa conserva TEISENDA per ogni collegamento
- il nome fornito dall’applicazione, invariato e mai verificato da TEISENDA
- l’host a cui è tornata l’autenticazione
- il momento del collegamento e dell’ultimo utilizzo
- gli Spaces e l’indicazione se vale anche per gli Spaces a cui ti unisci in seguito
L’ultimo utilizzo include anche richieste rifiutate e cambia al massimo una volta ogni cinque minuti. Non dimostra che uno strumento sia stato eseguito.
L’informativa sulla privacy è sul sito web
Trovi l’informativa sulla privacy di TEISENDA su teisenda.com/datenschutz.