Procházet zdrojové kódy

[docs] Add note about specific user for webcron (#2142)

* [docs] Add note about specific user for webcron

Cf. https://github.com/FreshRSS/FreshRSS/issues/613#issuecomment-353585547

* Small changes

* Use one of the RFC addresses for examples
Frans de Jonge před 7 roky
rodič
revize
e2cb8b929b
2 změnil soubory, kde provedl 19 přidání a 8 odebrání
  1. 9 4
      docs/en/users/03_Main_view.md
  2. 10 4
      docs/fr/users/03_Main_view.md

+ 9 - 4
docs/en/users/03_Main_view.md

@@ -35,14 +35,14 @@ Here is an example to trigger article update every hour.
 
 
 If you do not have access to the installation server scheduled task, you can still automate the update process.
 If you do not have access to the installation server scheduled task, you can still automate the update process.
 
 
-To do so, you need to create a scheduled task, which need to call a specific URL: https://your.server.net/FreshRSS/p/i/?c=feed&a=actualize (it could be different depending on your installation). Depending on your application authentication method, you need to adapt the scheduled task.
+To do so, you need to create a scheduled task, which need to call a specific URL: https://freshrss.example.net/i/?c=feed&a=actualize (it could be different depending on your installation). Depending on your application authentication method, you need to adapt the scheduled task.
 
 
 #### No authentication
 #### No authentication
 
 
 This is the most straightforward since you have a public instance; there is nothing special to configure:
 This is the most straightforward since you have a public instance; there is nothing special to configure:
 
 
 ```cron
 ```cron
-0 * * * * curl 'https://your.server.net/FreshRSS/p/i/?c=feed&a=actualize'
+0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize'
 ```
 ```
 
 
 ### Form authentication
 ### Form authentication
@@ -60,16 +60,21 @@ You can also configure an authentication token to grant a special right on the s
 The scheduled task syntax to use will be the following:
 The scheduled task syntax to use will be the following:
 
 
 ```cron
 ```cron
-0 * * * * curl 'https://your.server.net/FreshRSS/p/i/?c=feed&a=actualize&token=my-token'
+0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&token=my-token'
 ```
 ```
 
 
+You can also target a different user by adding their username to the query string, with `&user=insert-username`:
+
+```cron
+0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&user=someone&token=my-token'
+```
 
 
 ### HTTP authentication
 ### HTTP authentication
 
 
 In that case, the syntax in the two previous section are unusable. It means that you need to provide your credentials to the scheduled task. **Note that this method is highly discouraged since it means that your credentials will be in plain sight!**
 In that case, the syntax in the two previous section are unusable. It means that you need to provide your credentials to the scheduled task. **Note that this method is highly discouraged since it means that your credentials will be in plain sight!**
 
 
 ```cron
 ```cron
-0 * * * * curl -u alice:password123 'https://your.server.net/FreshRSS/p/i/?c=feed&a=actualize'
+0 * * * * curl -u alice:password123 'https://freshrss.example.net/i/?c=feed&a=actualize'
 ```
 ```
 
 
 ## Manual update
 ## Manual update

+ 10 - 4
docs/fr/users/03_Main_view.md

@@ -35,14 +35,20 @@ Ci-dessous vous trouverez un exemple permettant la mise à jour des articles tou
 
 
 Il se peut que vous n’ayez pas accès aux tâches planifiées du serveur hébergeant votre instance de FreshRSS. Il reste une possibilité pour mettre les flux à jour automatiquement.
 Il se peut que vous n’ayez pas accès aux tâches planifiées du serveur hébergeant votre instance de FreshRSS. Il reste une possibilité pour mettre les flux à jour automatiquement.
 
 
-Pour cela vous devez paramétrer une tâche cron qui devra charger régulièrement une url spécifique : https://votre.serveur.net/FreshRSS/p/i/?c=feed&a=actualize (à adapter selon votre installation). Différents cas de figure peuvent se présenter à vous désormais.
+Pour cela vous devez paramétrer une tâche cron qui devra charger régulièrement une url spécifique : https://freshrss.example.net/i/?c=feed&a=actualize (à adapter selon votre installation). Différents cas de figure peuvent se présenter à vous désormais.
 
 
 ##### Aucune authentification
 ##### Aucune authentification
 
 
 C’est le cas le plus simple, puisque votre instance est publique, vous n’avez rien de particulier à préciser :
 C’est le cas le plus simple, puisque votre instance est publique, vous n’avez rien de particulier à préciser :
 
 
 ```cron
 ```cron
-0 * * * * curl 'https://votre.serveur.net/FreshRSS/p/i/?c=feed&a=actualize'
+0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize'
+```
+
+Vous pouvez également choisir un utilisateur différent en ajoutant son nom d'utilisateur à la chaîne de requête, avec `&user=nom-dutilisateur` :
+
+```cron
+0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&user=someone&token=my-token'
 ```
 ```
 
 
 ##### Authentification par formulaire
 ##### Authentification par formulaire
@@ -60,7 +66,7 @@ Vous pouvez aussi configurer un jeton d’authentification pour accorder un droi
 La tâche cron à utiliser sera de la forme suivante :
 La tâche cron à utiliser sera de la forme suivante :
 
 
 ```cron
 ```cron
-0 * * * * curl 'https://votre.serveur.net/FreshRSS/p/i/?c=feed&a=actualize&token=mon-token'
+0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&token=mon-token'
 ```
 ```
 
 
 
 
@@ -69,7 +75,7 @@ La tâche cron à utiliser sera de la forme suivante :
 Dans ce cas-là, le token et les permissions “anonymes” sont inutilisables et il vous sera nécessaire d’indiquer vos identifiants dans la tâche cron. **Notez que cette solution est grandement déconseillée puisqu’elle implique que vos identifiants seront visibles en clair !**
 Dans ce cas-là, le token et les permissions “anonymes” sont inutilisables et il vous sera nécessaire d’indiquer vos identifiants dans la tâche cron. **Notez que cette solution est grandement déconseillée puisqu’elle implique que vos identifiants seront visibles en clair !**
 
 
 ```cron
 ```cron
-0 * * * * curl -u alice:password123 'https://votre.serveur.net/FreshRSS/p/i/?c=feed&a=actualize'
+0 * * * * curl -u alice:password123 'https://freshrss.example.net/i/?c=feed&a=actualize'
 ```
 ```
 
 
 ## Mise à jour manuelle
 ## Mise à jour manuelle