Salut les amis ! Aujourd’hui, je souhaite vous présenter comment enregistrer le contenu de votre terminal via asciinema.
Si vous écrivez souvent des tutoriels, des writeup ou autres articles, et que cela se passe essentiellement sur le shell, cet article est fait pour vous.
Il est bon à noter qu’ici on ne parle pas d’enregistrer tout l’écran (screen record), mais bien du terminal seulement et donc du flux de vos commandes.
Dans cet article nous verrons comment enregistrer vos commandes en local ou sur le serveur de asciinema. Nous aborderons aussi comment l’inclure dans une page web.
Asciinema, Kezako ?
asciinema est un logiciel libre qui permettant d’enregistrer les entrées et sorties de votre terminal. Sa particularité est le format léger sous lequel il enregistre (Json), contrairement aux screen recorder qui prennent assez d’espace. Il est doté d’une ligne de commande, un site web avec une API et d’un lecteur javascript.
Installation d’asciinema
Premièrement, il nous faut installer l’outil asciinema. Pour ce faire, rien de plus simple, cela se fait sur Kali à l’aide de la commande apt install asciinema
Enregistrement du shell en local
Pour démarrer l’enregistrement et pour l’enregistrer en local, il nous faut juste taper la commande ci-après:
asciinema rec filename
Et voilà ! Tout ce que vous taperez par la suite sera enregistré dans le fichier filename dans le répertoire courant.
Pour arrêter l’enregistrement, il suffit de taper la commande exit ou la combinaison Ctrl + D
Vous obtiendrez de ce fait un fichier en format asciicast.
Le fichier asciicast est en réalité un fichier JSON contenant des meta-data tel que le contenu (stdout) du terminal, la durée d’affichage à l’écran…etc. Vous pouvez en apprendre d’avantage sur ce format si vous le souhaitez ici.
Upload de l’enregistrement sur les serveurs de asciinema
Autre point intéressant est qu’asciinema nous donne la possibilité d’héberger notre enregistrement du shell sur leurs serveurs.
Donc pour le faire, nous taperons simplement la commande asciinema rec. Comme dans le cas précédent, pour terminer l’enregistrement, nous entrons la commande exit ou la combinaison Ctrl + D. Ensuite, il suffira de taper la touche <Entrée> pour héberger sur le serveur de asciinema. Du coup, dans le terminal vous aurez deux liens.
- Un lien que vous partagerez à tout le monde et valable pour 7 jours si l’enregistrement n’est pas lié à un compte ( un truc du genre https://asciinema.org/a/S1VxLt3Skl1V58d4nGWAFU4kD )
- Un lien vous permettant de sauvegarder tous les enregistrements faits sur votre machine en y associant une adresse mail( un truc du genre https://asciinema.org/connect/0478e8b7-63b4-45c7-8238-a527567366b6 )
Comment rejouer son enregistrement asciinema
Pour rejouer un enregistrement depuis son terminal, la commande ci-après nous aidera: asciinema play filename
Ici filename est le chemin vers votre fichier en local ou le lien public de l’enregistrement
Comment Embarquer l’enregistrement du terminal dans une page web
Nous avons enregistré notre shell et le contenu du terminal, c’est bien. Mais le souhait était de le rendre accessible à une communauté ( peut être sur un blog ou dans un rapport de vulnérabilité, etc…).
Pour Inclure le lecteur sur votre site c’est aussi très simple:
<script src="https://asciinema.org/a/386498.js" id="asciicast-386498" async data-autoplay="true" data-size="big"></script>
Vous pouvez personnaliser beaucoup de paramètres de votre enregistrement tel que la vitesse de lecture, la taille de la police ou encore choisir un thème en lisant la documentation de asciinema disponible ici
C’est donc fini pour l’astuce d’aujourd’hui. J’espère que vous l’aurez apprécié et qu’elle vous sera utile.
Je vous laisse découvrir d’autres astuces kali linux dans la rubrique dédiée et moi je vous dis…A très bientôt !
