> 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.

### Alternador de Tenant

A funcionalidade Tenant Switcher permite que MSPs estabeleçam relações entre tenant pai e tenant filha numa hierarquia 1:N, permitindo gestão centralizada em vários ambientes de clientes.

#### Visão geral

Com a funcionalidade Tenant Switcher, administradores de um tenant pai podem alternar de forma transparente para qualquer tenant filha conectada e executar tarefas administrativas usando as credenciais do seu tenant pai. Isso elimina a necessidade de manter contas separadas para cada cliente gerido.

#### Principais benefícios

* **Gestão centralizada de acessos**: Mantenha um único conjunto de credenciais enquanto gere vários tenants de clientes
* **Operações simplificadas**: Alterne rapidamente entre ambientes de clientes sem terminar sessão
* **Segurança consistente**: As políticas de segurança e os métodos de autenticação do tenant pai aplicam-se a todos os tenants filha
* **Registo de auditoria**: Todas as ações realizadas em tenants filha são rastreáveis até 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 o licenciamento MSP ativado
2. **Configuração de backend necessária**: A equipa RealmJoin deve assinalar o tenant filha com o identificador do tenant pai no sistema de backend. Esta configuração deve ser solicitada através de um ticket de suporte separado ou durante o processo inicial de onboarding
3. Os tenants filha devem autorizar explicitamente a ligação ao tenant pai
4. Os administradores do tenant pai precisam de permissões apropriadas configuradas no tenant pai
5. Cada tenant filha mantém o seu próprio isolamento de dados e limites de segurança

#### Usando o Tenant Switcher

Depois de configurado, os administradores autorizados podem aceder ao alternador de tenant clicando no nome do tenant no centro da barra de cabeçalho superior. Selecione o tenant filha de destino no menu para mudar de contexto. As credenciais do seu tenant pai permanecem ativas e todas as ações são executadas com as permissões adequadas no âmbito do 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 predefinição, apenas administradores da RealmJoin podem usar a funcionalidade de alternador de tenant. No entanto, podem ser configuradas funções personalizadas para conceder acesso ao alternador de tenant a utilizadores não administradores com permissões limitadas nos tenants filha. Os casos de utilização comuns incluem:

* **Solicitante de software**: Utilizadores que criam e gerem pacotes de aplicações sem direitos administrativos completos
* **Suporte de 1.º nível**: Funcionários do service desk que precisam de acesso limitado para resolver problemas dos utilizadores

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

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

O acesso ao alternador de tenant é concedido pela permissão da função personalizada **`CanAdministerTenantPartners`**. Atribua-a nas funções personalizadas do **tenant pai**. Os utilizadores que a possuírem podem abrir o alternador de tenant e alternar para todos os tenants filha que estejam ligados ao tenant pai.

No tenant filha, estes utilizadores mantêm a **função predefinida que têm no tenant pai** (por exemplo, Supporter, Advanced Supporter ou Auditor). O alternador de tenant dá-lhes apenas acesso ao tenant filha. Não lhes concede direitos de administrador aí. Isto permite-lhe dar à equipa de suporte acesso a todos os tenants de clientes com exatamente as permissões que já têm na origem, sem os tornar administradores RealmJoin.

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

* [Funções personalizadas](https://docs.realmjoin.com/pt/administracao-e-definicoes/permission/custom-roles.md) tem de estar ativado no tenant pai.
* O tenant pai tem de estar registado como tenant parceiro no backend do RealmJoin. Caso contrário, o editor de funções personalizadas rejeita `CanAdministerTenantPartners` como não permitido. Este registo é feito pelo suporte RealmJoin.
  {% endhint %}

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

A sua equipa de service desk é membro do grupo Entra `RJ-Support` no tenant pai. Este grupo está configurado como um **Supporter** grupo nas definições de funções RealmJoin do tenant pai. Para lhes permitir alternar para os tenants de clientes, adicione a seguinte regra às funções personalizadas do tenant pai:

```json
{
  "Regras": [
    {
      "Nome": "Suporte: Tenant Switcher",
      "Descrição": "Permite à equipa de suporte alternar para todos os tenants filha com as suas permissões de Supporter.",
      "Grupos": [
        "5d3c1a2b-8e4f-4a6b-9c7d-2e1f0a9b8c7d"
      ],
      "Permissões": [
        "CanAdministerTenantPartners"
      ]
    }
  ]
}
```

Substitua o ID do grupo pelo ID do objeto do seu `RJ-Support` grupo. Depois de os utilizadores iniciarem sessão novamente, veem o alternador de tenant na barra de cabeçalho. Em cada tenant filha com que trabalham, usam permissões de Supporter, tal como no tenant pai.

Aspetos a considerar:

* **Apenas as funções predefinidas são herdadas.** Outras permissões de funções personalizadas do tenant pai não se aplicam nos tenants filha. Para conceder permissões adicionais dentro de um tenant filha, defina uma função personalizada nesse tenant filha.
* **Continua a ser necessária uma função predefinida.** Um utilizador que tenha apenas `CanAdministerTenantPartners` e não tenha qualquer função predefinida no tenant pai pode alternar entre tenants, mas não tem permissões administrativas nos tenants filha.
* **A permissão também concede direitos de administrador de parceiro.** Por exemplo, os detentores podem gerir modelos (editar, eliminar, alterar pacotes e tokens). Atribua-a apenas a pessoas que estejam autorizadas a fazê-lo.
* **As alterações aplicam-se no próximo início de sessão.** Os utilizadores que já iniciaram sessão têm de recarregar o portal ou iniciar sessão novamente depois de a função personalizada ter sido guardada.

**Nota**: Algumas permissões exigem a assistência da equipa RealmJoin para serem configuradas. Contacte o suporte se precisar de ajuda para configurar funções personalizadas com permissões restritas.

***

### Portal de Staging

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

#### Visão geral

O Portal de Staging em [**portal-staging.realmjoin.com** ](https://portal-staging.realmjoin.com)serve como um ambiente beta onde as próximas funcionalidades são implementadas antes de chegarem ao portal de produção. Isto permite aos utilizadores pré-visualizar e testar novas capacidades antes da disponibilidade geral.

#### Considerações importantes

**Use com cuidado**: O ambiente de staging é disponibilizado tal como está, sem garantias. As funcionalidades podem estar incompletas, instáveis ou sujeitas 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 pretendem testar novas funcionalidades antes da implementação
* Utilizadores que fornecem feedback sobre funcionalidades futuras
* Formação e familiarização com capacidades futuras
* 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.
