> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Funções de usuário do PlayFab

> Crie funções de usuário no PlayFab Game Manager, atribua permissões granulares por título e gerencie o acesso ao estúdio para equipes de administração, suporte e produto.

As funções são a forma de gerenciar permissões de usuários e a navegação no Game Manager do PlayFab. Um estúdio é o agrupamento administrativo no qual funções e usuários são gerenciados, enquanto as atribuições de funções geralmente controlam o acesso a títulos individuais. Uma função é uma coleção nomeada de permissões que você atribui às pessoas do seu estúdio por título. Defina uma função uma vez, atribua-a a quantos usuários desejar e atualize o acesso de todos de uma só vez editando a função. Para obter mais informações sobre esses escopos, confira [Conceitos do PlayFab](/pt-BR/services/playfab/get-started/concepts#studios-namespaces-and-titles).

Este artigo aborda as três tarefas que você fará com mais frequência: criar uma função, configurar suas permissões e atribuí-la a usuários.

## Como as funções funcionam

O PlayFab usa um modelo de permissões granular com centenas de permissões individuais, para que você possa decidir *exatamente* o que cada pessoa tem permissão para fazer. As áreas do Game Manager podem ser totalmente desativadas, definidas como somente leitura ou abertas para edição.

Alguns exemplos de situações em que isso é útil:

* Um representante do Atendimento ao Cliente pode editar perfis de jogadores, mas nunca ver dados de receita.
* Um Gerente de Produto pode visualizar painéis de receita, mas não pode carregar builds de servidores multijogador.
* Um Cientista de Dados pode ler todos os eventos e painéis sem ter acesso de gravação em nenhum lugar.

Como as permissões ficam na função, e não em cada usuário individual, uma alteração de política é uma única edição: atualize a função, e todos que a possuem recebem a alteração imediatamente.

As funções são atribuídas **por título**, e um usuário pode ter **várias funções** no mesmo título. Assim, você pode dar a alguém uma função de *Suporte ao Cliente* e uma função de *Cientista de Dados*, e essa pessoa obterá as permissões combinadas de ambas. A mesma pessoa também pode ser Title Admin em um título, Gerente de Produto em outro e representante do Atendimento ao Cliente em um terceiro, tudo dentro do mesmo estúdio.

### Funções internas e níveis de administrador

Todo estúdio vem com três funções predefinidas:

* **Title Admin**: permissões completas para um determinado título
* **Dashboard**: permissão para visualizar o painel do título e nada mais
* **Commercial admin**: permissão para visualizar o painel do título, editar configurações, ver pagamentos do Economy e gerenciar a ativação de produtos

Há duas permissões especiais, válidas para todo o estúdio, que afetam o acesso aos títulos.

* **Studio Admin**: cria títulos, define e edita funções e tem automaticamente direitos de **title admin** em todos os títulos do estúdio. Você precisa ser Studio Admin para criar funções ou atribuí-las a usuários.
* **Commercial admin**: tem algum controle sobre o processo de cobrança do estúdio e tem automaticamente direitos de **commercial admin** em todos os títulos do estúdio.

## Criar uma função

1. [Entre no PlayFab](https://developer.playfab.com/) com sua conta de desenvolvedor.
2. Em **My Studios and Titles**, selecione o **menu de três pontos (...)** à direita do seu estúdio e escolha **Roles**.
   <img src="https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-my-studios-roles.jpg?fit=max&auto=format&n=mLCHf0iQv3VidfBe&q=85&s=3dbf611d76d08ed29680e4bd5d7c8c29" alt="captura de tela do menu de três pontos do estúdio com a opção Roles" width="1128" height="516" data-path="images/playfab/identity/dev-identity/user-roles-my-studios-roles.jpg" />
3. Você verá a lista de funções que já existem no seu estúdio. Selecione **New custom role** para começar uma função personalizada.
   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/identity/dev-identity/user-roles-list-roles.jpg?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=1e8a58c2d5a2eb248aa5c5acaa470f47" alt="captura de tela da lista de funções com o botão New Role" width="1243" height="757" data-path="images/playfab/identity/dev-identity/user-roles-list-roles.jpg" />
4. Em **Role details**, dê à função um **Role title** claro. É nessa lista que você escolherá ao atribuir a função posteriormente, portanto, use um nome descritivo (por exemplo, *Suporte ao Cliente* ou *Engenheiro de Build*).
   <img src="https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-role-details.jpg?fit=max&auto=format&n=mLCHf0iQv3VidfBe&q=85&s=970a9b4ba4dc6ece42e3fe7ad5722a18" alt="captura de tela da seção Role details" width="1383" height="1434" data-path="images/playfab/identity/dev-identity/user-roles-role-details.jpg" />
5. Se essa função tiver acesso irrestrito ao título, marque **Title admin**. Isso concede permissões completas para o título e substitui as seleções de permissões individuais abaixo.

### Configurar permissões

A seção **Configure permissions** é onde você escolhe exatamente o que a função pode fazer. As permissões são organizadas em grupos como **Overview**, **Identity**, **Economy** e outros, com um contador em cada grupo (por exemplo, *Overview (0/7)*) mostrando quantas de suas permissões estão selecionadas no momento.

Cada permissão oferece um ou mais níveis de acesso:

* **Read**: visualizar os dados ou a área
* **Edit**: criar e modificar
* **Delete**: remover

Nem toda permissão tem os três. Algumas áreas adicionam suas próprias ações específicas, como **Activate**, **Submit** ou **Review**. Quando não tiver certeza do que uma ação abrange, passe o mouse sobre a dica de ferramenta **(i)** ao lado dela para ver uma descrição completa. Por exemplo, a ação **Review** na *guia Payouts* explica que ela permite "Approve and reject payouts".

Para agilizar, use os controles em massa:

* **Search**: filtre a lista de permissões para encontrar um item específico.
* **Toggle all permissions**: marque ou desmarque todas as permissões de uma só vez.
* **Set read only**: marque apenas as caixas **Read** em todo o escopo, deixando **Edit** e **Delete** desmarcadas.
* **Collapse all**: oculte o conteúdo de todos os grupos para uma exibição mais limpa.

Cada grupo também tem seus próprios **Select all** e **Set read only**, para que você possa configurar uma área por vez.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/identity/dev-identity/user-roles-category-selected.jpg?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=18a2e99f0363de481ec86a5ff0131c15" alt="captura de tela da seção Configure permissions mostrando os grupos de permissões" width="1225" height="820" data-path="images/playfab/identity/dev-identity/user-roles-category-selected.jpg" />

Quando as permissões estiverem corretas, role até a parte inferior e selecione **Save Role**.

## Atribuir funções a usuários

Você pode atribuir funções de duas maneiras: a partir de um usuário ou a partir de uma função.

**A partir de um usuário:**

1. Em **My Studios and Titles**, selecione o **menu de três pontos (...)** ao lado do seu estúdio e escolha **Users**.
2. Abra o usuário que você deseja atualizar e selecione as funções dele por título. Como as funções têm escopo de título, atribua a função para cada título em que o usuário precisar dela.
3. Salve as alterações.

<img src="https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-user-manage-roles.jpg?fit=max&auto=format&n=mLCHf0iQv3VidfBe&q=85&s=58ae4b3237a5ad03b373cbeccf95a12c" alt="captura de tela da atribuição de funções a um usuário por título" width="1401" height="832" data-path="images/playfab/identity/dev-identity/user-roles-user-manage-roles.jpg" />

**A partir de uma função:**

Abra uma função existente e selecione a guia **Members**. Ali você pode escolher quais usuários do seu estúdio devem ter essa função e para quais títulos. Essa abordagem é útil quando você está integrando várias pessoas à mesma função de uma só vez.

<img src="https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-role-members.jpg?fit=max&auto=format&n=mLCHf0iQv3VidfBe&q=85&s=e86015d46073fe8c2ad1f8a98a4303f2" alt="captura de tela da guia Members em uma função" width="670" height="889" data-path="images/playfab/identity/dev-identity/user-roles-role-members.jpg" />

## Resumo

As funções oferecem controle flexível, em todo o estúdio, sobre quem pode fazer o quê no Game Manager. Defina uma função, ajuste suas permissões com os controles Read/Edit/Delete (e específicos de cada área) e atribua-a à sua equipe por título. Atualize a função uma vez, e todos que a possuem permanecem sincronizados.


## Related topics

- [Autenticação do Microsoft Entra ID para APIs do PlayFab](/pt-BR/services/playfab/identity/dev-identity/authentication/entra-id-api-authentication.md)
- [Práticas recomendadas do Insights](/pt-BR/services/playfab/data-analytics/legacy/insights/best-practices.md)
- [Início rápido do Game Manager](/pt-BR/services/playfab/live-service-management/gamemanager/quickstart.md)
- [Conceitos do PlayFab](/pt-BR/services/playfab/get-started/concepts.md)
- [Início rápido do Data Explorer](/pt-BR/services/playfab/data-analytics/learn-data/data-explorer/quickstart.md)
