feat(docs): improve rucio OIDC token documentation

Author: garciagenrique

docs/rucio.md

@@ -59,15 +59,18 @@ If the authentication was successful, you will see a message with you Rucio user
 [client]
 rucio_host = https://vre-rucio.cern.ch
 auth_host = https://vre-rucio-auth.cern.ch
-ca_cert = /etc/pki/tls/certs/CERN-bundle.pem
+ca_cert = /etc/pki/tls/certs/CERN-bundle.pem    # Generic CA certs filepath
+#ca_cert = /certs/rucio_ca.pem                  # Use this path if you are in a VRE session
 auth_type = oidc
 account = <MY_RUCIO_ACCOUNT>
 oidc_audience = rucio
+oidc_polling = true
+oidc_issuer = escape
 oidc_scope = openid profile offline_access 
 request_retries = 3
-oidc_issuer = escape
-oidc_polling = true
 auth_oidc_refresh_activate = true
+auth_token_file_path = /tmp/rucio_oauth.token   # Path in where OIDC tokens will be stored upon authN
+
 
 [policy]
 permission = escape 
@@ -145,9 +148,20 @@ Despite the rucio client package should install most of the software dependencie
 # For a Alma9 - x86_64 distrubution
 dnf install -y epel-release.noarch
 dnf upgrade -y
-dnf install -y wget gfal2*        # To install the gfal2 libraries
+dnf install -y "gfal2*"           # To install the gfal2 libraries
 dnf install -y voms-clients-java  # To install the `voms-proxy-init` client
 ```
+:::info[developers]
+The command `dnf search gfal2*` will list all the `gfal2` tools and plugins.
+:::
+
+:::warning[Debian distributions]
+Gfal2 can be also installed via [`conda-forge`](https://anaconda.org/search?q=gfal2).
+```bash
+conda install -c conda-forge gfal2 gfal-util python-gfal2
+```
+:::
+
 Then, install the certificates for the VOMS validation:
 ```python
 # Install the LCG trust anchos for X.509 authentication - what brings the CERN-bundle.pem file needed on the rucio.cfg

package.json

@@ -14,9 +14,9 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
-    "@docusaurus/core": "3.8.0",
-    "@docusaurus/preset-classic": "3.8.0",
-    "@docusaurus/theme-live-codeblock": "^3.8.0",
+    "@docusaurus/core": "3.8.1",
+    "@docusaurus/preset-classic": "3.8.1",
+    "@docusaurus/theme-live-codeblock": "3.8.1",
     "@fortawesome/fontawesome-free": "^6.7.2",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
@@ -25,8 +25,8 @@
     "react-dom": "^18.0.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.8.0",
-    "@docusaurus/types": "3.8.0"
+    "@docusaurus/module-type-aliases": "3.8.1",
+    "@docusaurus/types": "3.8.1"
   },
   "browserslist": {
     "production": [