Wie man eine Verbindung mit Supremo über einen Link oder eine URL startet

Mit Supremo können Sie einen nahtlosen Fernzugriff auf Computer und Server ermöglichen.

Um eine Fernverbindung über einen Link oder eine URL herzustellen, folgen Sie den Schritten in dieser Anleitung.

Verbindung durch manuelle Eingabe des Passworts

Sie müssen den Link oder die spezifische URL aufrufen (z.B. supremo://123123123, wobei 123123123 die Supremo ID des entfernten Rechners ist). Geben Sie das Supremo-Passwort des entfernten Rechners ein.

Verbinden ohne Eingabe des Passworts

Durch die Integration von Supremo in Anwendungen von Drittanbietern, wie z. B. RMM, können Sie die IT-Workflows optimieren und die Effizienz steigern.

Bitte beachten Sie: Die App, die Website oder jede Software von Drittanbietern, die eine Verbindung mit Supremo über einen Link oder eine URL herstellen muss, benötigt die folgenden Voraussetzungen:

  • die ID des entfernten Supremo-Clients
  • das Passwort
  • Die Fähigkeit, das Passwort mit dem BCrypt-Standard zu hashen, bevor es an den Endpunkt gesendet wird – das verwendete BCrypt ist: Bcrypt „a“ ($2a) mit 10 Runden der Schlüsselexpansion (saltRounds=10)
  • API Key zur Authentifizierung von API-Anfragen. Der API Key wird von Nanosystems bereitgestellt (klicken Sie hier, um mit uns in Kontakt zu treten) und ist für jeden Benutzer/jedes Unternehmen/jede Software, die mit Supremo integriert wird, unterschiedlich

Um die Verbindung ohne Passworteingabe zu starten, muss die Drittanbieter-App, die Supremo integriert, eine POST-Anfrage ausführen, die ein eindeutiges Token zurückgibt. Das zurückgegebene eindeutige Token wird in der URL übergeben, die Supremo auf diese Weise öffnen wird:

supremo:///?otp=

ANFRAGEDETAILS

DOMAIN
  • api.services.nanosystems.com (alle Anfragen müssen über das https-Protokoll ausgeführt werden)
BCRYPT-PASSWORT HINZUFÜGEN UND OTP ABRUFEN

(wird von Anwendungen, Websites oder Software verwendet, die sich mit Supremo verbinden müssen, ohne das Passwort einzugeben, bevor die URL supremo:// erstellt wird)

  • POST /supremo/addPassphrase/

Authentifizierung

Die Anfrage wird durch den header „x-api-key“ authentifiziert. Der Wert des „x-api-key“-header ist der Api-Schlüssel, der jedem Benutzer zur Verfügung gestellt wird.

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

wobei „bcpassword“ das mit der BCrypt-Funktion gehashte Passwort ist

Beispiel für Antworten

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

wobei „otp“ der UNIQUE TOKEN ist, der für die Supremo URL zu verwenden ist (supremo://?otp=)

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

Ungültiges oder leeres Authentication Bearer Token

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

Ungültiges JSON oder der Header „Content-Type“ ist nicht „application/json“

Beispiel für einen Anwendungsfall

Supremo Webhooks können sehr nützlich für die Integration mit Systemen sein, die URLs öffnen können.

Mit dieser Integration wird die Bereitstellung von Fernunterstützung aus Anwendungen von Drittanbietern (z. B. RMM und IT Dashboard) schnell und einfach. Wenn die Techniker eine Verbindung zum entfernten Gerät herstellen wollen, können sie einfach auf die Schaltfläche oder den Link klicken, der den URL-Handler enthält, und Supremo öffnet und startet automatisch eine Verbindung.