> For the complete documentation index, see [llms.txt](https://docs.linuxcontrolcenter.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linuxcontrolcenter.com.br/conf-integrations/integrations/beyondtrust/privileged_remote_access.md).

# Privileged Remote Access

## Requisitos

* BeyondInsight = 22.X ou superior
* Linux Control Center = 2.10.X ou superior
* **OAuth Client ID** e o **OAuth Client Secret** do Privileged Remote Access

## Overview

A integração do Linux Control Center com o BeyondTrust Privileged Remote Access permite a transferir Hosts gerenciados pelo LCC para um *JumpGroup* no PRA.

## Objetivo

O obetivo deste documento é de monstrar o passo a passo para realizar a integração do LCC com o Privileged Remote Access.

## Configuração da API no PRA

1. Acesse a tela **/login** do Privileged Remote Access.
2. Clique em **Management** e clique em **API Configuration**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-395616557e435cc5917046ae76be76d6cbd937e1%2Fmanagement_pra.png?alt=media)
3. Clique no **ADD** em API Accounts.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-6b698a4a62822d785ea9d25247315d77a2c4c8ca%2Fadd_api_pra.png?alt=media)
4. Insira as **Permissões** conforme imagem abaixo.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-e2133a76038bd36728d618396e7b9f60e269130b%2Fpermissoes_pra.png?alt=media)
5. Crie um *nome* para identificar a o acesso e salve o **OAuth Client ID** e o **OAuth Client Secret** em um local seguro e clique em **Save**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-97abd98ade307246860c0b67ef04739b0c2833bc%2Fids_api.png?alt=media)

## Integração Linux Control Center

1. Acesse o Linux Control Center e clique em **Config**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-8c0671f317ba546b625aa5609b7b961fc75f67cd%2Fconfig_dashboard_pra.png?alt=media)
2. Clique em **BeyondTrust**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-7975c3cb0503cc3a5b10a85b673ad971103d8ea1%2Fbotao_beyondtrust.png?alt=media)
3. Clique em **Privileged Remote Access**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-119ef9377771c669bf1c650972976e1a9b36cb5f%2Fbotao_pra.png?alt=media)
4. Clique em **Create**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-0089ebd5f1f67ab834bae316472ca1453f8fcd3e%2Fbotao_create.png?alt=media)
5. Preencha os campos solicitados

* **Name:** Nome para identificar a integração
* **URL:** URL do BeyondTrust PRA do seu ambiente
* **Client ID:** Client ID do PRA
* **Secret:** Chave Secret do PRA

1. Clique em **Save**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-c5fbf346c4bccc9f64e015a8a7e74f5ce6cd435a%2Fbotao_save.png?alt=media)
2. Clique na integração criada e clique em **Test Connection** para validar a conexão do LCC com o PRA.

* Aguarde a *Ação* **PRA Test Connection** ser finalizada na *Fila*.

  ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-c240d076e0d9815a7954cfaf39a3fa00575311df%2Ftest_connection.png?alt=media)

1. O campo **Status** terá um ícone verde indicando que a autenticação foi validada com sucesso.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-c91cfb19b1e79f233bc3f7a8a655e061b841de4c%2Fpra_validado.png?alt=media)
2. Clique na aba **Jump Items** e clique em **Sync**.

* Aguarde a *Ação* **PRA Sync** ser finalizada na *Fila*.

  ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-d81794101058178e023d0a22cdb4a1cf5259d8d4%2Fsync_jump_item.png?alt=media)

1. Será listado o Hostname dos *Jumpitems* com seus respectivos *Jump Group* e *Jumpoint*.
2. Clique em **Create**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-8ec0792a8a2d2dff9fe128d6df67f1537174f0b5%2Fbotao_create_jumpoint.png?alt=media)
3. Escolha para qual **Jumpoint** o Host será importado.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-74d17a53c7818bf4202dc856a93d5b0af78d7a74%2Fcampo_jumpoint.png?alt=media)
4. Clique em **Host** para selecionar o Host desejado. Também é possível selecionar um grupo de Host do LCC no campo **Groups**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-5ce59ba33ff089e7325bd1c8974d397b92d409f7%2Fcampo_host_jumpoint.png?alt=media)
5. Selecione o **Jump Group** do PRA em que os Hosts serão importados.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-def4ece6bdaa7097a35df944f220337ae7db344c%2Fcampo_jump_groups.png?alt=media)
6. Clique em **Save** para executar a *Ação* que fará a importação dos Hosts selecionados para o PRA.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-13008ca58d6eaed21b6e87d6213daaa9e9c6a1a8%2Fbotao_save_jumpoint.png?alt=media)