# Tutorial para subir o RapConector e RapSign com Ngrok e Localtunnel em uma máquina local

O RAPSign WEB e o Conector devem estar configurados para usar conexão HTTPS. 

Para realizar os testes utilize serviços como o ngrok e Localtunnel para gerar links com https, e com isso basta substituir os links gerados nas portas correspondentes no arquivo docker-compose e realizar os testes necessários.

1. Primeiro, instale o ngrok, o endereço para download do ngrok é  <https://ngrok.com/download>, escolha seu sistema operacional e faça o download.
2. Depois de instalado o ngrok, adicione o *authtoken:*

   ***a. $ ngrok config add-authtoken \<token>***

   *b. Não tem um token de autenticação? Obtenha aqui (*[*https://dashboard.ngrok.com/signup*](https://dashboard.ngrok.com/signup)*)*
3. Logo em seguida inicie um túnel do ngrok:

   ***a. $ ngrok http 80***
4. Guarde a URL da variável *Forwarding*:&#x20;

<figure><img src="https://30362825-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB-V5yqZBtdQcJVbpRg%2Fuploads%2F5jztJrOFG2rd4J6MahqE%2Fimage.png?alt=media&#x26;token=9c6fb4a7-86db-4e09-b279-e75cf5eb8d97" alt=""><figcaption></figcaption></figure>

5. No seu docker-compose.yaml procure pelas variáveis DOCUMENTATION\_SERVER e API\_URL e altere os valores delas para a URL da variável *Forwarding* **ngrok** (passo 4) e salve o arquivo.
6. Agora execute o comando abaixo para subir o RapSign e RapConector:

   ***a. $ docker-compose -f docker-compose.api.yml up***
7. Por último, instale e inicie o [Localtunnel](https://localtunnel.github.io/www/). Instale Localtunnel globalmente (requer NodeJS) para torná-lo acessível em qualquer lugar:

   ***a. $ npm install -g localtunnel***
8. Inicie um servidor web na porta **3000 (RapSign)** e use a interface de linha de comando para solicitar um túnel para seu servidor local:

   ***a. lt --port 3000***
9. Você receberá uma url, que será a URL do seu **RapSign,** por exemplo [https://gqgh.localtunnel.me](https://gqgh.localtunnel.me/), que poderá compartilhar com qualquer pessoa enquanto sua instância local do lt permanecer ativa. Quaisquer solicitações serão roteadas para seu serviço local na porta especificada.
10. Para acessar o site, confirme o IP público do criador do túnel. Para obter seu endereço IP público, você pode seguir qualquer um destes:

    a. Se você estiver executando o *localtunnel* em um computador local, acesse este link em seu navegador: [https://ipv4.icanhazip.com](https://ipv4.icanhazip.com/)

    b. Se você estiver executando o *localtunnel* em um computador remoto, execute um destes comandos via ssh ou terminal remoto para obter o IP público remoto: ***curl*** [***ipv4.icanhazip.com***](http://ipv4.icanhazip.com/) ou ***wget -q -O -*** [***ipv4.icanhazip.com***](http://ipv4.icanhazip.com/)

    <br>

&#x20; &#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.rnp.br/diplomas-digitais/passo-a-passo/tutorial-para-subir-o-rapconector-e-rapsign-com-ngrok-e-localtunnel-em-uma-maquina-local.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.