Como iniciar uma conexão com o Supremo usando uma ligação ou URL

Com o Supremo, pode fornecer acesso remoto sem descontinuidades a computadores e servidores.

Para se ligar remotamente a partir de uma ligação ou URL, siga os passos neste guia.

Ligue-se introduzindo manualmente a palavra-passe

Deve lançar a ligação ou URL específica (es. supremo://123123123 onde 123123123 é a ID Supremo da máquina remota). Inserir a palavra-passe Supremo da máquina remota.

Ligar sem introduzir a palavra-passe

Integrando a Supremo em aplicações de terceiros como RMM, pode racionalizar os fluxos de trabalho de TI e aumentar a eficiência.

Por favor note: a aplicação, website ou qualquer software de terceiros que necessite de iniciar uma ligação com o Supremo por link ou URL, requer os seguintes pré-requisitos:

  • ID do cliente remoto Supremo
  • a senha
  • possibilidade de hash da palavra-passe com o padrão BCrypt antes de a enviar no pedido do ponto final – o BCrypt utilizado é: Bcrypt “a” ($2a) com 10 rondas de expansão de chave (saltRounds=10)
  • API Key para autenticação de pedidos API. A API Key será fornecida pela Nanosystems (clique aqui para nos contactar) e será diferente para cada utilizador/empresa/software que se integra com o Supremo

Para iniciar a ligação sem digitação de senha, a aplicação de terceiros que integra a Supremo necessita de executar um pedido de PÓS que devolve uma ficha única. O token único devolvido será passado no URL que irá abrir Supremo desta forma:

supremo:///?otp=

DETALHES DO PEDIDO

DOMÍNIO
  • api.services.nanosystems.com (todos os pedidos devem ser executados via protocolo https)
ADICIONAR SENHA BCRYPT E OBTER OTP

(utilizado por app, website ou software que precisam de se ligar ao Supremo sem digitar a palavra-chave, antes de compor o URL supremo://)

  • POST /supremo/addPassphrase/

Autenticação

O pedido é autenticado pelo header “x-api-key“. O valor do header “x-api-chave” é a chave Api fornecida a cada utilizador”.

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

onde “bcpassword” é o hashed da password com a função BCrypt

Exemplos de respostas

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

onde “otp” é o TOKEN ÚNICO a utilizar no URL do Supremo (supremo://?otp=)

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

Authentication Bearer Token inválida ou vazia

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

O JSON inválido ou cabeçalho “Content-Type” não é “application/json”

Caso de utilização

O Supremo Webhooks pode ser muito útil para integrar com sistemas que possam abrir URLs.

Com esta integração, o fornecimento de assistência remota de aplicações de terceiros (por exemplo, RMM e IT Dashboard) torna-se rápido e fácil. Quando os técnicos quiserem ligar-se ao dispositivo remoto, podem simplesmente clicar no botão ou link contendo o URL Handler, e a Supremo abrirá automaticamente e iniciará uma ligação.