feat: add information about token validity times

Signed-off-by: Jana Peper <[email protected]>

Author: janepie

apps/webhook_listeners/lib/Controller/WebhooksController.php

@@ -115,6 +115,7 @@ public function show(int $id): DataResponse {
 	 * @param ?array<string,mixed> $tokenNeeded List of user ids for which to include auth tokens in the event.
 	 *                                          Has two fields: "user_ids" list of user uids for which tokens are needed, "user_roles" list of roles (users not defined by their ID but by the role they have in the webhook event) for which tokens can be included.
 	 *                                          Possible roles: "owner" for the user creating the webhook, "trigger" for the user triggering the webhook call.
+	 *                                          Requested auth tokens are valid for 1 hour after receiving them in the event call request.
 	 *
 	 * @return DataResponse<Http::STATUS_OK, WebhookListenersWebhookInfo, array{}>
 	 *
@@ -189,6 +190,7 @@ public function create(
 	 * @param ?array<string,mixed> $tokenNeeded List of user ids for which to include auth tokens in the event.
 	 *                                          Has two fields: "user_ids" list of user uids for which tokens are needed, "user_roles" list of roles (users not defined by their ID but by the role they have in the webhook event) for which tokens can be included.
 	 *                                          Possible roles: "owner" for the user creating the webhook, "trigger" for the user triggering the webhook call.
+	 *                                          Requested auth tokens are valid for 1 hour after receiving them in the event call request.
 	 *
 	 * @return DataResponse<Http::STATUS_OK, WebhookListenersWebhookInfo, array{}>
 	 *

apps/webhook_listeners/lib/Service/TokenService.php

@@ -29,6 +29,7 @@ public function __construct(
 	 * The array ['user_ids' => ['jane', 'bob'], 'user_roles' => ['owner', 'trigger']]
 	 * as requested tokens in the registered webhook produces a result like
 	 * ['user_ids' => [['jane' => 'abcdtokenabcd1'], ['bob','=> 'abcdtokenabcd2']], 'user_roles' => [['owner' => ['admin' => 'abcdtokenabcd3']], ['trigger' => ['user1' => 'abcdtokenabcd4']]]]
+	 * Created auth tokens are valid for 1 hour.
 	 *
 	 * @param WebhookListener $webhookListener
 	 * @param string|null $triggerUserId the user that triggered the webhook call