Come configurare Remote Desktop usando le API Web

Note: Le API UBIQUITY richiamano l'endpoint https://ubiquity.asem.it.

È possibile configurare una connessione Remote Desktop nella pagina Web utilizzando le API Web UBIQUITY. Per farlo, seguire i tre passaggi descritti di seguito:

Eseguire l'autenticazione al proprio dominio in UBIQUITY Manager.
Ottenere l'UID del dispositivo a cui si desidera connettersi.
Aprire Remote Desktop del dispositivo selezionato.

Eseguire l'autenticazione al proprio dominio in UBIQUITY Manager

Eseguire l'autenticazione al dominio utilizzando l'API /api/user/authenticate.

L'autenticazione può avvenire in due modi.

Immettendo e-mail e password
Immettendo dominio, nome utente e password

Note: Potrebbe essere necessario eseguire un'autenticazione a due fattori, se questa funzione è attivata.

L'esempio indicato di seguito mostra un'autenticazione effettuata utilizzando e-mail e password come credenziali.

var jwt;const login = async (email, password) => {
  var endpoint = document.getElementById ('endpoint').value;
  const response = await fetch (endpoint + '/api/user/authenticate', {
      method: 'POST',
      body: JSON.stringify({
          'Email': email,
          'Password': password
      )},
      headers: {
          'Content-Type': 'application/json'
      }
   });
jwt = await response.text();
document.getEelementById('jwt').innerHTML = jwt;
}

var loginButton = document.getElementById('loginButton');
loginButton.addEventListener('click', () => }
    var email = document.getElementById('email').value;
    var password = document.getElementById('Password').value;
    login(email, password);
});

Una volta immesse le credenziali corrette, verrà generato un token che scadrà dopo una settimana. Utilizzare questo token per eseguire l'operazione successiva.

Note: Un token include informazioni personali e non deve essere condiviso.

Ottenere l'UID del dispositivo a cui si desidera connettersi

Utilizzare l'API /api/devices/find per identificare il dispositivo con cui si desidera stabilire una connessione Remote Desktop.

È possibile recuperare il GUID del dispositivo specificando il percorso del dispositivo all'interno del relativo dominio.

var guid;const getGUID = async (path) => {
  var endpoint = document.getElementById ('endpoint').value;
  const response = await fetch (endpoint + '/api/devices/find?path=' + path, {
      method: 'GET',
      headers: {
          'Authorization': 'Bearer' + jwt,
      }
  });
  var jsonResponse = await response.json ();
  guid = jsonResponse.Id;
  document.getElementById('guid').innerHTML = guid;
}var deviceGUIDButton = document.getElementById('deviceGUIDButton');
deviceGUIDButton.addEventListener('click', () => {
    var path = document.getElementById('path').value;
    getGUID(PATH);
});

Una volta immesso il percorso, se corretto, verrà fornito il GUID del dispositivo.

Aprire Remote Desktop del dispositivo selezionato

Dopo aver ottenuto sia l'UID del dispositivo che il token, è possibile stabilire una connessione Remote Desktop usando l'URL: Endpoint + /controlcenter/remoteDesktop/ + GUID + Token.

var connectButton = document.getElementById('connectButton');
connectButton.addEventListener('click', () => {var endpoint = document.getElementById('endpoint').value;var url = endpoint + "/controlcenter/remoteDesktop/" + guide + "?accessToken" + jwt;var deviceDesktop = document.getElementById('deviceDesktop');
deviceDesktop.src = url;

Ora è possibile visualizzare Remote Desktop del dispositivo connesso all'interno della pagina web designata.