{"section":"tutorials","requestedLocale":"pt","requestedSlug":"gerenciar-perfis-de-acesso-e-permissoes-de-storefront-personalizados","locale":"pt","slug":"gerenciar-perfis-de-acesso-e-permissoes-de-storefront-personalizados","path":"docs/pt/tutorials/b2b/b2b-buyer-portal/gerenciar-perfis-de-acesso-e-permissoes-de-storefront-personalizados.md","branch":"main","content":"> ⚠️ Esta funcionalidade é exclusiva para lojas que usam [B2B Buyer Portal](https://help.vtex.com/pt/docs/tutorials/b2b-buyer-portal-pt), atualmente disponível para contas selecionadas.\n\nA página **Permissões personalizadas** possibilita que você visualize os perfis de acesso e as permissões de storefront personalizados da sua conta e os gerencie pelo Admin VTEX.\n\nPara entender os conceitos, as regras e a lista de perfis e permissões predefinidos, leia [Perfis de acesso e permissões de storefront personalizados](https://help.vtex.com/pt/docs/tutorials/perfis-de-acesso-e-permissoes-de-storefront-personalizados).\n\nPara acessar a página no Admin VTEX, clique em **Configurações > Permissões personalizadas**.\n\nA partir desta página, você pode:\n\n- Gerenciar perfis de acesso personalizados:\n  - [Criar perfil de acesso de storefront personalizado](#criar-perfil-de-acesso-de-storefront-personalizado)\n  - [Editar perfil de acesso de storefront personalizado](#editar-perfil-de-acesso-de-storefront-personalizado)\n  - [Excluir perfil de acesso de storefront personalizado](#excluir-perfil-de-acesso-de-storefront-personalizado)\n- Gerenciar permissões personalizadas:\n  - [Criar permissão de storefront personalizada](#criar-permissao-de-storefront-personalizada)\n  - [Excluir permissão de storefront personalizada](#excluir-permissao-de-storefront-personalizada)\n\n## Requisitos\n\nDois requisitos precisam ser atendidos para acessar a página **Permissões personalizadas**:\n\n- A conta precisa utilizar o [B2B Buyer Portal](https://help.vtex.com/pt/docs/tutorials/b2b-buyer-portal-pt). Em contas que não usam essa solução, a página não fica visível nem pode ser acessada.\n- O usuário deve ter um perfil de acesso do Admin com o [recurso do License Manager](https://help.vtex.com/pt/docs/tutorials/recursos-do-license-manager) **Edit Storefront User Permissions**, na categoria **Services access control**. Sem esse recurso, o usuário não vê a página.\n\n### Aba Perfis\n\nA aba **Perfis** apresenta apenas os perfis de acesso personalizados da conta. Os perfis predefinidos não aparecem na lista, mas você pode consultá-los pelo link **Perfis predefinidos**, disponível na aba. Se a conta ainda não tiver nenhum perfil personalizado, a aba exibe uma mensagem com o botão `Criar perfil`.\n\nNa parte superior da aba, o botão `Criar perfil` abre o formulário de criação de um novo perfil.\n\nAbaixo, a lista de perfis apresenta os perfis em ordem alfabética, de A a Z. Para inverter a ordem, clique no título da coluna **Nome**. Quando há muitos perfis, a lista é dividida em páginas.\n\n| Coluna | Descrição |\n| --- | --- |\n| **Nome** | Nome que identifica o perfil de acesso, definido no momento da criação. |\n| **Ações** | Menu com as ações de `Editar perfil` ou `Excluir` um perfil. |\n\nO menu na linha de cada perfil apresenta as seguintes opções:\n\n- **Editar perfil:** abre o formulário de edição do perfil. Leia [Editar perfil de acesso de storefront personalizado](#editar-perfil-de-acesso-de-storefront-personalizado).\n- **Excluir:** remove o perfil depois de uma confirmação. A opção fica desabilitada enquanto o perfil estiver atribuído a algum usuário. Leia [Excluir perfil de acesso de storefront personalizado](#excluir-perfil-de-acesso-de-storefront-personalizado).\n\n### Aba Permissões\n\nA aba **Permissões** apresenta apenas as permissões personalizadas da conta. As permissões predefinidas não aparecem na lista, mas você pode consultá-las pelo link **Permissões predefinidas**, disponível na aba. Se a conta ainda não tiver nenhuma permissão personalizada, a aba exibe uma mensagem com o botão `Criar permissão`.\n\nNa parte superior da aba, você encontra:\n\n- **Contador de permissões:** indica quantas permissões personalizadas a conta já criou, no formato `{n} de 10 permissões personalizadas`. Um ícone de ajuda ao lado explica que cada conta pode ter até 10 permissões personalizadas e que as predefinidas não contam para o limite.\n- **Botão `Criar permissão`:** abre o formulário de criação de uma nova permissão. Quando a conta atinge o limite de 10, o botão fica desabilitado e um aviso acima da lista explica que é necessário excluir uma permissão que não esteja em uso para criar outra.\n\nA lista de permissões apresenta as permissões personalizadas da conta, com as informações a seguir:\n\n| Coluna | Descrição |\n| --- | --- |\n| **Nome** | Nome que identifica a permissão, definido no momento da criação. |\n| **Descrição** | Texto que explica o que a permissão autoriza. |\n| **Perfis que utilizam** | Perfis de acesso que contêm a permissão. Quando há mais de um perfil, a coluna mostra o nome do primeiro seguido do total de outros perfis, por exemplo, `Comprador, +2`. Ao passar o cursor sobre o texto, uma dica lista todos os perfis. |\n| **Criado em** | Data de criação da permissão. Ao passar o cursor sobre a data, uma dica mostra o dia e o horário exatos. |\n| **Ações** | Menu com a ação de `Excluir` uma permissão. |\n\nVocê não pode editar uma permissão depois de criá-la, apenas excluí-la. Para isso, use a opção **Excluir** no menu da linha da permissão e confirme a ação. A opção fica desabilitada enquanto algum perfil de acesso estiver usando a permissão. Para mais detalhes, leia [Excluir permissão de storefront personalizada](#excluir-permissao-de-storefront-personalizada).\n\n## Gerenciar perfis de acesso de storefront personalizados\n\nNesta seção, você aprende a criar, editar e excluir perfis de acesso personalizados.\n\n### Criar perfil de acesso de storefront personalizado\n\nPara criar um perfil de acesso personalizado, siga as instruções abaixo:\n\n1. No Admin VTEX, acesse **Configurações > Permissões personalizadas**.\n2. Na aba **Perfis**, clique em `Criar perfil`.\n3. Em **Nome**, digite o nome do perfil.\n\n    > ⚠️ Escolha nomes descritivos para os perfis de acesso, que deixem claro o tipo de usuário a que cada perfil se destina.\n4. Na lista de permissões, marque as que o perfil deve conter. Para encontrá-las mais rápido, você pode buscar pelo nome da permissão ou filtrar por **Tipo**: **Todos**, **Personalizados** ou **Predefinidos**.\n5. Clique em `Criar perfil`.\n\n    Uma mensagem confirma a criação e o perfil é listado na aba **Perfis**. O botão `Criar perfil` só é habilitado depois que o nome é preenchido com um valor válido.\n\n#### Criar permissão de storefront durante a criação do perfil\n\nSe a permissão de que você precisa ainda não existe, é possível criá-la sem sair do formulário de criação do perfil:\n\n1. Com o formulário do perfil aberto, abaixo da lista de permissões, clique em `Criar uma permissão`.\n2. Preencha **Nome** e **Descrição** da permissão e conclua a criação.\n\n    O nome e as permissões que você já marcou no perfil são mantidos.\n3. Na lista de permissões, localize a nova permissão, identificada pela etiqueta **Novo**. Ela aparece desmarcada. Marque-a para incluí-la no perfil.\n4. Clique em `Criar perfil`.\n\nSe a conta já tiver 10 permissões personalizadas, a opção **Criar uma permissão** não é exibida. No lugar dela, uma mensagem informa que o limite foi atingido e orienta você a excluir, na aba **Permissões**, as permissões que não estão em uso. A lista continua exibindo todas as permissões existentes, então ainda é possível montar o perfil.\n\n### Editar perfil de acesso de storefront personalizado\n\n> ⚠️ Ao remover uma permissão de um perfil de acesso, a alteração entra em vigor imediatamente para todos os usuários que têm esse perfil.\n\nPara editar um perfil de acesso personalizado, siga as instruções abaixo:\n\n1. No Admin VTEX, acesse **Configurações > Permissões personalizadas**.\n2. Na aba **Perfis**, clique no ícone de menu (⋮) do perfil que você quer editar e selecione `Editar perfil`.\n3. Altere o nome ou as permissões do perfil.\n\n    As permissões atuais aparecem marcadas. As permissões criadas depois da última vez em que o perfil foi salvo aparecem desmarcadas e com a etiqueta **Novo**, para que você decida se quer incluí-las.\n4. Clique em `Salvar alterações`.\n\n    Uma mensagem confirma a atualização. Se você alterou o nome, o perfil passa para a posição correspondente na ordem alfabética.\n\n### Excluir perfil de acesso de storefront personalizado\n\nPara excluir um perfil de acesso personalizado, siga as instruções abaixo:\n\n1. No Admin VTEX, acesse **Configurações > Permissões personalizadas**.\n2. Na aba **Perfis**, clique no ícone de menu (⋮) do perfil que você quer excluir.\n3. Clique em `Excluir`.\n4. Na janela de confirmação, clique em `Excluir` novamente.\n\n    Uma mensagem confirma a exclusão e o perfil é removido da lista.\n\nSe a opção **Excluir** estiver desabilitada, o perfil ainda está atribuído a algum usuário. Passe o cursor sobre a opção para ver o motivo. Para excluir o perfil, remova-o de todos os usuários que o utilizam. Saiba como em [Adicionar usuários à organização compradora](https://help.vtex.com/pt/docs/tutorials/adicionar-usuarios-a-organizacao-compradora).\n\n## Gerenciar permissões de storefront personalizadas\n\nNesta seção, você aprende a criar e excluir permissões personalizadas. Não é possível editar uma permissão depois de criada.\n\n### Criar permissão de storefront personalizada\n\nPara criar uma permissão personalizada, siga as instruções abaixo:\n\n1. No Admin VTEX, acesse **Configurações > Permissões personalizadas**.\n2. Na aba **Permissões**, clique em `Criar permissão`.\n3. Em **Nome**, digite o nome da permissão.\n\n    > ⚠️ O nome deve seguir as [regras das permissões personalizadas](https://help.vtex.com/pt/docs/tutorials/perfis-de-acesso-e-permissoes-de-storefront-personalizados#regras-e-limites-das-permissoes-de-storefront-personalizadas) e não pode ser alterado depois da criação.\n4. Em **Descrição**, explique o que a permissão autoriza.\n5. Clique em `Criar`.\n\n    Uma mensagem confirma a criação e a permissão é listada na tabela. Para que ela tenha efeito, associe-a a um perfil de acesso. Na própria mensagem, o botão `Ir para a aba Perfis` leva você à lista de perfis.\n\n### Excluir permissão de storefront personalizada\n\nPara excluir uma permissão personalizada, siga as instruções abaixo:\n\n1. No Admin VTEX, acesse **Configurações > Permissões personalizadas**.\n2. Na aba **Permissões**, clique no ícone de menu (⋮) da permissão que você quer excluir.\n3. Clique em `Excluir`.\n4. Na janela de confirmação, clique em `Excluir` novamente.\n\n    Uma mensagem confirma a exclusão e a permissão é removida da lista. Se a conta estava no limite de 10 permissões personalizadas, o botão `Criar permissão` volta a ficar disponível.\n\nSe a opção **Excluir** estiver desabilitada, a permissão ainda está em uso por algum perfil de acesso. Passe o cursor sobre a opção para ver quantos perfis a utilizam. A coluna **Perfis que utilizam** mostra quais são. Para excluir a permissão, remova-a de cada um desses perfis, seguindo os passos de [Editar perfil de acesso de storefront personalizado](#editar-perfil-de-acesso-de-storefront-personalizado).\n\n> ℹ️ Para gerenciar perfis de acesso e permissões personalizados via API, acesse a [Storefront Roles API](https://developers.vtex.com/docs/api-reference/storefront-roles-api) e o guia para desenvolvedores [Custom storefront roles and resources](https://developers.vtex.com/docs/guides/custom-storefront-roles-and-resources).\n\n## Saiba mais\n\n- [Perfis de acesso e permissões de storefront personalizados](https://help.vtex.com/pt/docs/tutorials/perfis-de-acesso-e-permissoes-de-storefront-personalizados)\n- [Adicionar usuários à organização compradora](https://help.vtex.com/pt/docs/tutorials/adicionar-usuarios-a-organizacao-compradora)\n- [Recursos do License Manager](https://help.vtex.com/pt/docs/tutorials/recursos-do-license-manager)"}