XMPP/AP Bridge

Bridge to chat between your Fediverse and XMPP applications!

Chat directly between #Fediverse applications (Mastodon, Pixelfed, Friendica,…) and #XMPP (instant messaging, formerly known as Jabber)!

No installation nor configuration required, works intuitively, just send a message to the bot mentioning your intended recipient(s). You can reply directly to a message received, send to multiple recipients and manage personal blocklists, between any Fediverse and XMPP servers.

User help page

🇫🇷 Français

🇬🇧 English

🇪🇸 Español

🇩🇪 Deutsch

🇮🇹 Italiano

🇵🇹 Português

🇳🇱 Nederlands

Bridge administrator help page

Full moderation capabilities are available to appointed XMPP/AP Bridge administrators, in addition to personal user blocklists.

🇫🇷 Français

🇬🇧 English

🇪🇸 Español

🇩🇪 Deutsch

🇮🇹 Italiano

🇵🇹 Português

🇳🇱 Nederlands

Install your own XMPP/AP Bridge

You can install your own XMPP/AP Bridge now with minimal requirements, the project is open source and released under the AGPL v3.0 license.

🇬🇧 Github project page

In the spirit of federation, you are encouraged to setup your own #Bridge!

Use for Good, not for Evil. And enjoy!

#XMPPBridge #BridgeXMPP

Fediverse – XMPP Bridge voor beheerders

Inleiding: wat is een beheerder?

Als u dit nog niet hebt gedaan, begin dan met het lezen van de gebruikershandleiding om vertrouwd te raken met de belangrijkste functies. Link: hier

Deze handleiding is voor beheerders van de Bridge; een zogenaamde “beheerder” is een standaard gebruiker met speciale privileges die je meer controle geven over de werking van de Bridge en globale moderatie acties.

Het is een andere rol dan de serverbeheerder, die de volledige controle heeft over de bots en de installatie en werking van de backend van het systeem. In de praktijk zou dezelfde persoon erachter kunnen zitten, maar dat hoeft niet. De rol van serverbeheerder wordt hier niet beschreven, maar staat samen met de broncode op de projectpagina.

De serverbeheerder is ook degene die de beheerdersrol toekent aan één of meerdere accounts (zowel #XMPP en/of #Fediverse), die zich op elke instantie kunnen bevinden. Het is optioneel maar aanbevolen om minstens één beheerder voor Fediverse en één voor XMPP toe te wijzen; om rapporten van gebruikers te ontvangen is het verplicht om minstens één XMPP-beheerder te hebben (waarvan de eerste dergelijke rapporten zal ontvangen indien geconfigureerd).

Zoals gezegd kunnen beheerders zich gedragen als normale gebruikers. Laten we ons nu richten op de extra commando's die ze hebben. Deze lijst met commando's kan worden opgevraagd met !ahelp

Privacy-overwegingen

Eerst iets over privacy.

Fediverse ondersteunt geen end-to-end encryptie (E2EE). Daarom heeft het geen zin om te proberen E2EE te implementeren vanuit XMPP, dus alle berichten worden in duidelijke tekst verzonden en ontvangen. Dit betekent niet dat ze publiekelijk zichtbaar zijn en in feite zijn ze dat ook niet: maar ze worden simpelweg beschermd door toegangsrechten, net zoals directe berichten in Mastodon dat zijn, als voorbeeld.

Voor elke bridge die als proxy fungeert voor het verzenden en ontvangen van berichten, heeft dit de volgende implicaties:

• De beheerders van uw XMPP en Fediverse instantie kunnen uw berichten lezen (net als bij elk ander niet-versleuteld bericht).
• De serverbeheerder van de Bridge, die ook de bots beheert, kan uw berichten lezen (totdat ze na 30 dagen automatisch worden verwijderd).
• De Mastodon instance administrator die de eerste bot host, en de XMPP instance administrator die de tweede bot host, kunnen uw berichten lezen. Dit kan dezelfde persoon zijn als in de vorige regel, maar dat hoeft niet.

In ons geval op GayFR zijn de Bridge serverbeheerder, de gayfr.social Mastodon beheerder en de gayfr.live XMPP beheerder dezelfde beheerder.

Maar in een scenario waar de Bridge beheerders geen van bovenstaande zijn, hebben ze geen toegang tot de inhoud van berichten of metadata.

Dus nogmaals, het introduceren van een bridge betekent het invoegen van een persoon-in-the-middle die al je berichten kan onderscheppen en lezen. Je moet die persoon vertrouwen, of beter nog, je wordt aangemoedigd om je eigen instantie van de Bridge op je server te draaien.

Slotwoord: ActivityPub en de Fediverse bieden geen middelen voor E2EE of effectieve privacy. Als dat is wat u zoekt, moet u andere hulpmiddelen gebruiken (XMPP alleen doet dat wel, met behulp van OMEMO als uw clientapplicatie dat ondersteunt).

Bridge status

Je kunt het verzenden/ontvangen van berichten globaal inschakelen met het commando !start en uitschakelen met !stop

U kunt de registratie van nieuwe gebruikers op de Bridge openen met het commando !open en u kunt de registraties volledig sluiten met !close

Hoe dan ook, de andere bewerkingen van de Bridge blijven allemaal beschikbaar en u kunt de huidige status voor beide parameters opvragen met het commando !status dat u ook vertelt of de Bridge in de groene lijstmodus staat (zie hieronder).

Tenslotte kunt u een lijst krijgen van alle actieve gebruikers (niet-herroepen accounts) en hun applicatieherkomst met het commando !alistu

Moderatie mogelijkheden

Bescherming tegen misbruik is een belangrijk kenmerk van deze Bridge. Standaard gebruikers hebben de volgende mogelijkheden al tot hun beschikking, ter herinnering:

• Fediverse gebruikers moeten zich eerst vrijwillig registreren voordat ze berichten kunnen versturen of ontvangen (opt-in). Doen ze dat niet, dan zullen ze nooit iets van de Bridge ontvangen.
• Alle gebruikers kunnen zich op elk moment uitschrijven en als ze er zeker van willen zijn dat ze niets van de bots ontvangen, blokkeer ze dan zoals bij elke andere account.
• Een persoonlijke blokkadelijst kan door elke gebruiker beheerd worden om elke Fediverse of XMPP-gebruiker te blokkeren, de commando's zijn !block, !unblock en !listblock zoals gepresenteerd op de gebruikershulppagina.
• Tot slot kan misbruik direct aan de Bridge-beheerder worden gemeld met het commando !report dat naar de eerste XMPP-admin wordt gestuurd.

Tijdens de registratie worden ook elementaire controles uitgevoerd om mogelijke spammers eruit te filteren of om privacykeuzes te respecteren: geen bot- of groepsaccounts, geen #NoBot of #NoBridge hashtag in het profiel, minimale publiekelijk zichtbare activiteit in de afgelopen maand.

De serverbeheerder kan ook het maximum aantal gebruikers instellen dat zich kan registreren en een limiet instellen op het aantal berichten dat elke gebruiker kan verzenden binnen een periode van vijf minuten.

Daarnaast kan de Bridge beheerder globale moderatie acties uitvoeren die we hieronder zullen beschrijven.

Globale moderatie van accounts

Je kunt een account (of een lijst van accounts) globaal blokkeren met het commando !ablock. Dit zal ook de account(s) de-registreren als deze al geregistreerd is (zijn) en voorkomen dat deze zich opnieuw registreert (kunnen).

Je kunt dit ongedaan maken met de opdracht !aunblock (waarmee de overeenkomstige accounts echter niet worden geregistreerd, indien nodig moeten ze zichzelf opnieuw aanmelden).

De lijst van globaal geblokkeerde accounts is beschikbaar met het commando !alistb

Globale domein moderatie

Je kunt de lijst met domeinen beheren om ze ofwel op de rode lijst te zetten (alle accounts die die domeinnaam gebruiken zijn verboden) of op de groene lijst. Voor de laatste zijn er twee verschillende manieren van werken:

• Als de Bridge is ingesteld op groene lijst (door de serverbeheerder): alleen de accounts die bij die domeinnaam horen mogen zich registreren.
• Als dit niet het geval is: accounts die op de groene lijst staan, slaan de minimale activiteitscheck over tijdens de registratie.

De rode lijst heeft een hogere prioriteit dan de groene lijst, met andere woorden, een domein dat op beide lijsten voorkomt wordt op de rode lijst gezet. Geblokkeerde accounts blijven ook geblokkeerd als ze op een groene lijst staan.

Domeinnamen moeten exact zijn: er is geen hiërarchie en subdomeinen moeten ook worden geblokkeerd als je dat wilt.

Je kunt een domein (of een lijst van domeinen) globaal blokkeren met de opdracht !addred, die in feite ook alle corresponderende accounts de-registreert als ze al geregistreerd zijn en voorkomt dat ze zich opnieuw registreren. Je kunt dit annuleren met de opdracht !delred, en alles weergeven met !listred.

De commando's !addgreen, delgreen en !listgreen doen hetzelfde voor de groene lijst, met de volgende verschillen: een domein toevoegen aan de groene lijst doet niets meer, maar als (en alleen als) de Bridge is ingesteld op groene lijst-modus, zal het verwijderen alle bijbehorende accounts uitschrijven als ze al geregistreerd zijn en voorkomen dat ze opnieuw registreren.

Tot slot: als een domein wordt geblokkeerd door de server waar de bots gehost worden (Mastodon of XMPP), kan het natuurlijk helemaal geen gebruik maken van de Bridge omdat het geen contact kan maken met de bots.

Inzet scenario's

Tot slot biedt de Bridge veel hulpmiddelen voor moderatie en bescherming tegen misbruik, en is flexibel in hoe je je gebruikers kunt beheren.

Overweeg de volgende scenario's:

• Wilt u dat uw Bridge voor iedereen toegankelijk is? Gebruik dan gewoon de standaardinstellingen en beheer blokkeerlijsten, rode lijsten en groene lijsten. Dit is de instelling die wij op onze Bridge gebruiken.
• Wilt u dat uw Bridge toegankelijk is voor een beperkte gemeenschap? Vraag de serverbeheerder van de Bridge om deze in te stellen op de groene lijstmodus en definieer uw groene lijst.
• Wilt u dat uw Bridge alleen uw lokale gebruikers bedient? Doe dan hetzelfde als hierboven en laat de groene lijst leeg (lokale botdomeinen zijn altijd toegestaan).

Uw eigen XMPP/AP-Bridge installeren

Om redenen van privacy en schaalbaarheid wordt u aangemoedigd om uw eigen Bridge te installeren, in de geest van federatie.

De homepage van het project is openbaar beschikbaar hier op Github (in het Engels).

Gebruik het voor goede doeleinden, niet voor kwade. En veel plezier!

Fediverse – Bridge XMPP para administradores

Introdução: o que é um administrador?

Se ainda não o fez, comece por ler o guia do utilizador para se familiarizar com as principais funcionalidades. Link: aqui

Este guia destina-se aos administradores do Bridge; o chamado “administrador” é um utilizador normal com privilégios especiais que lhe permitem um maior controlo sobre as operações do Bridge e as acções globais de moderação.

É um papel diferente do administrador do servidor, que tem controlo total sobre os bots e a instalação e operações do sistema de backend. Na prática, pode ser a mesma pessoa, mas não tem de ser. O papel do administrador do servidor não é descrito aqui, mas é apresentado com o código fonte na página do projeto.

O administrador do servidor é também aquele que concede o papel de administrador a uma ou várias contas (tanto #XMPP como #Fediverse), que podem estar em qualquer instância. É opcional mas recomendável atribuir pelo menos um administrador para o Fediverse e um para o XMPP; para receber relatórios dos utilizadores, é obrigatório ter pelo menos um administrador XMPP (do qual o primeiro receberá esses relatórios, se configurado).

Como já foi dito, os administradores podem atuar como utilizadores normais. Vamos concentrar-nos agora nos comandos adicionais que têm. Esta lista de comandos pode ser consultada usando !ahelp

Considerações sobre privacidade

Antes disso, uma palavra sobre privacidade.

O Fediverse não suporta encriptação de ponta a ponta (E2EE). Por conseguinte, não faz sentido tentar implementar a E2EE a partir do XMPP, pelo que todas as mensagens são enviadas e recebidas em texto claro. Isso não significa que sejam visíveis publicamente e, de facto, não o são: são simplesmente protegidas por direitos de controlo de acesso, tal como as mensagens diretas no Mastodon, por exemplo.

Quanto a qualquer ponte que actue como um proxy para enviar e receber mensagens, isto tem as seguintes implicações:

• Os administradores do XMPP e da instância do Fediverse podem ler as suas mensagens (como qualquer outra mensagem não encriptada).
• O administrador do servidor, que também controla os bots, pode ler as suas mensagens (até serem apagadas automaticamente após 30 dias).
• O administrador da instância Mastodon que aloja o primeiro bot e o administrador da instância XMPP que aloja o segundo bot podem ler as suas mensagens. Pode ser a mesma pessoa da linha anterior, mas não tem de ser.

No nosso caso no GayFR, o administrador do servidor do Bridge, o administrador do gayfr.social Mastodon e o administrador do gayfr.live XMPP são o mesmo administrador.

Mas num cenário em que os administradores do Bridge não são nenhum dos anteriores, eles não terão acesso ao conteúdo das mensagens nem aos metadados.

Assim, mais uma vez, introduzir uma ponte significa inserir uma pessoa no meio capaz de intercetar e ler todas as suas mensagens. É necessário confiar nessa pessoa ou, melhor ainda, é aconselhável executar a sua própria instância do Bridge no seu servidor.

Palavra final: ActivityPub e o Fediverse não fornecem nenhum meio para E2EE nem privacidade efectiva. Se é isso que procura, deve utilizar outras ferramentas (só o XMPP o faz, no entanto, utilizando o OMEMO se a sua aplicação cliente o suportar).

Estado do Bridge

Pode ativar globalmente o envio/receção de mensagens utilizando o comando !start e pode desactivá-lo utilizando !stop

Pode abrir o registo de novos utilizadores no Bridge utilizando o comando !open e pode fechar todos os registos utilizando !close

De qualquer forma, todas as outras operações do Bridge permanecerão disponíveis e pode consultar o estado atual de ambos os parâmetros com o comando !status, que também lhe dirá se o Bridge está definido para o modo de lista verde (ver abaixo).

Finalmente, pode obter uma lista de todos os utilizadores activos (contas não revogadas) e a origem da sua aplicação usando o comando !alistu

Capacidades de moderação

A proteção contra abusos é uma das principais caraterísticas deste Bridge. Os utilizadores padrão já têm as seguintes funcionalidades disponíveis, como lembrete:

• Os utilizadores do Fediverse têm de se registar voluntariamente primeiro, antes de poderem enviar ou receber qualquer mensagem (opt-in). Se não o fizerem, nunca receberão nada do Bridge.
• Todos os utilizadores podem cancelar o registo em qualquer altura e, se quiserem ter a certeza de que não recebem nada dos bots, basta bloqueá-los como faria com qualquer outra conta.
• Cada utilizador pode gerir uma lista de bloqueio pessoal para bloquear qualquer utilizador do Fediverse ou XMPP, os comandos são !block, !unblock e !listblock, conforme apresentado na página de ajuda ao utilizador.
• Por fim, qualquer abuso pode ser comunicado diretamente ao administrador do Bridge utilizando o comando !report que será enviado para o primeiro administrador XMPP.

Além disso, durante o registo, são efectuadas verificações elementares para tentar filtrar possíveis spammers ou para respeitar as opções de privacidade: não ter contas de bots nem de grupos, não ter hashtag #NoBot nem #NoBridge no perfil, ter um mínimo de atividade visível publicamente durante o último mês.

O administrador do servidor também pode configurar o número máximo total de utilizadores que se podem registar e definir um limite de taxa para o número de mensagens que cada utilizador pode enviar num período de cinco minutos.

Além disso, o administrador do Bridge pode realizar acções de moderação globais que descreveremos a seguir.

Moderação global de contas

Pode bloquear globalmente uma conta (ou uma lista de contas) utilizando o comando !ablock, o que, na prática, também anulará o registo da(s) conta(s) se já estiver(em) registada(s) e impedirá que se registe(m) novamente.

Pode cancelar esta ação utilizando o comando !aunblock (que, no entanto, não registará as contas correspondentes; se necessário, estas terão de se candidatar novamente).

A lista de contas globalmente bloqueadas está disponível utilizando o comando !alistb

Moderação global de domínios

Pode gerir uma lista de domínios para colocar na lista vermelha (todas as contas que utilizem esse nome de domínio são proibidas) ou na lista verde. Para este último, existem duas formas diferentes de trabalhar:

• Se o Bridge estiver definido para o modo de lista verde (pelo administrador do servidor): apenas as contas que pertencem a esse nome de domínio estão autorizadas a registar-se.
• Caso contrário: as contas que pertencem à lista verde não cumprem o requisito mínimo de verificação de atividade durante o registo.

A lista vermelha tem uma prioridade mais elevada do que a lista verde, por outras palavras, um domínio que apareça em ambas será colocado na lista vermelha. Além disso, as contas bloqueadas permanecerão bloqueadas mesmo que estejam num domínio da lista verde.

Os nomes de domínio têm de ser exactos: não há hierarquia e os subdomínios também têm de ser bloqueados, se for esse o seu desejo.

Pode bloquear globalmente um domínio (ou uma lista de domínios) utilizando o comando !addred, o que, na prática, também anulará o registo de todas as contas correspondentes, se já estiverem registadas, e impedirá que se registem novamente. Pode cancelar isto utilizando o comando !delred, e listar todos com !listred

Os comandos !addgreen, delgreen e !listgreen farão o mesmo para a lista verde, com as seguintes diferenças: adicionar um domínio à lista verde não fará mais nada, mas se (e apenas se) o Bridge estiver definido para o modo de lista verde, removê-lo anulará o registo de todas as contas correspondentes se já estiverem registadas e impedirá que se registem novamente.

Finalmente: se um domínio for bloqueado pelo servidor que aloja os bots (Mastodon ou XMPP), não poderá obviamente utilizar o Bridge, pois não poderá contactar os bots.

Cenários de implementação

Para concluir, o Bridge oferece muitas ferramentas para moderação e proteção contra abusos, e é flexível na forma como pode gerir os seus utilizadores.

Considere os seguintes cenários:

• Quer que o seu Bridge esteja aberto a todos? Basta utilizar as definições padrão e gerir listas de bloqueio, listas vermelhas e listas verdes; esta é a definição que utilizamos no nosso Bridge.
• Pretende que o seu Bridge esteja aberto a uma comunidade limitada? Peça ao administrador do servidor do Bridge que o coloque em modo de lista verde e defina a sua lista verde.
• Quer que o seu Bridge sirva apenas os seus utilizadores locais? Faça como anteriormente e mantenha a lista verde vazia (os domínios de bots locais são sempre permitidos).

Instalando seu próprio Bridge XMPP/AP

É encorajado a instalar o seu próprio Bridge, por razões de privacidade e escalabilidade, no espírito da federação.

A página inicial do projeto está disponível publicamente aqui no Github (em inglês).

Use para o Bem, não para o Mal. E divirtam-se!

Bridge Fediverse – XMPP per gli amministratori

Introduzione: cos'è un amministratore?

Se non l'avete ancora fatto, iniziate a leggere il manuale d'uso per familiarizzare con le principali funzionalità. Link: qui

Questa guida è destinata agli amministratori del Bridge; un cosiddetto “amministratore” è un utente standard con privilegi speciali che consentono un maggiore controllo sulle operazioni del Bridge e sulle azioni di moderazione globale.

Si tratta di un ruolo diverso da quello dell'amministratore del server, che ha il pieno controllo sui bot e sull'installazione e le operazioni del backend del sistema. In pratica, potrebbe essere la stessa persona, ma non necessariamente. Il ruolo di amministratore del server non è descritto qui, ma è presentato con il codice sorgente nella pagina del progetto.

L'amministratore del server è anche colui che assegna il ruolo di amministratore a uno o più account (sia #XMPP e/o #Fediverse), che possono essere su qualsiasi istanza. È facoltativo ma consigliato assegnare almeno un amministratore per Fediverse e uno per XMPP; per ricevere le segnalazioni degli utenti, è obbligatorio avere almeno un amministratore XMPP (di cui il primo riceverà tali segnalazioni, se configurato).

Come detto, gli amministratori possono agire come normali utenti. Concentriamoci ora sui comandi aggiuntivi di cui dispongono. Questo elenco di comandi può essere interrogato usando !ahelp

Considerazioni sulla privacy

Prima di tutto, una parola sulla privacy.

Fediverse non supporta la crittografia end-to-end (E2EE). Pertanto, non ha senso cercare di implementare E2EE da XMPP, quindi tutti i messaggi sono inviati e ricevuti in chiaro. Ciò non significa che siano visibili pubblicamente, anzi non lo sono: sono semplicemente protetti da diritti di controllo degli accessi, proprio come lo sono i messaggi diretti in Mastodon, per fare un esempio.

Per quanto riguarda i bridge che agiscono come proxy per inviare e ricevere messaggi, ciò ha le seguenti implicazioni:

• Gli amministratori del vostro XMPP e della vostra istanza Fediverse possono leggere i vostri messaggi (come per qualsiasi altro messaggio non criptato).
• L'amministratore del server Bridge, che controlla anche i bot, può leggere i vostri messaggi (finché non vengono cancellati automaticamente dopo 30 giorni).
• L'amministratore dell'istanza Mastodon che ospita il primo bot e l'amministratore dell'istanza XMPP che ospita il secondo bot possono leggere i messaggi. Potrebbe essere la stessa persona della riga precedente, ma non necessariamente.

Nel nostro caso su GayFR, l'amministratore del server Bridge, l'amministratore di gayfr.social Mastodon e l'amministratore di gayfr.live XMPP sono lo stesso amministratore.

Ma in uno scenario in cui gli amministratori di Bridge non sono nessuno di questi, essi non avranno accesso al contenuto dei messaggi né ai metadati.

Quindi, ancora una volta, introdurre un bridge significa inserire una persona di mezzo in grado di intercettare e leggere tutti i messaggi. Dovete fidarvi di questa persona o, meglio ancora, siete incoraggiati a eseguire la vostra istanza del Bridge sul vostro server.

In conclusione: ActivityPub e il Fediverse non forniscono alcun mezzo per l'E2EE né una privacy efficace. Se è questo che cercate, dovreste usare altri strumenti (XMPP da solo lo fa, però, usando OMEMO se la vostra applicazione client lo supporta).

Stato del Bridge

È possibile abilitare globalmente l'invio/ricezione di messaggi usando il comando !start e disabilitarlo usando !stop

È possibile aprire la registrazione di nuovi utenti al Bridge utilizzando il comando !open e chiudere del tutto le registrazioni utilizzando !close

In entrambi i casi, le altre operazioni del Bridge rimarranno tutte disponibili e si potrà interrogare lo stato attuale di entrambi i parametri con il comando !status, che dirà anche se il Bridge è impostato in modalità lista verde (vedere sotto).

Infine, è possibile ottenere un elenco di tutti gli utenti attivi (account non revocati) e della loro origine applicativa con il comando !alistu

Capacità di moderazione

La protezione dagli abusi è una delle caratteristiche principali di questo Bridge. Gli utenti standard hanno già a disposizione le seguenti funzioni, come promemoria:

• Gli utenti di Fediverse devono registrarsi volontariamente prima di poter inviare o ricevere qualsiasi messaggio (opt-in). In caso contrario, non riceveranno mai nulla dal Bridge.
• Tutti gli utenti possono disiscriversi in qualsiasi momento e, se vogliono essere sicuri di non ricevere nulla dai bot, basta bloccarli come si farebbe con qualsiasi altro account.
• La lista di blocco personale può essere gestita da ogni utente per bloccare qualsiasi utente Fediverse o XMPP; i comandi sono !block, !unblock e !listblock, come presentato nella pagina di aiuto agli utenti.
• Infine, qualsiasi abuso può essere segnalato direttamente all'amministratore del Bridge utilizzando il comando !report che verrà inviato al primo amministratore XMPP.

Inoltre, durante la registrazione, vengono effettuati controlli elementari per cercare di filtrare eventuali spammer o per rispettare le scelte di privacy: nessun account bot o gruppo, nessun hashtag #NoBot o #NoBridge nel profilo, attività minima visibile pubblicamente nell'ultimo mese.

L'amministratore del server può anche configurare il numero massimo totale di utenti che possono registrarsi e impostare un limite di velocità sul numero di messaggi che ogni utente può inviare nell'arco di cinque minuti.

Inoltre, l'amministratore di Bridge può eseguire azioni di moderazione globale che descriveremo di seguito.

Moderazione globale degli account

È possibile bloccare globalmente un account (o un elenco di account) utilizzando il comando !ablock, che in effetti disiscriverà anche l'account (o gli account) se già registrati e impedirà loro di registrarsi nuovamente.

È possibile annullare questa operazione con il comando !aunblock (che tuttavia non registrerà gli account corrispondenti, che se necessario dovranno richiedere nuovamente la registrazione da soli).

L'elenco degli account bloccati a livello globale è disponibile con il comando !alistb

Moderazione globale dei domini

È possibile gestire l'elenco dei domini per inserire gli account in una lista rossa (tutti gli account che utilizzano quel nome di dominio sono vietati) o in una lista verde. Per quest'ultima, esistono due modi diversi di lavorare:

• Se il Bridge è impostato in modalità lista verde (dall'amministratore del server): solo gli account che appartengono a quel nome di dominio sono autorizzati a registrarsi.
• In caso contrario, gli account che appartengono alla lista verde salteranno il requisito minimo di verifica dell'attività durante la registrazione.

La lista rossa ha una priorità maggiore rispetto alla lista verde, in altre parole, un dominio che compare in entrambe sarà inserito nella lista rossa. Inoltre, gli account bloccati rimarranno bloccati anche se in un dominio in lista verde.

I nomi dei domini devono essere esatti: non esiste una gerarchia e anche i sottodomini devono essere bloccati, se lo si desidera.

È possibile bloccare globalmente un dominio (o un elenco di domini) utilizzando il comando !addred, che in effetti disiscriverà anche tutti gli account corrispondenti se sono già registrati e impedirà loro di registrarsi nuovamente. È possibile annullare questa operazione con il comando !delred ed elencare tutti con !listred

I comandi !addgreen, delgreen e !listgreen faranno lo stesso per la lista verde, con le seguenti differenze: l'aggiunta di un dominio alla lista verde non farà nulla di più, ma se (e solo se) il Bridge è impostato in modalità lista verde, la sua rimozione disiscriverà tutti gli account corrispondenti se sono già registrati e impedirà loro di registrarsi nuovamente.

Infine, se un dominio è bloccato dal server che ospita i bot (Mastodon o XMPP), non potrà ovviamente utilizzare il Bridge, poiché non sarà in grado di contattare i bot.

Scenari di distribuzione

Per concludere, il Bridge offre molti strumenti per la moderazione e la protezione dagli abusi ed è flessibile nella gestione degli utenti.

Considerate i seguenti scenari:

• Volete che il vostro Bridge sia aperto a tutti? Utilizzate le impostazioni standard e gestite le liste di blocco, le liste rosse e le liste verdi; questa è l'impostazione che utilizziamo sul nostro Bridge.
• Volete che il vostro Bridge sia aperto a una comunità limitata? Chiedete all'amministratore del server del Bridge di impostare la modalità lista verde e di definire la vostra lista verde.
• Volete che il vostro Bridge serva solo gli utenti locali? Fate come in precedenza e mantenete la lista verde vuota (i domini dei bot locali sono sempre ammessi).

Installazione del proprio Bridge XMPP/AP

L'utente è incoraggiato a installare il proprio Bridge, per motivi di privacy e scalabilità, nello spirito della federazione.

La pagina iniziale del progetto è disponibile pubblicamente qui su Github (in inglese).

Usatelo per il Bene, non per il Male. E buon divertimento!

Fediverse – XMPP-Bridge für Administratoren

Einführung: Was ist ein Administrator?

Wenn Sie es noch nicht getan haben, lesen Sie bitte zunächst das Benutzerhandbuch, um sich mit den wichtigsten Funktionen vertraut zu machen. Link: hier

Dieser Leitfaden richtet sich an Administratoren der Bridge; ein so genannter „Administrator“ ist ein Standardbenutzer mit besonderen Privilegien, die Ihnen weitere Kontrolle über den Betrieb der Bridge und globale Moderationsaktionen ermöglichen.

Es ist eine andere Rolle als die des Server-Administrators, der die volle Kontrolle über die Bots und die Installation und den Betrieb des System-Backends hat. In der Praxis kann es sich um dieselbe Person handeln, muss es aber nicht. Die Rolle des Serveradministrators wird hier nicht beschrieben, sondern mit dem Quellcode auf der Projektseite vorgestellt.

Der Server-Administrator ist auch derjenige, der einem oder mehreren Konten (sowohl #XMPP als auch #Fediverse), die sich auf einer beliebigen Instanz befinden können, die Administratorrolle zuweist. Es ist optional, aber empfohlen, mindestens einen Administrator für Fediverse und einen für XMPP zuzuweisen; um Berichte von Benutzern zu erhalten, ist es zwingend erforderlich, mindestens einen XMPP-Administrator zu haben (von denen der erste solche Berichte erhält, wenn er konfiguriert ist).

Wie gesagt, Administratoren können wie normale Benutzer agieren. Konzentrieren wir uns nun auf die zusätzlichen Befehle, die sie haben. Diese Liste der Befehle kann mit !ahelp abgefragt werden.

Überlegungen zum Datenschutz

Zuvor noch ein Wort zum Thema Datenschutz.

Fediverse unterstützt keine Ende-zu-Ende-Verschlüsselung (E2EE). Daher macht es keinen Sinn, zu versuchen, E2EE von XMPP aus zu implementieren, so dass alle Nachrichten im Klartext gesendet und empfangen werden. Das bedeutet nicht, dass sie öffentlich sichtbar sind, und das sind sie auch nicht: Sie sind lediglich durch Zugriffskontrollrechte geschützt, so wie es zum Beispiel bei direkten Nachrichten in Mastodon der Fall ist.

Für jede Bridge, die als Proxy für das Senden und Empfangen von Nachrichten fungiert, hat dies die folgenden Auswirkungen:

• Ihre XMPP- und Fediverse-Instanz-Administratoren können Ihre Nachrichten lesen (wie bei jeder anderen unverschlüsselten Nachricht).
• Der Bridge Server-Administrator, der auch die Bots kontrolliert, kann Ihre Nachrichten lesen (bis sie nach 30 Tagen automatisch gelöscht werden).
• Der Administrator der Mastodon-Instanz, die den ersten Bot hostet, und der Administrator der XMPP-Instanz, die den zweiten Bot hostet, können Ihre Nachrichten lesen. Das kann dieselbe Person sein wie in der vorherigen Zeile, muss es aber nicht.

In unserem Fall auf GayFR sind der Bridge Server-Administrator, der gayfr.social Mastodon-Administrator und der gayfr.live XMPP-Administrator derselbe Administrator.

In einem Szenario, in dem die Bridge-Administratoren keine der oben genannten sind, haben sie keinen Zugriff auf die Inhalte und Metadaten der Nachrichten.

Auch hier bedeutet die Einführung einer Bridge also, dass eine Person zwischengeschaltet wird, die in der Lage ist, alle Ihre Nachrichten abzufangen und zu lesen. Sie müssen dieser Person vertrauen, oder noch besser, Sie sollten Ihre eigene Instanz der Bridge auf Ihrem Server betreiben.

Abschließende Bemerkung: ActivityPub und das Fediverse bieten weder eine Möglichkeit für E2EE noch für effektiven Datenschutz. Wenn Sie das wollen, sollten Sie andere Tools verwenden (XMPP allein tut es allerdings auch, unter Verwendung von OMEMO, wenn Ihre Client-Anwendung es unterstützt).

Bridge-Status

Sie können das Senden/Empfangen von Nachrichten mit dem Befehl !start global aktivieren und mit !stop deaktivieren.

Sie können die Registrierung neuer Benutzer für die Bridge mit dem Befehl !open öffnen und mit !close wieder schließen.

In beiden Fällen bleiben alle anderen Operationen der Bridge verfügbar, und Sie können den aktuellen Status für beide Parameter mit dem Befehl !status abfragen, der Ihnen auch mitteilt, ob die Bridge in den Modus „Grüne Liste“ versetzt wurde (siehe unten).

Schließlich können Sie mit dem Befehl !alistu eine Liste aller aktiven Benutzer (nicht widerrufene Konten) und deren Anwendungsherkunft abrufen.

Moderationsmöglichkeiten

Der Schutz vor Missbrauch ist ein wichtiges Merkmal dieser Bridge. Standardnutzer haben bereits die folgenden Funktionen zur Verfügung, zur Erinnerung:

• Fediverse-Benutzer müssen sich zunächst freiwillig registrieren, bevor sie eine Nachricht senden oder empfangen können (Opt-in). Wenn sie das nicht tun, werden sie nie etwas von der Bridge erhalten.
• Alle Benutzer können sich jederzeit abmelden und wenn sie sicher sein wollen, dass sie nichts von den Bots erhalten, sperren Sie sie einfach, wie Sie es mit jedem anderen Konto tun würden.
• Persönliche Blocklisten können von jedem Benutzer verwaltet werden, um jeden Fediverse- oder XMPP-Benutzer zu blockieren. Die Befehle sind !block, !unblock und !listblock, wie auf der Hilfeseite für Benutzer beschrieben.
• Schließlich kann jeder Missbrauch direkt an den Bridge-Administrator mit dem Befehl !report gemeldet werden, der an den ersten XMPP-Administrator gesendet wird.

Außerdem werden bei der Registrierung elementare Überprüfungen durchgeführt, um mögliche Spammer herauszufiltern oder die Privatsphäre zu respektieren: keine Bot- oder Gruppenkonten, kein #NoBot oder #NoBridge-Hashtag im Profil, minimale öffentlich sichtbare Aktivität im letzten Monat.

Der Serveradministrator kann auch die maximale Gesamtzahl der Benutzer konfigurieren, die sich registrieren können, und ein Ratenlimit festlegen, wie viele Nachrichten jeder Benutzer innerhalb eines Fünf-Minuten-Fensters senden kann.

Darüber hinaus kann der Bridge-Administrator globale Moderationsmaßnahmen durchführen, die wir im Folgenden beschreiben werden.

Globale Kontenmoderation

Sie können ein Konto (oder eine Liste von Konten) mit dem Befehl !ablock global sperren, was zur Folge hat, dass das Konto/die Konten auch wieder abgemeldet wird/werden, wenn es/sie bereits registriert ist/sind, und dass es/sie sich nicht erneut registrieren können.

Sie können dies mit dem Befehl !aunblock rückgängig machen (wodurch die entsprechenden Konten jedoch nicht registriert werden, sondern sich gegebenenfalls erneut anmelden müssen).

Die Liste der global gesperrten Konten ist mit dem Befehl !alistb verfügbar

Globale Domain-Moderation

Sie können die Liste der Domains entweder als rote Liste (alle Konten mit diesem Domainnamen sind verboten) oder als grüne Liste verwalten. Für Letzteres gibt es zwei verschiedene Möglichkeiten:

• Wenn die Bridge (vom Serveradministrator) auf den Modus „Grüne Liste“ eingestellt ist, können sich nur die Konten registrieren, die zu diesem Domänennamen gehören.
• Wenn nicht: Konten, die zur grünen Liste gehören, überspringen die Mindestanforderung der Aktivitätsprüfung bei der Registrierung.

Die rote Liste hat eine höhere Priorität als die grüne Liste, d.h. eine Domain, die in beiden auftaucht, wird auf die rote Liste gesetzt. Außerdem bleiben gesperrte Konten auch dann gesperrt, wenn sie zu einer Domäne gehören, die auf der grünen Liste steht.

Die Domänennamen müssen exakt sein: Es gibt keine Hierarchie, und Subdomänen müssen ebenfalls gesperrt werden, wenn Sie dies wünschen.

Sie können eine Domäne (oder eine Liste von Domänen) mit dem Befehl !addred global sperren, was zur Folge hat, dass auch alle entsprechenden Konten, falls sie bereits registriert sind, abgemeldet werden und sich nicht erneut registrieren können. Sie können dies mit dem Befehl !delred rückgängig machen, und mit !listred alle auflisten.

Die Befehle !addgreen, delgreen und !listgreen bewirken dasselbe für die grüne Liste, mit den folgenden Unterschieden: Das Hinzufügen einer Domäne zur grünen Liste bewirkt nichts weiter, aber wenn (und nur wenn) die Bridge auf den Modus der grünen Liste eingestellt ist, wird das Entfernen der Domäne die Registrierung aller entsprechenden Konten aufheben, wenn sie bereits registriert sind, und sie daran hindern, sich erneut zu registrieren.

Und schließlich: Wenn eine Domain von dem Server, der die Bots beherbergt (Mastodon oder XMPP), blockiert wird, kann sie die Bridge natürlich überhaupt nicht benutzen, da sie nicht in der Lage ist, die Bots zu kontaktieren.

Einsatzszenarien

Zusammenfassend lässt sich sagen, dass die Bridge viele Werkzeuge für die Moderation und den Schutz vor Missbrauch bietet und flexibel ist, was die Verwaltung Ihrer Benutzer angeht.

Ziehen Sie die folgenden Szenarien in Betracht:

• Sie möchten, dass Ihre Bridge für alle offen ist? Verwenden Sie einfach die Standardeinstellungen und verwalten Sie Block-, Rot- und Grünlisten - das ist die Einstellung, die wir auf unserer Bridge verwenden.
• Sie möchten, dass Ihre Bridge nur für eine begrenzte Gemeinschaft offen ist? Bitten Sie den Server-Administrator der Bridge, sie auf den Modus „Grüne Liste“ einzustellen und Ihre grüne Liste zu definieren.
• Sie möchten, dass Ihre Bridge nur Ihre lokalen Benutzer bedient? Machen Sie es wie zuvor und lassen Sie die grüne Liste leer (lokale Bot-Domains sind immer erlaubt).

Installation einer eigenen XMPP/AP-Bridge

Aus Gründen des Datenschutzes und der Skalierbarkeit sollten Sie Ihre eigene Bridge installieren, ganz im Sinne der Föderation.

Die Homepage des Projekts ist öffentlich zugänglich hier auf Github (in englischer Sprache).

Nutzen Sie es für das Gute, nicht für das Böse. Und viel Spaß!

Bridge Fediverse – XMPP para administradores

Introducción: ¿qué es un administrador?

Si aún no lo ha hecho, comience por leer la guía del usuario para familiarizarse con las principales funcionalidades. Enlace: aquí

Esta guía es para administradores del Bridge; un «administrador» es un usuario estándar con privilegios especiales que le permiten un mayor control sobre las operaciones del Bridge y las acciones de moderación global.

Es un rol diferente al del administrador del servidor, que tiene control total sobre los bots y la instalación y operaciones del backend del sistema. En la práctica, podría ser la misma persona detrás, pero no tiene por qué. El rol de administrador del servidor no se describe aquí, pero se presenta con el código fuente en la página del proyecto.

El administrador del servidor es también quien otorga el rol de administrador a una o varias cuentas (tanto #XMPP y/o #Fediverse), que pueden estar en cualquier instancia. Es opcional pero recomendable asignar al menos un administrador para Fediverse y otro para XMPP; para recibir informes de los usuarios, es obligatorio tener al menos un administrador XMPP (de los cuales el primero recibirá dichos informes si está configurado).

Como se ha dicho, los administradores pueden actuar como usuarios normales. Centrémonos ahora en los comandos adicionales que tienen. Esta lista de comandos puede ser consultada usando !ahelp

Consideraciones sobre privacidad

Antes de eso, unas palabras sobre privacidad.

Fediverse no soporta encriptación de extremo a extremo (E2EE). Por lo tanto, no tiene sentido intentar implementar E2EE desde XMPP, por lo que todos los mensajes se envían y reciben en texto claro. Esto no significa que sean visibles públicamente y de hecho no lo son: sino que simplemente están protegidos por derechos de control de acceso, tal y como lo están los mensajes directos en Mastodon, a modo de ejemplo.

En cuanto a cualquier puente que actúe como proxy para enviar y recibir mensajes, esto tiene las siguientes implicaciones:

• Los administradores de su instancia XMPP y Fediverse pueden leer sus mensajes (como con cualquier otro mensaje no encriptado).
• El administrador del servidor del Bridge, que también controla los bots, puede leer tus mensajes (hasta que se borren automáticamente después de 30 días).
• El administrador de la instancia Mastodon que aloja el primer bot, y el administrador de la instancia XMPP que aloja el segundo bot, pueden leer tus mensajes. Podría ser la misma persona que en la línea anterior, pero no tiene por qué.

En nuestro caso en GayFR, el administrador del servidor del Bridge, el administrador Mastodon gayfr.social y el administrador XMPP gayfr.live son el mismo administrador.

Pero en un escenario en el que los administradores del Bridge no sean ninguno de los anteriores, no tendrán acceso al contenido de los mensajes ni a los metadatos.

Así que, de nuevo, introducir un puente significa insertar una persona en el medio capaz de interceptar y leer todos tus mensajes. Usted necesita confiar en esa persona, o mejor aún, se le anima a ejecutar su propia instancia del Bridge en su servidor.

Palabra final: ActivityPub y Fediverse no proporcionan ningún medio para E2EE ni privacidad efectiva. Si eso es lo que buscas, debes utilizar otras herramientas (aunque XMPP por sí solo lo hace, utilizando OMEMO si tu aplicación cliente lo soporta).

Estado del Bridge

Puedes habilitar globalmente el envío / recepción de mensajes usando el comando !start y puedes deshabilitarlo usando !stop

Puede abrir el registro de nuevos usuarios en el Bridge usando el comando !open y puede cerrar los registros usando !close

En cualquier caso, el resto de operaciones del Bridge seguirán estando disponibles, y puede consultar el estado actual de ambos parámetros con el comando !status, que también le indicará si el Bridge está en modo de lista verde (véase más abajo).

Por último, puede obtener una lista de todos los usuarios activos (cuentas no revocadas) y su origen de aplicación con el comando !alistu

Capacidades de moderación

La protección contra los abusos es una de las principales características de este Bridge. Los usuarios estándar ya disponen de las siguientes funciones, a modo de recordatorio:

• Los usuarios de Fediverse tienen que registrarse voluntariamente antes de poder enviar o recibir cualquier mensaje (opt-in). Si no lo hacen, nunca recibirán nada del Bridge.
• Todos los usuarios pueden darse de baja en cualquier momento y si quieren estar seguros de no recibir nada de los bots, sólo tienen que bloquearlos como harían con cualquier otra cuenta.
• La lista de bloqueo personal puede ser gestionada por cada usuario para bloquear a cualquier usuario de Fediverse o XMPP, los comandos son !block, !unblock y !listblock como se presenta en la página de ayuda al usuario.
• Finalmente, cualquier abuso puede ser reportado directamente al administrador del Bridge usando el comando !report que será enviado al primer administrador XMPP.

Además, durante el registro, se realizan comprobaciones elementales para intentar filtrar posibles spammers o respetar las opciones de privacidad: no tener cuentas bot ni de grupo, no tener el hashtag #NoBot ni #NoBridge en el perfil, actividad mínima visible públicamente durante el último mes.

El administrador del servidor también puede configurar el número total máximo de usuarios que pueden registrarse, y establecer un límite de velocidad sobre cuántos mensajes puede enviar cada usuario en un intervalo de cinco minutos.

Además, el administrador del Bridge puede realizar acciones globales de moderación que describiremos a continuación.

Moderación global de cuentas

Puedes bloquear globalmente una cuenta (o una lista de cuentas) usando el comando !ablock, que en efecto también desregistrará la(s) cuenta(s) si ya está(n) registrada(s) y evitará que se registre(n) de nuevo.

Puede anularlo utilizando el comando !aunblock (que, sin embargo, no registrará las cuentas correspondientes, si es necesario tendrán que volver a solicitarlo por sí mismas).

La lista de cuentas bloqueadas globalmente está disponible utilizando el comando !alistb

Moderación global de dominios

Puede gestionar la lista de dominios para ponerlos en la lista roja (todas las cuentas que utilicen ese nombre de dominio están prohibidas) o en la lista verde. Para esta última, hay dos formas diferentes de trabajar:

• Si el Bridge está en modo lista verde (por el administrador del servidor): sólo las cuentas que pertenecen a ese nombre de dominio están autorizadas a registrarse.
• Si no: las cuentas que pertenezcan a la lista verde se saltarán el requisito mínimo de comprobación de actividad durante el registro.

La lista roja tiene mayor prioridad que la verde, es decir, un dominio que aparezca en ambas será incluido en la lista roja. Además, las cuentas bloqueadas permanecerán bloqueadas aunque se encuentren en un dominio de la lista verde.

Los nombres de dominio deben ser exactos: no hay jerarquía y los subdominios también deben bloquearse si ese es su deseo.

Puedes bloquear globalmente un dominio (o una lista de dominios) utilizando el comando !addred, que en efecto también anulará el registro de todas las cuentas correspondientes si ya están registradas y les impedirá volver a registrarse. Puede cancelar esta acción con el comando !delred, y listar todos con !listred

Los comandos !addgreen, delgreen y !listgreen harán lo mismo para la lista verde, con las siguientes diferencias: añadir un dominio a la lista verde no hará nada más, pero si (y sólo si) el Bridge está configurado en modo lista verde, eliminarlo anulará el registro de todas las cuentas correspondientes si ya están registradas e impedirá que vuelvan a registrarse.

Por último: si un dominio está bloqueado por el servidor que aloja los bots (Mastodon o XMPP), obviamente no podrá utilizar el Bridge en absoluto, ya que no podrá ponerse en contacto con los bots.

Escenarios de despliegue

Para concluir, el Bridge ofrece muchas herramientas para la moderación y la protección contra el abuso, y es flexible en la forma de gestionar sus usuarios.

Considere los siguientes escenarios:

• ¿Quiere que su Bridge esté abierto a todos? Sólo tiene que utilizar la configuración estándar y gestionar las listas de bloqueo, las listas rojas y las listas verdes; ésta es la configuración que utilizamos en nuestro Bridge.
• ¿Quieres que tu Bridge esté abierto a una comunidad limitada? Pida al administrador del servidor del Bridge que lo ponga en modo de lista verde y defina su lista verde.
• ¿Quiere que su Bridge sirva sólo a sus usuarios locales? Haga lo mismo que antes y mantenga la lista verde vacía (los dominios bot locales siempre están permitidos).

Instalación de su propio Bridge XMPP/AP

Te animamos a instalar tu propio Bridge, por razones de privacidad y escalabilidad, en el espíritu de la federación.

La página de inicio del proyecto está disponible públicamente aquí en Github (en inglés).

Úsalo para el Bien, no para el Mal. Y que lo disfrutes.

Bridge Fédiverse – XMPP pour les administrateurs

Introduction : qu'est-ce qu'un administrateur ?

Si vous ne l'avez pas encore fait, commencez par lire le guide de l'utilisateur pour vous familiariser avec les principales fonctionnalités. Lien : ici

Ce guide s'adresse aux administrateurs du bridge ; un « administrateur » est un utilisateur standard doté de privilèges spéciaux qui lui permettent de mieux contrôler les opérations du bridge et les actions de modération globales.

Il s'agit d'un rôle différent de celui de l'administrateur du serveur, qui a le contrôle total des bots et de l'installation et du fonctionnement du système. Dans la pratique, il peut s'agir de la même personne, mais ce n'est pas obligatoire. Le rôle de l'administrateur du serveur n'est pas décrit ici mais est présenté avec le code source sur la page du projet.

L'administrateur du serveur est aussi celui qui attribue le rôle d'administrateur à un ou plusieurs comptes (à la fois #XMPP et/ou #Fédiverse), qui peuvent être sur n'importe quelle instance. Il est facultatif mais recommandé d'assigner au moins un administrateur pour le Fédiverse et un pour XMPP ; afin de recevoir les rapports des utilisateurs, il est obligatoire d'avoir au moins un administrateur XMPP (dont le premier recevra ces rapports s'ils sont configurés).

Comme nous l'avons dit, les administrateurs peuvent agir comme des utilisateurs normaux. Concentrons-nous maintenant sur les commandes supplémentaires dont ils disposent. Cette liste de commandes peut être consultée en utilisant !ahelp

Considérations relatives à la vie privée

Avant cela, un mot sur la confidentialité.

Le Fédiverse ne supporte pas le chiffrement de bout en bout (E2EE). Par conséquent, cela n'a aucun sens d'essayer d'implémenter E2EE à partir de XMPP, de sorte que tous les messages sont envoyés et reçus en texte clair. Cela ne signifie pas qu'ils sont visibles publiquement, et en fait ils ne le sont pas : ils sont simplement protégés par des droits de contrôle d'accès, tout comme le sont les messages directs dans Mastodon, par exemple.

Comme pour tout pont qui agit comme un proxy pour envoyer et recevoir des messages, cela a les implications suivantes :

• Les administrateurs de votre instance XMPP et Fédiverse peuvent lire vos messages (comme pour tout autre message non crypté).
• L'administrateur du serveur Bridge, qui contrôle également les bots, peut lire vos messages (jusqu'à ce qu'ils soient supprimés automatiquement après 30 jours).
• L'administrateur de l'instance Mastodon qui héberge le premier robot et l'administrateur de l'instance XMPP qui héberge le second robot peuvent lire vos messages. Il peut s'agir de la même personne que pour la ligne précédente, mais ce n'est pas obligatoire.

Dans notre cas sur GayFR, l'administrateur du serveur Bridge, l'administrateur Mastodon de gayfr.social et l'administrateur XMPP de gayfr.live sont le même administrateur.

Mais dans un scénario où les administrateurs du Bridge ne sont aucun de ceux mentionnés ci-dessus, ils n'auront pas accès au contenu des messages ni aux métadonnées.

Une fois de plus, l'introduction d'un pont signifie l'introduction d'une personne au milieu capable d'intercepter et de lire tous vos messages. Vous devez faire confiance à cette personne ou, mieux encore, vous êtes encouragé à exécuter votre propre instance du Bridge sur votre serveur.

Mot de la fin : ActivityPub et Fédiverse ne fournissent aucun moyen pour l'E2EE ni pour une protection efficace de la vie privée. Si c'est ce que vous recherchez, vous devriez utiliser d'autres outils (XMPP seul le fait cependant, en utilisant OMEMO si votre application cliente le supporte).

Statut du Bridge

Vous pouvez activer globalement l'envoi et la réception de messages en utilisant la commande !start et vous pouvez les désactiver en utilisant !stop

Vous pouvez ouvrir l'inscription de nouveaux utilisateurs sur le Bridge en utilisant la commande !open et vous pouvez fermer complètement les inscriptions en utilisant !close

Dans tous les cas, les autres opérations du Bridge restent disponibles, et vous pouvez demander l'état actuel des deux paramètres avec la commande !status qui vous indiquera également si le Bridge est en mode liste verte (voir ci-dessous).

Enfin, vous pouvez obtenir une liste de tous les utilisateurs actifs (comptes non révoqués) et l'origine de leur application en utilisant la commande !alistu

Capacités de modération

La protection contre les abus est une caractéristique majeure de ce Bridge. Pour rappel, les utilisateurs standards disposent déjà des fonctionnalités suivantes :

• Les utilisateurs du Fédiverse doivent d'abord s'inscrire volontairement avant de pouvoir envoyer ou recevoir un message (opt-in). S'ils ne le font pas, ils ne recevront jamais rien du Bridge.
• Tous les utilisateurs peuvent se désinscrire à tout moment et s'ils veulent être sûrs de ne rien recevoir des bots, il suffit de les bloquer comme n'importe quel autre compte.
• Une liste de blocage personnelle peut être gérée par chaque utilisateur pour bloquer tout utilisateur Fédiverse ou XMPP, les commandes sont !block, !unblock et !listblock comme présenté sur la page d'aide de l'utilisateur.
• Enfin, tout abus peut être signalé directement à l'administrateur du Bridge en utilisant la commande !report qui sera envoyée au premier administrateur XMPP.

De plus, lors de l'inscription, des vérifications élémentaires sont effectuées pour essayer de filtrer les éventuels spammeurs ou pour respecter les choix de confidentialité : pas de compte bot ou de groupe, pas de hashtag #NoBot ou #NoBridge dans le profil, un minimum d'activité publiquement visible au cours du dernier mois.

L'administrateur du serveur peut également configurer le nombre total maximum d'utilisateurs qui peuvent s'inscrire et fixer une limite au nombre de messages que chaque utilisateur peut envoyer dans une fenêtre de cinq minutes.

De plus, l'administrateur du Bridge peut effectuer des actions de modération globales que nous décrivons ci-dessous.

Modération globale des comptes

Vous pouvez bloquer globalement un compte (ou une liste de comptes) à l'aide de la commande !ablock, ce qui aura pour effet de désenregistrer le(s) compte(s) s'il(s) est (sont) déjà enregistré(s) et d'empêcher qu'il(s) ne s'enregistre(nt) à nouveau.

Vous pouvez annuler cette opération à l'aide de la commande !aunblock (qui n'inscrira toutefois pas les comptes correspondants ; si nécessaire, ils devront à nouveau s'inscrire par eux-mêmes).

La liste des comptes bloqués globalement est disponible à l'aide de la commande !alistb

Modération globale des domaines

Vous pouvez gérer une liste de domaines à mettre sur liste rouge (tous les comptes utilisant ce nom de domaine sont interdits) ou sur liste verte. Dans ce dernier cas, il y a deux façons de procéder :

• Si le Bridge est configuré en mode liste verte (par l'administrateur du serveur) : seuls les comptes appartenant à ce nom de domaine sont autorisés à s'inscrire.
• Si ce n'est pas le cas, les comptes qui appartiennent à la liste verte ne seront pas soumis au contrôle d'activité minimum requis lors de l'inscription.

La liste rouge a une priorité plus élevée que la liste verte, en d'autres termes, un domaine qui apparaît dans les deux listes sera mis sur liste rouge. De même, les comptes bloqués resteront bloqués même s'ils se trouvent dans un domaine figurant sur la liste verte.

Les noms de domaine doivent être exacts : il n'y a pas de hiérarchie et les sous-domaines doivent également être bloqués si vous le souhaitez.

Vous pouvez bloquer globalement un domaine (ou une liste de domaines) à l'aide de la commande !addred, ce qui aura pour effet de désinscrire tous les comptes correspondants s'ils sont déjà enregistrés et de les empêcher de s'inscrire à nouveau. Vous pouvez annuler cette opération en utilisant la commande !delred, et lister tous les domaines avec !listred

Les commandes !addgreen, delgreen et !listgreen feront la même chose pour la liste verte, avec les différences suivantes : ajouter un domaine à la liste verte ne fera rien de plus, mais si (et seulement si) le Bridge est configuré en mode liste verte, l'enlever désenregistrera tous les comptes correspondants s'ils sont déjà inscrits et les empêchera de s'inscrire à nouveau.

Enfin : si un domaine est bloqué par le serveur hébergeant les bots (Mastodon ou XMPP), il ne pourra évidemment pas utiliser le Bridge puisqu'il ne pourra pas contacter les bots.

Scénarios de déploiement

En conclusion, le Bridge offre de nombreux outils de modération et de protection contre les abus, et est flexible dans la façon dont vous pouvez gérer vos utilisateurs.

Envisagez les scénarios suivants :

• Vous voulez que votre Bridge soit ouvert à tous ? Il vous suffit d'utiliser les paramètres standard et de gérer les listes de blocage, les listes rouges et les listes vertes, c'est le paramètre que nous utilisons sur notre Bridge.
• Vous voulez que votre Bridge soit ouvert à une communauté limitée ? Demandez à l'administrateur du serveur de le mettre en mode liste verte et définissez votre liste verte.
• Vous souhaitez que votre Bridge ne serve qu'à vos utilisateurs locaux ? Faites comme précédemment et gardez la liste verte vide (les domaines locaux des bots sont toujours autorisés).

Installation de votre propre Bridge XMPP/AP

Vous êtes encouragé à installer votre propre Bridge, pour des raisons de confidentialité et d'échelle, dans l'esprit de la fédération.

La page d'accueil du projet est publiquement disponible ici sur Github (en anglais).

Utilisez-le pour le Bien, pas pour le Mal. Et profitez-en !

Fediverse – XMPP Bridge for administrators

Introduction: what is an administrator?

If you haven't already, please start by reading the user guide to get familiar with the main functionalities. Link: here

This guide is for administrators of the Bridge; a so-called “administrator” is a standard user with special privileges which allow you further control over the Bridge operations and global moderation actions.

It is a different role than the server administrator, who has full control over the bots and the system backend installation and operations. In practise, it could be the same person behind, but it doesn't have to be. The server administrator role is not described here but is presented with the source code on the project's page.

The server administrator is also the one who grants the administrator role to one or several accounts (both #XMPP and/or #Fediverse), who can be on any instance. It is optional but recommended to assign at least one administrator for Fediverse and one for XMPP; in order to receive reports by users, it is mandatory to have at least one XMPP administrator (of whom the first one will receive such reports if configured).

As said, administrators can act as normal users. Let's focus now on the additional commands they have. This list of commands can be queried using !ahelp

Privacy considerations

Before that, a word about privacy.

Fediverse does not support end-to-end encryption (E2EE). Therefore, it makes no sense to try and implement E2EE from XMPP, so all messages are sent and received in clear text. It doesn't mean they are publicly visible and in fact they are not: but they are simply protected by access control rights, just as direct messages in Mastodon are, as an example.

As for any bridge which acts as a proxy to send and receive messages, this has the following implications:

• Your XMPP and your Fediverse instance administrators can read your messages (as with any other non-encrypted message).
• The Bridge server administrator, who also controls the bots, can read your messages (until they are deleted automatically after 30 days).
• The Mastodon instance administrator hosting the first bot, and the XMPP instance administrator hosting the second bot, can read your messages. It could be the same person as for the previous line, but it doesn't have to be.

In our case on GayFR, the Bridge server administrator, the gayfr.social Mastodon administrator and the gayfr.live XMPP administrator are the same admin.

But in a scenario where Bridge administrators are none of the above, they will not have access to messages contents nor metadata.

So again, introducing a bridge means inserting a person-in-the-middle able to intercept and read all your messages. You need to trust that person, or better still, you are encouraged to run your own instance of the Bridge on your server.

Final word: ActivityPub and the Fediverse do not provide any means for E2EE nor effective privacy. If that is what you are seeking, you should use other tools (XMPP alone does, though, using OMEMO if your client application supports it).

Bridge status

You can enable globally the sending / receiving of messages using the command !start and you can disable it using !stop

You can open new registrations to the Bridge using the command !open and you can close registrations altogether using !close

Either way, the other operations of the Bridge will all remain available, and you can query the current status for both parameters with the command !status which will also tell you if the Bridge is set to greenlist mode (see below).

Finally, you can get a list of all active users (non-revoked accounts) and their application origin using the command !alistu

Moderation capabilities

Protection against abuse is a major feature of this Bridge. Standard users already have the following features available to them, as a reminder:

• Fediverse users have to register voluntarily first, before they can send or receive any message (opt-in). If they don't, they will never receive anything from the Bridge.
• All users can unregister at any time and if they want to be sure not to receive anything from the bots, just block them as you would any other account.
• Personal blocklist can be managed by each user to block any Fediverse or XMPP user, the commands are !block, !unblock and !listblock as presented on the user help page.
• Finally, any abuse can be reported directly to the Bridge administrator using the command !report which will be sent to the first XMPP admin.

Also, during registration, elementary checks are done to try and filter out possible spammers or to respect privacy choices: no bot nor group accounts, no #NoBot nor #NoBridge hashtag in profile, minimum publicly visible activity during the last month.

The server administrator can also configure the maximum total number of users who can register, and set a rate limit on how many messages each user can send within a five-minutes window.

In addition, the Bridge administrator can perform global moderation actions which we shall describe below.

Global accounts moderation

You can globally block an account (or a list of accounts) using the command !ablock, which will in effect also unregister the account(s) if it(they) are already registered and prevent it(them) from registering again.

You can cancel this using the command !aunblock (which will not, however, register the corresponding accounts, if necessary they will have to apply by themselves again).

The list of globally blocked accounts is available using the command !alistb

Global domain moderation

You can manage list of domains to either redlist (all accounts using that domain name are forbidden) or greenlist accounts. For the latter, there are two different ways of working:

• If the Bridge is set to greenlist mode (by the server administrator): only the accounts which belong to that domain name are authorized to register.
• If not: accounts which belong to the greenlist will skip the activity check minimum requirement during registration.

Redlist has a higher priority than greenlist, in other words, a domain which appears in both will be redlisted. Also, blocked accounts wil remain blocked even if in a greenlisted domain.

Domain names must be exact: there is no hierarchy and subdomains must also be blocked if that is your wish.

You can globally block a domain (or a list of domains) using the command !addred, which will in effect also unregister all corresponding accounts if they are already registered and prevent them from registering again. You can cancel this using the command !delred, and list all with !listred

The commands !addgreen, delgreen and !listgreen will do the same for the greenlist, with the following differences: adding a domain to the greenlist will do nothing more, but if (and only if) the Bridge is set to greenlist mode, removing it will unregister all corresponding accounts if they are already registered and prevent them from registering again.

Finally: if a domain is blocked by the bot server (Mastodon or XMPP), it will obviously not be able to use the Bridge at all as it won't be able to contact the bots.

Deployment scenarios

To conclude, the Bridge offers many tools for moderation and protection against abuse, and is flexible in how you can manage your users.

Consider the following scenarios:

• You want your Bridge open to all? Just use the standard settings and manage blocklists, redlists and greenlists, this is the setting we use on our Bridge.
• You want your Bridge open to a limited community? Ask the Bridge server administrator to set it to greenlist mode and define your greenlist.
• You want your Bridge to serve only your local users? Do as previously and keep the greenlist empty (local bot domains are always allowed).

Installing your own XMPP/AP Bridge

You are encouraged to install your own Bridge, for privacy and scalability reasons, in the spirit of federation.

The project's home page is publicly available here on Github.

Use for Good, not for Evil. And enjoy!

Fediverse – XMPP Bridge

Rechtstreeks chatten tussen Fediverse toepassingen (Mastodon, Pixelfed, Friendica,...) en XMPP (instant messaging, vroeger bekend als Jabber)!

Begin nu!

Vanuit je #Fediverse-applicatie: stuur een bericht naar @xmpp_bridge@gayfr.social en vermeld je XMPP-ontvanger(s) in het formaat xmpp:name@example.net.

Vanuit uw #XMPP-client: stuur een chat naar xmpp:ap_bridge@gayfr.live en vermeld uw Fediverse-ontvanger(s) in het formaat @name@example.net.

U kunt direct antwoorden op een ontvangen bericht, naar meerdere ontvangers sturen en persoonlijke blokkadelijsten beheren, tussen alle Fediverse en XMPP servers.

Wil je meer details? Stuur !help naar @xmpp_bridge@gayfr.social of xmpp:ap_bridge@gayfr.live !

Heeft u nog geen XMPP-account? Maak er onmiddellijk een aan op onze instantie door @xmpp_bot@gayfr.social te volgen of door je te registreren op gayfr.online.

Heb je nog geen Fediverse account? Maak er dan nu een aan op onze Mastodon instantie op gayfr.social

Gedetailleerde beschrijving

Een bericht schrijven

Alle berichten worden ontvangen en verzonden van ofwel @xmpp_bridge@gayfr.social (van/naar een Fediverse toepassing) of xmpp:ap_bridge@gayfr.live (van/naar een XMPP-client), dubbele bot-accounts.

Het schrijven van een bericht verloopt volgens hetzelfde patroon, ofwel vanuit uw Fediverse-toepassing ofwel vanuit uw XMPP-client. U kunt uw voorkeurstaal instellen, een commando uitvoeren of een bericht naar één of meerdere ontvangers sturen.

Om een bericht te schrijven, adresseert u gewoon de accountnaam van de ontvanger(s) wanneer u naar de bot-account schrijft. Antwoorden worden ontvangen van dezelfde bot-account. Als u antwoordt op een ontvangen bericht, kunt u dit direct doen zonder de oorspronkelijke afzender te vermelden.

Als u op XMPP werkt, kunt u accounts van Fediverse blokkeren; omgekeerd, als u op een Fediverse-toepassing werkt, kunt u XMPP-accounts blokkeren. In beide gevallen kunt u geen berichten meer versturen naar of ontvangen van geblokkeerde accounts (deze worden stilzwijgend geweigerd aan de kant van de verzender).

De conventies voor de naamgeving van accounts, zowel voor het schrijven naar als voor het blokkeren, zijn als volgt:

• Vanuit XMPP kunt u Fediverse-accounts aanspreken in het formaat @name@example.net.
• Vanuit Fediverse-toepassingen kunt u XMPP-accounts aanspreken in het formaat xmpp:name@example.net.

Een bericht beantwoorden

Berichten ontvangen via de bot zijn “direct” zichtbaar (Fediverse) en worden voorafgegaan door een tekst die je vertelt van wie het verzonden is.

Je kunt direct antwoorden op het laatst ontvangen bericht van een afzender, zonder dat je zijn naam hoeft te noemen.

In XMPP kun je ook meerdere berichten na elkaar naar dezelfde ontvanger sturen na een eerste bericht waarin de naam van de ontvanger wordt genoemd. Dat doen of direct antwoorden op een ontvangen bericht in XMPP moet echter binnen een beperkte tijd gebeuren (momenteel 90 minuten), anders moet de accountnaam van de ontvanger opnieuw worden genoemd. Dit is om verwarring te voorkomen, omdat de meeste XMPP-clients conversaties met dezelfde tegenhanger niet apart threaden, dus alle berichten die via de bot worden ontvangen zullen in dezelfde thread staan, ongeacht de oorspronkelijke afzender.

Er is geen dergelijke beperking in Fediverse applicaties aangezien berichten een aparte thread volgen. Bovendien is dit in overeenstemming met de verschillende filosofie en tijdlijnen die verwacht worden van Fediverse (het posten van statussen) en XMPP (instant messaging).

Lijst van commando's

Om een commando uit te voeren, schrijf je in je bericht !command met een van de volgende:

• !block om een of meerdere accounts toe te voegen aan je blokkadelijst (deze kunnen je dan geen berichten meer sturen).
• !unblock om een of meerdere accounts van je blokkadelijst te verwijderen.
• !listblock om je huidige geblokkeerde accounts op te sommen.
• !report om een gebruiker te rapporteren of andere verzoeken aan de beheerder, vermeld in je bericht de gedetailleerde reden (spam, misbruik, bugrapport...).
• !register om je account te registreren (optioneel, zie hieronder voor meer details).
• !unregister om je account te unregistreren.
• !help om een korte hulpbeschrijving te ontvangen.

Om een voorkeurstaal in te stellen, schrijf je in je bericht !lang=xx waar xx de tweelettercode is voor een ondersteunde taal (momenteel: fr, en, es, de, it, pt, nl). Uw berichten zullen dan deze taal instellen, evenals de bot.

Registratie

Je kunt je account op de volgende drie manieren bij de bridge registreren:

• Automatisch: je wordt geregistreerd de eerste keer dat je de bridge gebruikt om een bericht naar een ontvanger te sturen.
• Eén-klik: volg gewoon @xmpp_bridge@gayfr.social (Fediverse) of voeg xmpp:ap_bridge@gayfr.live toe aan je contacten (XMPP).
• Gebruik het hierboven beschreven commando !register.

Bij het registreren stuurt de bridge een volg- (Fediverse) of contact- (XMPP) verzoek terug, dat u moet accepteren om mogelijke beperkingen in het ontvangen van berichten te vermijden (afhankelijk van uw account of uw serverinstellingen).

Op Fediverse applicaties kunt u geen berichten ontvangen totdat u geregistreerd bent; dit is zo ontworpen om ongewenste spam te voorkomen. Op XMPP kunt u, als uw account dit accepteert, zelfs ongeregistreerd berichten van de bridge ontvangen, omdat dit overeenkomt met de filosofie van instant messaging.

Aanvullende controles worden gecontroleerd bij registratie voor verdere veiligheid: server blocklists, account type en activiteit, aanwezigheid van #NoBot of #NoBridge hashtags in profiel, maximaal totaal aantal geregistreerde gebruikers... Als je het gevoel hebt dat je onterecht gefilterd bent door de bot, neem dan contact op met de beheerder van deze instantie om het probleem op te lossen (bijvoorbeeld door gebruik te maken van het commando !report hierboven vermeld).

U kunt zich op elk moment afmelden met het commando !unregister zoals hierboven beschreven (het afmelden van de bot-account zal ook uw account afmelden, maar alleen op XMPP); een alternatieve manier is om de bot-account te blokkeren. U kunt zich later opnieuw registreren met het commando !register of door de bot-account te deblokkeren.

Beperkingen

De volgende beperkingen zijn ingesteld, ofwel door technische beperkingen, ofwel door ontwerp:

• Alleen één-op-één chatgesprekken zijn mogelijk: geen audio- of videogesprekken, geen kamers / chats met meerdere gebruikers (MUC).
• Het delen van media is mogelijk via links en afhankelijk van het beleid van uw XMPP-server (zie hieronder).
• Berichten moeten in duidelijke tekst worden verzonden: end-to-end encryptie (E2EE) wordt niet ondersteund en zou ook geen zin hebben omdat Fediverse-toepassingen dit niet ondersteunen.
• Het aantal ontvangers dat u per bericht kunt aanspreken is beperkt (momenteel tot 4), om spam te vermijden.
• Er is een limiet op het aantal berichten dat je kunt versturen binnen een periode van vijf minuten, wederom om misbruik te voorkomen, maar het zou meer dan voldoende moeten zijn voor normaal gebruik.

De bot zal antwoorden wanneer er iets te zeggen valt (commando uitgevoerd, hints, fout,...), en zal zwijgen wanneer een bericht succesvol verzonden is: dit is om een normale conversatie mogelijk te maken zonder spammy statussen.

Merk echter op dat het mogelijk is dat uw ontvanger uw bericht niet ontvangt om verschillende redenen zonder feedback (uw account is geblokkeerd, de account van de ontvanger bestaat niet,...): dit is zo ontworpen om de privacy te respecteren en ook om rekening te houden met technische configuraties die door sommige servers worden opgelegd; ook is het mogelijk dat sommige Fediverse-toepassingen slechts één ontvanger toelaten en uw bericht negeren als het meerdere ontvangers bevat (bijv. Pixelfed).

Media delen

Het delen van media gebeurt via links, mediabestanden worden niet van de ene server naar de andere gestuurd: dit is gedaan om onnodige complexiteit te vermijden, bandbreedte en opslag te besparen en rekening te houden met de verschillende technische serverconfiguraties.

Vanuit Fediverse-toepassingen voegt u gewoon uw mediabestanden toe aan uw bericht, de links naar de originele bestanden worden naar XMPP gestuurd.

Vanuit XMPP moet u de conversatie starten met een eerste tekstbericht naar uw ontvanger en vervolgens zoveel geüploade bestanden verzenden als u wilt; de bijbehorende links worden naar uw Fediverse ontvanger gestuurd. Dit schema is nodig omdat in de meeste XMPP-clients mediabestanden één voor één als afzonderlijke berichten worden geüpload en verstuurd, zodat de bridge eerst op de hoogte moet zijn van de beoogde ontvanger voordat u de links deelt. Uiteraard moeten deze links ook publiekelijk zichtbaar zijn (dit kan afhangen van de configuratie van uw XMPP-server).

Beheer van berichten

Elk verzonden bericht kan achteraf niet meer gewijzigd worden: zelfs als u uw oorspronkelijk verzonden bericht vanaf uw client (zowel Fediverse als XMPP) kunt wijzigen of corrigeren, zullen deze wijzigingen niet gereflecteerd worden aan de ontvangende kant en zal er geen nieuw bericht verzonden worden.

De bewaartijd van elk bericht dat door de bots (zowel Fediverse als XMPP) wordt verzonden of ontvangen is beperkt tot 30 dagen, waarna het wordt verwijderd.

Gebruiksregels

Deze bot is onderdeel van GayFR diensten en het gebruik ervan volgt dezelfde regels, beschikbaar op gayfr.online