Cómo iniciar una conexión con Supremo mediante un enlace o URL

Debe lanzar el enlace o URL específico (es. supremo://123123123 donde 123123123 es el Supremo ID de la máquina remota). Introduzca la contraseña Supremo de la máquina remota

Integrando Supremo en aplicaciones de terceros como RMM, puede agilizar los flujos de trabajo de TI y aumentar la eficiencia.

Tenga en cuenta: la aplicación, sitio web o cualquier software de terceros que necesita para iniciar una conexión con Supremo por enlace o URL requieren los siguientes requisitos previos:

• ID del cliente Supremo remoto
• la contraseña
• capacidad de hash de la contraseña con el estándar BCrypt antes de enviarla en la solicitud de endpoint – el BCrypt utilizado es: Bcrypt «a» ($2a) con 10 rondas de expansión de clave (saltRounds=10)
• API Key para autenticar las solicitudes API. La API Key será proporcionada por Nanosystems (haga clic aquí para ponerse en contacto con nosotros) y será diferente para cada usuario/empresa/software que se integre con Supremo

Para iniciar la conexión sin escribir la contraseña, la aplicación de terceros que integra Supremo necesita para ejecutar una solicitud POST que devuelve un token único. El token único devuelto será pasado en la URL que abrirá Supremo de esta forma:

supremo:///?otp=

DETALLES DE LA PETICIÓN

DOMINIO

• api.services.nanosystems.com (todas las peticiones deben ejecutarse mediante protocolo https)

AÑADIR CONTRASEÑA BCRYPT Y OBTENER OTP

(utilizado por aplicaciones, sitios web o software que necesitan conectarse a Supremo sin escribir la contraseña, antes de componer la URL supremo://)

• POST /supremo/addPassphrase/

Autenticación

La solicitud se autentica mediante header «x-api-key«. El valor del header»x-api-key» es la Api Key proporcionada a cada usuario.»

Ejemplo JSON Body
{
"bcpassword": "string"
}


donde «bcpassword» es la contraseña cifrada con la función BCrypt

Ejemplo responses

200 (Success)
{
"otp": "string"
}


donde «otp» es el TOKEN ÚNICO a utilizar en la URL de Supremo (supremo://?otp=)

403 (Access Denied)
{
"error": "Access Denied!"
}


Authentication Bearer Token no válido o vacío

400 (Bad Request)
{
"error": "Invalid header or body format"
}


JSON no válido o el encabezado “Content-Type” no es “application/json”