{% extends "base.html" %} {% comment %} SPDX-License-Identifier: GPL-3.0-or-later {% endcomment %} {% load i18n %} {% block content %}

{% trans "Token authentication" %}

À quoi sert un jeton d'authentification ?

Un jeton vous permet de vous connecter à l'API de la Note Kfet via votre propre compte depuis un client externe.
Il suffit pour cela d'ajouter en en-tête de vos requêtes Authorization: Token <TOKEN> pour pouvoir vous identifier.

La documentation de l'API est disponible ici : {{ request.scheme }}://{{ request.get_host }}/doc/api/.
{%trans 'Token' %} : {% if 'show' in request.GET %} {{ token.key }} (cacher) {% else %} caché (montrer) {% endif %}
{%trans 'Created' %} : {{ token.created }}
{% trans "Warning" %} : regénérer le jeton va révoquer tout accès autorisé à l'API via ce jeton !

{% trans "OAuth2 authentication" %}

La Note Kfet implémente également le protocole OAuth2, afin de permettre à des applications tierces d'interagir avec la Note en récoltant des informations (de connexion par exemple) voir en permettant des modifications à distance, par exemple lorsqu'il s'agit d'avoir un site marchand sur lequel faire des transactions via la Note Kfet.

L'usage de ce protocole est recommandé pour tout usage non personnel, car permet de mieux cibler les droits dont on a besoin, en restreignant leur usage par jeton généré.

La documentation vis-à-vis de l'usage de ce protocole est disponible ici : {{ request.scheme }}://{{ request.get_host }}/doc/external_services/oauth2/.

Liste des URL à communiquer à votre application :
{% endblock %}