Come avviare una connessione con Supremo utilizzando un link o un URL

Con Supremo è possibile fornire accesso remoto a computer e server.

Per connettersi da remoto tramite un link o un URL, segui i passi di questa guida.

Connessione inserendo manualmente la password

È necessario aprire il link o l’URL specifico (es. supremo://123123123 dove 123123123 è l’ID Supremo della macchina remota). Inserisci la password di Supremo della macchina remota.

Connessione senza inserire la password

Integrando Supremo in applicazioni di terze parti come un RMM, è possibile semplificare i flussi di lavoro IT e aumentare l’efficienza.

Nota bene: l’app, il sito web o qualsiasi software di terze parti che deve avviare una connessione con Supremo tramite link o URL deve soddisfare i seguenti prerequisiti:

  • ID di Supremo del client remoto
  • la password
  • la possibilità di effettuare l’hash della password con lo standard BCrypt prima di inviare la richiesta all’endpoint – il BCrypt utilizzato è: Bcrypt “a” ($2a) con 10 round di espansione della chiave (saltRounds=10)
  • API Key per autenticare le richieste API. La chiave API ti sarà fornita da Nanosystems (clicca qui per mettervi in contatto con noi) e sarà diversa per ogni utente/azienda/software che si integra con Supremo

Per avviare la connessione senza digitare la password, l’applicazione di terze parti che integra Supremo deve eseguire una richiesta POST che restituisce un token unico. Il token univoco restituito sarà passato nell’URL che aprirà Supremo in questo modo:

supremo:///?otp=

DETTAGLI DELLA RICHIESTA

DOMINIO
  • api.services.nanosystems.com (tutte le richieste devono essere eseguite tramite protocollo https)
AGGIUNGERE PASSWORD BCRYPT E OTTENERE OTP

(utilizzato da app, siti web o software che devono connettersi a Supremo senza digitare la password, prima di comporre l’URL supremo://)

  • POST /supremo/addPassphrase/

Autenticazione

La richiesta è autenticata dall’header “x-api-key”. Il valore dell’header “x-api-key” è la chiave Api fornita a ciascun utente.

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

dove “bcpassword” è la password sottoposta a hash con la funzione BCrypt

Esempio di risposte

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

dove “otp” è il TOKEN UNICO da utilizzare per l’URL di Supremo (supremo://?otp=)

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

Authentication Bearer Token non valido o vuoto

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

JSON non valido o l’header “Content-Type” non è “application/json”.

Casi d’uso

I Webhook di Supremo possono essere molto utili per integrarsi con sistemi in grado di aprire URL.

Con questa integrazione, fornire assistenza remota da applicazioni di terze parti (ad esempio, RMM e Console IT) diventa facile e veloce. Quando i tecnici desiderano connettersi al dispositivo remoto, possono semplicemente fare clic sul pulsante o sul link contenente l’URL Handler e Supremo aprirà e avvierà automaticamente una connessione.