From a5994eaf56fc994022abd40b886e57f38d4eb780 Mon Sep 17 00:00:00 2001
From: Andreas Steiger <52162439+anst-i@users.noreply.github.com>
Date: Thu, 2 May 2024 13:23:25 +0100
Subject: [PATCH] Update webservicesetup.md

Added info about the Moodle token
---
 doc/webservicesetup.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/webservicesetup.md b/doc/webservicesetup.md
index 0965d54..41dbf25 100644
--- a/doc/webservicesetup.md
+++ b/doc/webservicesetup.md
@@ -22,7 +22,7 @@ This plugin requires the [import as new version](https://github.com/maths/moodle
   - Assigned the role to the user. (Site administration/User/Permissions/Assign system roles)
   - Enable the webservice (Site administration/Server/Web services/External services/qbank_gitsync/Edit) and on the same page 'Show more...' and enable file upload within the webservice.
   - Authorise the user to use the service. (Site administration/Server/Web services/External services/qbank_gitsync/Authorised users)
-- Go to Site administration/Server/Web services/Manage tokens in Moodle and create a token for the user `ws-gitsync-user`.
+- Go to Site administration/Server/Web services/Manage tokens in Moodle and create a token for the user `ws-gitsync-user`. Copy this string and store it somewhere safe as you won't be able to access it anymore once you have left the page! You will need this token later when configuring up the connection to your Moodle installation.
 ![Screenshot of token creation.](../images/Add_token.png)
 - Add roles for the user to give them access to the required courses and questions. If you would like them to have site-wide access, go to Site Administration/Users/Permissions/Assign system roles and give `ws-gitsync-user` Manager role for the webservice to have access to all questions on the site.  If you only want them to have access to particular courses, then make `ws-gitsync-user` Manager on courses individually.
 - If you have user agreements set up for your Moodle site, you will need to accept them on behalf of the Gitsync user. (Site Administration/Users/Privacy and policies/Manage policies/Agreements/Accept)
@@ -38,4 +38,4 @@ Fill in the URL and parameters above in the fields as shown in the screenshot an
 ![Screenshot of Postman.](../images/Postman.png)
 
 ## Additional security
-The token essentially allows question export, import and delete for all contexts for which the webservice user has question edit permissions. It's like a manager password but less obscured - be careful! Restrict the contexts the user has access to for added security and to reduce the chance of user error. **Also create severely limited lifespan tokens and/or restrict the valid IP address.** You can have multiple tokens, each for a different IP address to allow access for different colleagues/computers. 
\ No newline at end of file
+The token essentially allows question export, import and delete for all contexts for which the webservice user has question edit permissions. It's like a manager password but less obscured - be careful! Restrict the contexts the user has access to for added security and to reduce the chance of user error. **Also create severely limited lifespan tokens and/or restrict the valid IP address.** You can have multiple tokens, each for a different IP address to allow access for different colleagues/computers.