Interacción vía API

Esta guía te explica cómo empezar a utilizar la API de SCAYLE. Primero deber;as obtener la cookie de sesión DSID y, a continuación, tendrás que generar tu token de autenticación. Una vez autenticado, podrás comenzar a interactuar con la API con las herramientas y librerías que se describen a continuación.

Paso 1 - Obtener la cookie de sesión DSID

El acceso a los servicios internos requiere autenticarse previamente en la VPN de SCAYLE mediante Ivanti Pulse Secure. Emplea el siguiente script para realizar el inicio de sesión:

login.py

Al ejecutar el script deberá introducir:

• Usuario de SCAYLE
• Constrasena de SCAYLE
• OTP de SCAYLE (Doble Factor de Autenticación)

python3 login.py

El script guardará la cookie DSID en el archivo ~/.ivanti_dsid. A partir de ahí, cualquier petición o script podrá reutilizarla. Define la variable de entorno de la siguiente forma:

DSID=$(cat ~/.ivanti_dsid)

Paso 2 - Obtener el token de la API

Desde la línea de comandos, lanza la siguiente petición curl:

curl -X POST 'https://extranet.scayle.es:11010/api/v1/auths/ldap' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Cookie: DSID=${DSID}" \
  -d '{
    "user": "SCAYLE_user",
    "password": "SCAYLE_password"
  }' | grep -oP '"token":"\K[^"]+'

Copia el valor del token. Lo necesitarás en el header Authorization para autenticar todas tus peticiones posteriores a la API. Define la variable de entorno de la siguiente forma:

TOKEN=TU_TOKEN_AQUI  

Paso 3 - Obtener ID de los modelos

Realiza la siguiente petición curl:

curl -X GET \
  'https://extranet.scayle.es:11010/api/models' \
  -H "Cookie: DSID=${DSID}; token=${TOKEN}" | grep -oP '"preset":true,"info":\{"id":"\K[^"]+'

Recibirás un listado con los IDs de cada modelo, que podrás emplear más adelante para interactuar con el modelo.

Paso 4 - Interacción con la API

Ahora ya podrás utilizar las siguientes maneras de interactuar o usar otras externas.