Authors: [[Christine Lemmer-Webber]], [[Jessica Tallon]], [[Erin Shepherd]], [[Amy Guy]], [[Evan Prodromou]]

Abstract

The ActivityPub protocol is a decentralized social networking protocol based upon the [[ActivityStreams]] 2.0 data format. It provides a client to server API for creating, updating and deleting content, as well as a federated server to server API for delivering notifications and content.

ActivityPub & Communecter

Informations générales

Comment utiliser ActivityPub

Pour utiliser ActivityPub (AP) vous devrez avoir un acteur accessible en public. Le format de votre acteur doit être en JSON-LD. Votre acteur doit ressembler à ceci : exemple acteur sur le site communecter partir développement.

L’id doit correspond à l’URL du document, tous les liens doit être en HTTPS.

Vous aurez besoin d’une inbox car les instances qui utilisent AP ont besoin reconnait un acteur si celui-ci possède une inbox. Chaque acteur nécessite une publicKey et une privateKey qui peut être généré avec openssl.

JSON ne prend en charge les sauts de ligne, on doit remplacer les sauts de ligne par \n (pour la partir publicKeyPEM).

Le Webfinger permet de demandé à un site web "Avez vous un utilisateur avec ce nom d’utilisateur" et de recevoir des liens de ressource en réponse. Le noeud finale d’un Webfinger se trouve toujours en /.well-known/webfinger et recevoir des requêtes tel que /.well-known/webfinger?resource=acct:name@ my-example.com

Pour pouvoir envoyé un message (par exemple avec le verbe "Create"), il est nécessaire d’avoir la inbox de la personne concerné et d’utiliser un HTTP signature qui permettra de savoir si l’acteur qui souhaite envoyer un message est le bon. Une signature HTTP s’agit d’un en-tête HTTP signé par la paire de clés RSA. Pour avoir plus d’information sur la création d’une signature HTTP, référencier vous le lien suivant partir HTTP signature : [How to implement a basic ActivityPub server(https://blog.joinmastodon.org/2018/06/how-to-implement-a-basic-activitypub-server/).

Liens pratique :

• Setting Up a WebFinger Server
• How to implement a basic ActivityPub server
• ActivityPub W3
• Decentralizing Social Interactions with ActivityPub

Développement en cours (Tony et Pierre)

Réalisation d’un acteur AP sur Communecter

J’ai crée une api qui permet de généré un acteur AP sur communecter, vous pouvez trouvez un exemple en cliquant ici. Petit précision : la publicKey est en format brute. Comment sa fonctionne : Vous devrez indiquez dans le lien id de la personne ici : http://dev.communecter.org/api/activitypub/actor/id/ + userId.

Fichier modifier : TranslateActivityStream.php / Rest.php . Fichier crée : ActivityPubController.php / ActorAction.php .

Création d’un client mastodon

Nous avons crée avec Pierre un client mastodon qui permet de poster/récupéré les statuts/récupéré les followers/voir la timelines public en utilisant le REST API et en ce basant sur cette librairie mastodon.js par Kirschn. Vous pouvez retrouvez nos codes ici (gitlab.adullact) : mastodon_api

Test d’un serveur express-activitypub en nodejs

J’ai suivi ce tutoriel là pour pouvoir envyer un message sur mamot.fr : Decentralizing Social Interactions with ActivityPub. Pierre a détaillé plus en bas comment réaliser le tutoriel. Remarque constaté : Pour pouvoir voir un message sur mamot.fr, nous étions dans l’obligation de suivre notre acteur crée par express activitypub, sans cela, il nous est impossible de voir nos message dans le timeline. Ce problème est régurant quand on a tenté avec un compte pixelfed de communiqué avec mamot.fr.

La réalisation d’une inbox (non fonctionnelle)

Je me suis basé sur le script crée par Darius Kazemi sur son tutoriel Decentralizing Social Interactions with ActivityPub. Malheureusement je n’arrive pas à faire fonctionné mon inbox car je n’arrive pas a encodé la signature.

Création d’un client Mastodon

Utilisation de l’API mamot pour pouvoir afficher les timelines public, local, ajouter un post. Afin de pourvoir acceder a le page mastodon cliquer içi Join Mastodon Mon code source est disponible sur gitlab Code Source

Ajout d’un acteur ActivityPub sur l’API de communecter

Afin d’avoir un aperçus du format d’un acteur ActivityPub en ajoutant votre id a la fin du lien mon lien pour accéder à l’acteur

Test d’envoi d’un message sur mamot

• Taper la commande git clone [https://github.com/dariusk/express-activitypub.git](https://github.com/dariusk/express-activitypub.git) dans votre terminal.
  • Installer ngrok, en suivante les instructions https://ngrok.com/download.
  • Taper la commande /.ngrok/http 3000
  • Ensuite allez dans le dossier express-activityPub, modifier le dossier config.json dans route.
  • Mettre un nom d’utilisateur
  • Mettre un mot de passe
  • Le port sera 3000, et le domain sera l’adresse en https de ngrok, mais il faut retirer le https, pour obtenir ceci exemple: d40f1818.ngrok.io
  • Taper la commande node index.js
  • Acceder a l’url du site en https et rajouter admin exemple: [https://d40f1818.ngrok.io/admin](https://d40f1818.ngrok.io/admin)
  • Crée un compte test saisissez le nom d’utlisateur et le mot de passe, ensuite il y aura des données qui seront générés, afficher le account WebFinger url, copier le suject sans la acct:
  • Connecter vous a https://mamot.fr.
  • Rechercher le webfinger url, cliquer sur le bouton pour follow.
  • Ensuite saisir test dans account name, Copier coller l’API Key, et saisir votre message exemple : Hello world !

Et vous pourrez voir le message envoyer sur mtps://mamot.fr

ActivityPub & Communecter

Informations générales

Comment utiliser ActivityPub

Pour utiliser ActivityPub (AP) vous devrez avoir un acteur accessible en public. Le format de votre acteur doit être en JSON-LD. Votre acteur doit ressembler à ceci : exemple acteur sur le site communecter partir développement.

L’id doit correspond à l’URL du document, tous les liens doit être en HTTPS.

Vous aurez besoin d’une inbox car les instances qui utilisent AP ont besoin reconnait un acteur si celui-ci possède une inbox. Chaque acteur nécessite une publicKey et une privateKey qui peut être généré avec openssl.

JSON ne prend en charge les sauts de ligne, on doit remplacer les sauts de ligne par \n (pour la partir publicKeyPEM).

Le Webfinger permet de demandé à un site web "Avez vous un utilisateur avec ce nom d’utilisateur" et de recevoir des liens de ressource en réponse. Le noeud finale d’un Webfinger se trouve toujours en /.well-known/webfinger et recevoir des requêtes tel que /.well-known/webfinger?resource=acct:name@ my-example.com

Pour pouvoir envoyé un message (par exemple avec le verbe "Create"), il est nécessaire d’avoir la inbox de la personne concerné et d’utiliser un HTTP signature qui permettra de savoir si l’acteur qui souhaite envoyer un message est le bon. Une signature HTTP s’agit d’un en-tête HTTP signé par la paire de clés RSA. Pour avoir plus d’information sur la création d’une signature HTTP, référencier vous le lien suivant partir HTTP signature : [How to implement a basic ActivityPub server(https://blog.joinmastodon.org/2018/06/how-to-implement-a-basic-activitypub-server/).

Liens pratique :

• Setting Up a WebFinger Server
• How to implement a basic ActivityPub server
• ActivityPub W3
• Decentralizing Social Interactions with ActivityPub

Développement en cours (Tony et Pierre)

Réalisation d’un acteur AP sur Communecter

J’ai crée une api qui permet de généré un acteur AP sur communecter, vous pouvez trouvez un exemple en cliquant ici. Petit précision : la publicKey est en format brute. Comment sa fonctionne : Vous devrez indiquez dans le lien id de la personne ici : http://dev.communecter.org/api/activitypub/actor/id/ + userId.

Fichier modifier : TranslateActivityStream.php / Rest.php . Fichier crée : ActivityPubController.php / ActorAction.php .

Création d’un client mastodon

Nous avons crée avec Pierre un client mastodon qui permet de poster/récupéré les statuts/récupéré les followers/voir la timelines public en utilisant le REST API et en ce basant sur cette librairie mastodon.js par Kirschn. Vous pouvez retrouvez nos codes ici (gitlab.adullact) : mastodon_api

Test d’un serveur express-activitypub en nodejs

J’ai suivi ce tutoriel là pour pouvoir envyer un message sur mamot.fr : Decentralizing Social Interactions with ActivityPub. Pierre a détaillé plus en bas comment réaliser le tutoriel. Remarque constaté : Pour pouvoir voir un message sur mamot.fr, nous étions dans l’obligation de suivre notre acteur crée par express activitypub, sans cela, il nous est impossible de voir nos message dans le timeline. Ce problème est régurant quand on a tenté avec un compte pixelfed de communiqué avec mamot.fr.

La réalisation d’une inbox (non fonctionnelle)

Je me suis basé sur le script crée par Darius Kazemi sur son tutoriel Decentralizing Social Interactions with ActivityPub. Malheureusement je n’arrive pas à faire fonctionné mon inbox car je n’arrive pas a encodé la signature.

Création d’un client Mastodon

Utilisation de l’API mamot pour pouvoir afficher les timelines public, local, ajouter un post. Afin de pourvoir acceder a le page mastodon cliquer içi Join Mastodon Mon code source est disponible sur gitlab Code Source

Ajout d’un acteur ActivityPub sur l’API de communecter

Afin d’avoir un aperçus du format d’un acteur ActivityPub en ajoutant votre id a la fin du lien mon lien pour accéder à l’acteur

Test d’envoi d’un message sur mamot

• Taper la commande git clone [https://github.com/dariusk/express-activitypub.git](https://github.com/dariusk/express-activitypub.git) dans votre terminal.
  • Installer ngrok, en suivante les instructions https://ngrok.com/download.
  • Taper la commande /.ngrok/http 3000
  • Ensuite allez dans le dossier express-activityPub, modifier le dossier config.json dans route.
  • Mettre un nom d’utilisateur
  • Mettre un mot de passe
  • Le port sera 3000, et le domain sera l’adresse en https de ngrok, mais il faut retirer le https, pour obtenir ceci exemple: d40f1818.ngrok.io
  • Taper la commande node index.js
  • Acceder a l’url du site en https et rajouter admin exemple: [https://d40f1818.ngrok.io/admin](https://d40f1818.ngrok.io/admin)
  • Crée un compte test saisissez le nom d’utlisateur et le mot de passe, ensuite il y aura des données qui seront générés, afficher le account WebFinger url, copier le suject sans la acct:
  • Connecter vous a https://mamot.fr.
  • Rechercher le webfinger url, cliquer sur le bouton pour follow.
  • Ensuite saisir test dans account name, Copier coller l’API Key, et saisir votre message exemple : Hello world !

Et vous pourrez voir le message envoyer sur mtps://mamot.fr

ActivityPub

• [[go]] https://www.w3.org/TR/activitypub/
  • A standard for open social networks.
• One of the [[social web protocols]].
• One of the [[fediverse]] protocols.
• [[go]] https://activitypub.rocks

The ActivityPub protocol is a decentralized social networking protocol based upon the [[ActivityStreams]] 2.0 data format. It provides a client to server API for creating, updating and deleting content, as well as a federated server to server API for delivering notifications and content.

It is a [[W3C]] standard as of January 2018 https://www.w3.org/TR/activitypub/, published by the [[W3C Social Web Working Group]].

The Fediverse SocialHub Discourse forum is where many different ActivityPub-compatible systems come together.

From the forum, How to become an ActivityPub user

From the forum, Introduction to ActivityPub

ActivityPub supports common social network activities like following, liking, announcing, adding, and blocking. For example, if you have an account on a [[Mastodon]] instance like mastodon.social, you can follow someone on a [[WriteFreely]] instance like Qua and receive updates whenever they have a new blog post.

Christopher Lemmer Webber, co-author of the ActivityPub standard:

Increasingly, much of our lives is mediated through social networks, and so network freedom in these spaces – and thus removing central control over them – is critical. One thing you may have noticed in the last decade is that many decentralized free software social networking applications have been written. Sadly, most of those applications can’t actually speak to each other – a fractured federation. I hope that with ActivityPub, we’ve improved that situation.

ActivityPub

Criticisms

My big issues with ActivityPub is that the protocol is very big and not very easy to decompose.

– indieweb chat

Unfortunately, we have come to realize that using ActivityPub is considerably harder than we expected:

• Using JSON-LD as an RDF serialization is very complicated. It requires the usage of algorithms (e.g. the Expansion Algorithm or the Framing Algorithm) that are incomprehensible and just pure madness. JSON-LD maybe was really just not intended to be an RDF serialization and trying to use it as such is painful.

• There are practically no implementations of the ActivityPub Client-to-Server protocol (C2S). This made developing and testing the client and server more time-consuming as we had to develop the protocol in lockstep on client and server. At the end we were still only compatible with our own software.

• ActivityPub is not a complete specification and many additional protocols need to be implemented (e.g. WebFinger) in specific ways in order to be compatible with existing servers.

  – openEngiadina: From ActivityPub to XMPP — inqlab