# FAQ



# IPS e Serviços

<div align="left" dir="ltr" id="bkmrk-servi%C3%A7o-ip-m%C3%A1scara-d"><table border="1" class="align-center" style="border-collapse: collapse; width: 77.284%; height: 876.109px; border: 1px solid rgb(0, 0, 0);"><tbody><tr style="height: 35.3906px;"><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">**Serviço**

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">**IP**

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">**Máscara**

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">**Descrição**

</td></tr><tr style="height: 80.1719px;"><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">bot-service-0

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">192.155.94.122

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">Servidor/serviço de homologação de robôs: autenticação, validação de itens, API de itens únicos e relatórios.

</td></tr><tr style="height: 80.1719px;"><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">bot-service-1

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">198.74.59.198

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">Servidor/serviço de robôs: autenticação, validação de itens, API de itens únicos e relatórios.

</td></tr><tr style="height: 80.1719px;"><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">bot-service-2

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">72.14.183.122

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">Servidor/serviço de robôs: autenticação, validação de itens, API de itens únicos e relatórios.

</td></tr><tr style="height: 80.1719px;"><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">bot-service-3

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">74.207.236.228

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">Servidor/serviço de robôs: autenticação, validação de itens, API de itens únicos e relatórios.

</td></tr><tr style="height: 80.1719px;"><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">bot-service-4

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">45.79.188.61

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">Servidor/serviço de robôs: autenticação, validação de itens, API de itens únicos e relatórios.

</td></tr><tr style="height: 80.1719px;"><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">bot-service-5

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">96.126.124.246

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 80.1719px;">Servidor/serviço de robôs: autenticação, validação de itens, API de itens únicos e relatórios.

</td></tr><tr style="height: 57.7812px;"><td style="border-color: rgb(0, 0, 0); height: 57.7812px;">oystr-app-1

</td><td style="border-color: rgb(0, 0, 0); height: 57.7812px;">139.144.46.66

</td><td style="border-color: rgb(0, 0, 0); height: 57.7812px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 57.7812px;">Servidor/serviço de aplicações: APP de protocolos, APP de intimações.

</td></tr><tr style="height: 102.562px;"><td style="border-color: rgb(0, 0, 0); height: 102.562px;">oystr-app-2

</td><td style="border-color: rgb(0, 0, 0); height: 102.562px;">194.195.218.85

</td><td style="border-color: rgb(0, 0, 0); height: 102.562px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 102.562px;">Servidor/serviço de aplicações: APP de movimentos, APP de monitoramento, APP de pautas. Dados e dashboards internos.

</td></tr><tr style="height: 35.3906px;"><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">oystr2

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">50.116.42.141

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">Servidor de homologação geral.

</td></tr><tr style="height: 57.7812px;"><td style="border-color: rgb(0, 0, 0); height: 57.7812px;">oystr3

</td><td style="border-color: rgb(0, 0, 0); height: 57.7812px;">45.79.194.186

</td><td style="border-color: rgb(0, 0, 0); height: 57.7812px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 57.7812px;">Proxy e resolução de captchas. Servidor de homologação e legado.

</td></tr><tr style="height: 35.3906px;"><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">oystr4

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">23.239.27.38

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">Servidor principal, core e web server.

</td></tr><tr style="height: 35.3906px;"><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">api

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">139.144.57.138

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">API

</td></tr><tr style="height: 35.3906px;"><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">vpn

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">45.79.3.68

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">255.255.255.0

</td><td style="border-color: rgb(0, 0, 0); height: 35.3906px;">VPN

</td></tr></tbody></table>

</div><p class="callout info">Além da lista de IPs acima, os robôs que acessam os sistemas podem, eventualmente, obter um IP dinâmico em função da alocação das máquinas virtuais necessárias para a execução da tarefa.</p>

#### Acesso aos Portais via VPN

Em algums casos, por exigência dos portais acessados pelos robôs, é necessário que o IP de acesso do robô ao site/portal atenda alguma restrição, por exemplo:

- IP do cliente
- IP registrado
- IP nacional

Nestes cenários, é possível fazer com que os robôs acessem o portal via VPN do cliente da Oystr, desde que o cliente realize a configuração da VPN (tipo Open VPN ou Fortinet) e envie para a Oystr as configurações de acesso. A VPN será utilizada apenas pela conta do cliente, para os robôs especificados.

Por enquanto, apenas o Open VPN (v2.5) e Fortinet são suportados.

Hosts liberados:

- cloudflare.com:443
- https://api.ipify.org

Os IPs que vão se conectar a VPN estão fora do Brasil e precisam ser liberados.

<div align="left" dir="ltr" id="bkmrk-entrada-tipo-valor-r"></div>

# White Label

#### Passo a passo e configuração 

##### Identidade Visual  


1. As informações/arquivos requisitados aqui deverão ser informados via email para o contato de parcerias que lhe forneceu este documento.
2. É necessário fornecer 3 versões do logo, um favicon e também o esquema de cores que será adotado para a versão do white label. Veja abaixo um exemplo deste material seguindo a versão padrão da Oystr.

[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2024-03/scaled-1680-/wO0image.png)](https://wiki.oystr.com.br/uploads/images/gallery/2024-03/wO0image.png "Exemplo seguindo o esquema atual padrão Oystr:")

Exemplo seguindo o esquema atual padrão Oystr:

[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2024-03/scaled-1680-/i7simage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2024-03/i7simage.png)

3. De preferência envie os logos como .svg, que serão exibidos nas dimensões especificadas acima.

##### DNS - Subdomínio e apontamento  


1. Nós criamos uma entrada de DNS que será usada para trabalharmos com o apontamento do endereço da sua versão white label para o nosso serviço de white label Oystr.
2. É necessário criar uma entrada no DNS que faz um CNAME para partner.oystr.com.br. Veja o exemplo abaixo:

<div align="left" dir="ltr" id="bkmrk-entrada-tipo-valor-r"><table border="1" class="align-center" style="border-collapse: collapse; border-color: rgb(0, 0, 0); border-style: solid; width: 90%;"><colgroup><col style="width: 41.0112%;"></col><col style="width: 18.1648%;"></col><col style="width: 40.824%;"></col></colgroup><tbody><tr><td style="border-color: rgb(0, 0, 0);">Entrada

</td><td style="border-color: rgb(0, 0, 0);">Tipo

</td><td style="border-color: rgb(0, 0, 0);">Valor

</td></tr><tr><td style="border-color: rgb(0, 0, 0);">rpa.empresa.com.br

</td><td style="border-color: rgb(0, 0, 0);">CNAME

</td><td style="border-color: rgb(0, 0, 0);">partner.oystr.com.br

</td></tr></tbody></table>

3. Deste para acessar o white label, use o endereço **rpa.empresa.com.br.**

</div>

# Benner - TIM

##### Arquivos e recursos necessários para acesso ao Benner TIM

O que devemos pedir do cliente para cadastrar no cofre interno um novo acesso ao Benner TIM:

1. Usuário do sistema da TIM
2. Arquivo da semente (extensão .sdtid)
3. Senha do arquivo da semente (extensão .sdtid)
4. Pin do cadastro atual no sistema da TIM

# Oystr - Geral

#### Como as senhas que são usadas pelos robôs ficam gravadas?

A Oystr gerencia as senhas utilizadas pelos robôs de duas maneiras:

1. Senhas de uso único.
2. Senhas gravadas.

##### Senha de uso único

As senhas de uso único são utilizadas uma única vez para cada execução. A Oystr grava a senha de forma isolada para cada cliente, juntamente com os dados que serão executados pelo robô (fila de execução) e transmite a senha para o robô no início da execução. Esta senha não fica criptografada, mas somente o pessoal autorizado tem acesso aos arquivos com as informações contendo a fila e as senhas. As senhas são mantidas em memória pelos robôs, que descartam os dados utilizados após o término da execução.

##### Senhas gravadas  


As senhas gravadas ficam armazenadas na Oystr usando um serviço dedicado que criptografa os dados usando o padrão AES-GCM, também conhecido como “cofre” ou Vault. Neste caso, a Oystr grava apenas uma referência para a senha juntamente com a fila de itens que serão executados. Imediatamente antes da execução iniciar, a senha é descriptografada e enviada ao robô para uso. Como no caso das senhas de uso único, os robôs não gravam as senhas e descartam os dados utilizados após o término da execução.

Para maior segurança, sugerimos uso de senhas gravadas!

#### Como os robôs automatizam o trabalho?  


Os robôs acessam o sistema ou o site/portal realizando os mesmos passos que um pessoa realiza manualmente com poucas diferenças:

1. Eventualmente os robôs executam um número de passos menor que o processo manual
2. Os robôs conseguem executar as tarefas em grandes quantidades e de forma paralela

#### Os robôs podem “derrubar” os sites que eles acessam?  


Normalmente não. São raros os casos que os robôs da Oystr criaram alguma instabilidade nos sites acessados. Isso ocorre por vários motivos, o principal deles é que os robôs da Oystr acabam fazendo um número de requisições ao site/portal menor que o equivalente ao processo manual. Além disso, os robôs não executam na “velocidade máxima" possível, justamente para não sobrecarregar os sistemas.

#### Os robôs resolvem o CAPTCHA?  


Sim, os robôs resolvem o captcha e algumas vezes precisam tentar mais de uma vez. Em casos raros, os robôs não conseguem resolver o captcha e o item em execução retorna com erro.

#### O que é fila, execução, batch vs api 1:1, etc?  


Os robôs da Oystr trabalham de 2 formas principais:

1. Execuções em batch.
2. Execuções de apenas 1 item.

##### Execuções em batch  


As execuções em batch são execuções de robôs que executam vários itens ao mesmo tempo, possivelmente de forma paralela.

Os itens e outras informações que serão usados durante a execução, como credenciais, são gravadas em uma fila de execução. Esta fila de execução é consumida pelos robôs que automatizam o trabalho, gerando um resultado único para cada item

##### Execuções de apenas 1 item.  


Quando se quer executar apenas um item, e não uma fila, usamos o modelo de execução que chamamos de api 1:1. Os robôs, executam da mesma forma, mas não existe uma execução (com id, etc), não existe a fila de execução e também o journal. Por este motivo as execuções na api 1:1 não aparecem no painel de controle da Oystr.

#### O que é o Journal?  


Cada execução em batch tem um journal associado. O journal é responsável por “saber” o que aconteceu com cada item da execução: se o item foi enviado ao robô, executado, se houve resposta ou não. Pode-se pensar no journal como um diário de cada execução. É a partir do journal que os relatórios das execuções são criados.

#### O que significam os estados de cada item da execução?  


Pode-se ter um resultado diferente para cada item executado em uma execução no modo batch. Por mais que a Oystr tente evitar falhas, sempre poderá haver problemas uma vez que um item pode falhar por vários motivos: site fora do ar, credenciais inválidas, captcha não respondido, erro nos dados de entrada do robô, etc.