📚 Node [[activitypub]]
↳ 📓 Resource [[@communecter/activitypub]]

📓 garden/communecter/04 - Documentation technique/activitypub.md by @communecter

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 :

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

📓 garden/communecter/en/04 - Documentation technique/activitypub.md by @communecter

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 :

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

Loading pushes...

Rendering context...

📚 Node [[20230911T212548 bonfire networks__activitypub_anarchie_belshaw_bonfire_communs_devuan_dyne_microblog_moodle_openbadges_reflow]] maybe related

📚 Node [[20230913T132856 firefish__activitypub_firefish_fédiverse_mastodon_microblog]] maybe related

📚 Node [[20230913T133100 activitypub__activitypub_bonfire_castopod_firefish_framasoft_mastodon_mobilizon_peertube_twitter_writefreely]] maybe related

📚 Node [[20230913T133801 le microblog__activitypub_bonfire_fediverse_firefish_mastodon_microblog_pleroma_twitter]] maybe related

📚 Node [[20230913T134415 microblog et culpabilité__activitypub_bonfire_firefish_mastodon_microblog_twitter]] maybe related

📚 Node [[activity pub]] maybe related

📚 Node [[agora activitypub integration]] maybe related

📚 Node [[grok activitypub]] maybe related

📚 Node [[matrix activitypub bridge]] maybe related