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

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.

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“