Comment démarrer une connexion avec Supremo à l’aide d’un lien ou d’une URL

Avec Supremo, vous pouvez fournir un accès à distance transparent aux ordinateurs et aux serveurs.

Pour se connecter à distance à partir d’un lien ou d’une URL, suivez les étapes de ce guide.

Se connecter en entrant manuellement le mot de passe

Vous devez lancer le lien ou l’URL spécifique (ex. supremo://123123123 où 123123123 est l’ID Supremo de la machine distante). Insérer le mot de passe Supremo de la machine distante.

Se connecter sans entrer le mot de passe

En intégrant Supremo dans des applications tierces telles que RMM, vous pouvez rationaliser les flux de travail informatiques et augmenter l’efficacité.

Attention: l’application, le site web ou tout autre logiciel tiers qui doit démarrer une connexion avec Supremo par lien ou URL nécessite les prérequis suivants:

  • l’identifiant du client Supremo distant
  • le mot de passe
  • la capacité à hacher le mot de passe avec le standard BCrypt avant de l’envoyer sur la requête endpoint – le BCrypt utilisé est : Bcrypt « a » ($2a) avec 10 rounds d’expansion de clé (saltRounds=10)
  • API Key pour authentifier les demandes API. La API Key sera fournie par Nanosystems (cliquez ici pour nous contacter) et sera différente pour chaque utilisateur/entreprise/logiciel qui s’intègre à Supremo

Pour démarrer la connexion sans saisir de mot de passe, l’application tierce qui intègre Supremo doit exécuter une requête POST qui renvoie un jeton unique. Le jeton unique retourné sera passé dans l’URL qui ouvrira Supremo de cette manière:

supremo:///?otp=

DÉTAILS DE LA REQUÊTE

DOMAINE
  • api.services.nanosystems.com (toutes les requêtes doivent être exécutées via le protocole https)
AJOUTER LE MOT DE PASSE BCRYPT ET OBTENIR L’OTP

(utilisé par une application, un site web ou un logiciel qui a besoin de se connecter à Supremo sans taper de mot de passe, avant de composer l’URL supremo://)

  • POST /supremo/addPassphrase/

Authentification

La requête est authentifiée par l’header « x-api-key« . La valeur de l’header « x-api-key » est la clé d’api fournie à chaque utilisateur.

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

où « bcpassword » est le mot de passe haché avec la fonction BCrypt

Exemple responses

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

où « otp » est le TOKEN UNIQUE à utiliser sur l’URL Supremo (supremo://?otp=)

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

Authentication Bearer Token invalide ou vide

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

JSON invalide ou l’en-tête “Content-Type” n’est pas “application/json”

Cas d’utilisation

Les Webhooks de Supremo peuvent être très utiles pour intégrer des systèmes qui peuvent ouvrir des URLs.

Grâce à cette intégration, l’assistance à distance à partir d’applications tierces (par exemple, RMM et IT Dashboard) devient rapide et facile. Lorsque les techniciens veulent se connecter à l’appareil distant, ils peuvent simplement cliquer sur le bouton ou le lien contenant l’URL Handler, et Supremo ouvrira et démarrera automatiquement une connexion.