> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/administracao-e-definicoes/msp-and-advanced-features.md).

# MSP e funcionalidades avançadas

Esta secção abrange funcionalidades avançadas concebidas para Managed Service Providers (MSPs) e utilizadores avançados que necessitam de maior controlo e flexibilidade no RealmJoin.

### Seletor de Tenant

O recurso Seletor de Tenant permite que os MSPs estabeleçam relações entre Tenant pai e Tenant filha em uma hierarquia 1:N, permitindo o gerenciamento centralizado em vários ambientes de clientes.

#### Visão geral

Com a funcionalidade Seletor de Tenant, os administradores de um Tenant pai podem alternar sem esforço para qualquer Tenant filha conectada e executar tarefas administrativas usando as credenciais do Tenant pai. Isso elimina a necessidade de manter contas separadas para cada cliente gerenciado.

#### Principais benefícios

* **Gerenciamento centralizado de acesso**: Mantenha um único conjunto de credenciais enquanto gerencia vários Tenants de clientes
* **Operações simplificadas**: Alterne rapidamente entre ambientes de clientes sem sair da sessão
* **Segurança consistente**: As políticas de segurança e os métodos de autenticação do Tenant pai se aplicam a todos os Tenants filhos
* **Trilha de auditoria**: Todas as ações realizadas nos Tenants filhos são rastreáveis ao administrador do Tenant pai

#### Requisitos de configuração

Para estabelecer relações entre Tenant pai e Tenant filha:

1. O Tenant pai deve ter a licença MSP ativada
2. **Configuração de backend necessária**: A equipe do RealmJoin deve marcar a Tenant filha com o identificador do Tenant pai no sistema de backend. Essa configuração deve ser solicitada por meio de um chamado de suporte separado ou durante o processo inicial de onboarding
3. As Tenants filhas devem autorizar explicitamente a conexão do Tenant pai
4. Os administradores do Tenant pai precisam ter permissões apropriadas configuradas no Tenant pai
5. Cada Tenant filha mantém seu próprio isolamento de dados e seus próprios limites de segurança

#### Usando o Seletor de Tenant

Depois de configurado, os administradores autorizados podem acessar o seletor de Tenant clicando no nome do Tenant na barra central do cabeçalho superior. Selecione o Tenant filha de destino no menu para alternar o contexto. Suas credenciais do Tenant pai permanecem ativas, e todas as ações são executadas com as permissões apropriadas dentro do escopo da Tenant filha.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FnJ6ASUoApqjlP6ZU6wJp%2Fimage.png?alt=media&amp;token=68a90013-e5d0-49ce-8d66-71379f87a24b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FPfTx0bNUztsDkzzBnRhg%2Fimage.png?alt=media&amp;token=4ded6a23-e5e0-467c-a086-f895c47d0d49" alt=""><figcaption></figcaption></figure>

### Permissões de Função Personalizada

Por padrão, apenas os administradores do RealmJoin podem usar o recurso Seletor de Tenant. No entanto, funções personalizadas podem ser configuradas para conceder acesso ao Seletor de Tenant a usuários não administradores com permissões limitadas nos Tenants filhos. Casos de uso comuns incluem:

* **Solicitante de software**: Usuários que criam e gerenciam pacotes de aplicativos sem direitos totais de administrador
* **Suporte de 1º nível**: Equipe de help desk que precisa de acesso limitado para solucionar problemas dos usuários

Para obter informações detalhadas sobre a configuração de funções personalizadas, consulte a [documentação de Funções Personalizadas](/pt/administracao-e-definicoes/permission/custom-roles.md).

#### Permissão necessária: `CanAdministerTenantPartners`

O acesso ao seletor de Tenant é concedido pela permissão da função personalizada **`CanAdministerTenantPartners`**. Atribua-a nas funções personalizadas do **Tenant pai**. Os usuários que a possuem podem abrir o seletor de Tenant e alternar para cada Tenant filha conectada ao Tenant pai.

No Tenant filha, esses usuários mantêm a **função predefinida que têm no Tenant pai** (por exemplo, Supporter, Advanced Supporter ou Auditor). O seletor de Tenant concede apenas acesso ao Tenant filha. Ele não lhes concede direitos de administrador ali. Isso permite dar à equipe de suporte acesso a todos os Tenants de clientes com exatamente as permissões que já possuem no Tenant pai, sem torná-los administradores do RealmJoin.

{% hint style="info" %}
**Pré-requisitos**

* [Funções Personalizadas](/pt/administracao-e-definicoes/permission/custom-roles.md) devem estar ativadas no Tenant pai.
* O Tenant pai deve estar registado como um Tenant parceiro no backend do RealmJoin. Caso contrário, o editor de funções personalizadas rejeita `CanAdministerTenantPartners` como não permitido. Esse registo é feito pelo suporte do RealmJoin.
  {% endhint %}

**Exemplo: Suporte de 1º nível em todos os Tenants de clientes**

Sua equipe de help desk é membro do grupo Entra `RJ-Support` no Tenant pai. Esse grupo é configurado como um **Supporter** grupo nas definições de funções do RealmJoin do Tenant pai. Para permitir que alternem para os Tenants de clientes, adicione a seguinte regra às funções personalizadas do Tenant pai:

```json
{
  "Rules": [
    {
      "Name": "Suporte: Seletor de Tenant",
      "Description": "Permite que a equipe de suporte alternar para todos os Tenants filhos com as suas permissões de Supporter.",
      "Groups": [
        "5d3c1a2b-8e4f-4a6b-9c7d-2e1f0a9b8c7d"
      ],
      "Permissions": [
        "CanAdministerTenantPartners"
      ]
    }
  ]
}
```

Substitua o ID do grupo pelo ID do objeto do seu `RJ-Support` grupo. Depois de os usuários iniciarem sessão novamente, verão o seletor de Tenant na barra de cabeçalho. Em cada Tenant filha, trabalham com permissões de Supporter, assim como no Tenant pai.

Pontos a considerar:

* **Apenas as funções predefinidas são transferidas.** As outras permissões de função personalizada do Tenant pai não se aplicam nos Tenants filhos. Para conceder permissões adicionais dentro de um Tenant filha, defina uma função personalizada nesse Tenant filha.
* **Ainda é necessária uma função predefinida.** Um usuário que possui apenas `CanAdministerTenantPartners` e não tem nenhuma função predefinida no Tenant pai pode alternar entre Tenants, mas não tem permissões administrativas nos Tenants filhos.
* **A permissão também concede direitos de administrador do parceiro.** Por exemplo, os titulares podem gerir modelos (editar, excluir, alterar pacotes e tokens). Atribua-a apenas a pessoas que tenham permissão para isso.
* **As alterações se aplicam no próximo início de sessão.** Os usuários que já iniciaram sessão devem recarregar o portal ou iniciar sessão novamente após a função personalizada ter sido salva.

**Observação**: Algumas permissões exigem a assistência da equipe do RealmJoin para configurar. Entre em contato com o suporte se precisar de ajuda para configurar funções personalizadas com permissões restritas.

***

### Portal de staging

O RealmJoin mantém um ambiente de staging para acesso antecipado a novos recursos e funcionalidades.

#### Visão geral

O Portal de staging em [**portal-staging.realmjoin.com** ](https://portal-staging.realmjoin.com)serve como um ambiente beta onde os próximos recursos são implantados antes de chegarem ao portal de produção. Isso permite que os usuários visualizem e testem novos recursos antes da disponibilidade geral.

#### Considerações importantes

**Use com cautela**: O ambiente de staging é fornecido como está, sem garantias. Os recursos podem estar incompletos, instáveis ou sujeitos a alterações. Evite usar dados críticos de produção.

#### Quem deve usar o Staging?

O Portal de staging é ideal para:

* Organizações que desejam testar novos recursos antes da implantação
* Usuários que fornecem feedback sobre funcionalidades futuras
* Treinamento e familiarização com recursos futuros
* Cenários de desenvolvimento e teste


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/pt/administracao-e-definicoes/msp-and-advanced-features.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
