Docs - fix 'fr' translations

This commit is contained in:
Sam
2023-06-21 19:45:47 +02:00
parent 4491b8f8de
commit a32c8a1925
41 changed files with 145 additions and 176 deletions

View File

@ -236,9 +236,9 @@
<p>Pour permettre à une application tierce dinteragir avec les points daccès de lAPI, un client <a class="reference external" href="https://datatracker.ietf.org/doc/html/rfc6749">OAuth2</a> peut être créé dans les paramètres de lutilisateur (onglet “apps”).</p>
<div class="admonition warning">
<p class="admonition-title">Avertissement</p>
<p>Les points dentrée OAuth2 nécessitant une authentification ne sont pas accessibles par des applications tierces (<a class="reference external" href="api/oauth2.html">documentation</a>), seulement par lapplication web FitTrackee).</p>
<p>Les points dentrée OAuth2 nécessitant une authentification ne sont pas accessibles par des applications tierces (<a class="reference external" href="api/oauth2.html">documentation</a>), seulement par lapplication web de FitTrackee).</p>
</div>
<p>Il ne prend en charge que le flux avec un <a class="reference external" href="https://datatracker.ietf.org/doc/html/rfc6749#section-1.3.1">Code dAutorisation</a> (avec prise en charge de <a class="reference external" href="https://datatracker.ietf.org/doc/html/rfc7636">PKCE</a>). Il permet déchanger un code dautorisation contre un jeton daccès. Lidentifiant et le secret du client doivent être envoyés dans le corps du message (méthode « POST »). Il est recommandé dutiliser PKCE pour assurer une meilleure sécurité.</p>
<p>Seul le flux avec <a class="reference external" href="https://datatracker.ietf.org/doc/html/rfc6749#section-1.3.1">Code dAutorisation</a> (avec <a class="reference external" href="https://datatracker.ietf.org/doc/html/rfc7636">PKCE</a>) est pris en charge. Il permet déchanger un code dautorisation contre un jeton daccès. Lidentifiant et le secret du client doivent être envoyés dans le corps du message (méthode « POST »). Il est recommandé dutiliser PKCE pour assurer une meilleure sécurité.</p>
<section id="scopes">
<h2>Scopes<a class="headerlink" href="#scopes" title="Lien permanent vers cette rubrique">#</a></h2>
<p>Les scopes suivants sont disponibles :</p>
@ -276,14 +276,14 @@
</div>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">client_id</span></code> : lidentifiant du client affiché après lenregistrement</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">response_type</span></code> : <code class="docutils literal notranslate"><span class="pre">code</span></code>, FitTrackee ne supportant que le flux de code dautorisation.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">response_type</span></code> : <code class="docutils literal notranslate"><span class="pre">code</span></code>, FitTrackee ne supportant que le flux avec code dautorisation.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">scope</span></code> : scopes séparés par des espaces.</p></li>
</ul>
<div class="line-block">
<div class="line">et des paramètres facultatifs :</div>
</div>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">state</span></code> : valeur unique pour empêcher la falsification des requêtes entre les sites</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">state</span></code> : valeur unique pour empêcher la falsification des requêtes entre les sites (<em>cross-site request forgery</em> (CSRF))</p></li>
</ul>
<div class="line-block">
<div class="line">Pour PKCE, les paramètres suivants sont obligatoires :</div>
@ -298,7 +298,7 @@
</div>
</li>
<li><div class="line-block">
<div class="line">Après lautorisation, FitTrackee redirige vers lapplication tierce, de sorte que lapplication tierce puisse obtenir le code dautorisation à partir de lURL de redirection et récupère ensuite un jeton daccès avec lidentifiant et le secret du client (point daccès <a class="reference external" href="https://samr1.github.io/FitTrackee/api/oauth2.html#post--api-oauth-token">/api/oauth/token</a>).</div>
<div class="line">Après autorisation, FitTrackee redirige vers lapplication tierce, de sorte que lapplication tierce puisse obtenir le code dautorisation à partir de lURL de redirection et récupère ensuite un jeton daccès avec lidentifiant et le secret du client (point daccès <a class="reference external" href="https://samr1.github.io/FitTrackee/api/oauth2.html#post--api-oauth-token">/api/oauth/token</a>).</div>
<div class="line">Exemple dURL de redirection :</div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">https://example.com/callback?code=&lt;AUTHORIZATION_CODE&gt;&amp;state=&lt;STATE&gt;</span></code></div>
</div>
@ -311,7 +311,7 @@
<div class="admonition warning">
<p class="admonition-title">Avertissement</p>
<div class="line-block">
<div class="line">Si FitTrackee fonctionne derrière un proxy, len-tête <code class="docutils literal notranslate"><span class="pre">X-Forwarded-Proto</span></code> doit être défini.</div>
<div class="line">Si FitTrackee fonctionne derrière un <em>proxy</em>, len-tête <code class="docutils literal notranslate"><span class="pre">X-Forwarded-Proto</span></code> doit être défini.</div>
<div class="line">Par exemple pour <code class="docutils literal notranslate"><span class="pre">nginx</span></code> :</div>
</div>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>proxy_set_header X-Forwarded-Proto $scheme;
@ -324,8 +324,8 @@
<p>Quelques ressources sur OAuth 2.0 :</p>
<ul class="simple">
<li><p><a class="reference external" href="https://www.oauth.com">OAuth 2.0 Simplified</a> par <a class="reference external" href="https://aaronparecki.com">Aaron Parecki</a> (exemple pour le flux avec le <a class="reference external" href="https://www.oauth.com/oauth2-servers/server-side-apps/example-flow/">code dauthorisation et PKCE</a>)</p></li>
<li><p><a class="reference external" href="https://requests-oauthlib.readthedocs.io/en/latest/examples/real_world_example.html">Web App Example of OAuth 2 web application flow</a> with Requests-OAuthlib (python)</p></li>
<li><p><a class="reference external" href="https://docs.authlib.org/en/latest/client/oauth2.html#oauth-2-session">OAuth 2 Session</a> with Authlib (python)</p></li>
<li><p><a class="reference external" href="https://requests-oauthlib.readthedocs.io/en/latest/examples/real_world_example.html">Web App Example of OAuth 2 web application flow</a> avec Requests-OAuthlib (python)</p></li>
<li><p><a class="reference external" href="https://docs.authlib.org/en/latest/client/oauth2.html#oauth-2-session">OAuth 2 Session</a> avec Authlib (python)</p></li>
<li><p><a class="reference external" href="https://codeberg.org/SamR1/ft-oauth-client">Exemple dune application minimale interagissant avec FitTrackee</a> (python)</p></li>
</ul>
</section>