No Apidog, uma organização é usada para gerenciar centralmente várias equipes e membros. Com organizações, você pode controlar permissões, atribuir funções e garantir uma colaboração eficiente em toda a sua empresa.Criação de uma Organização#
Você pode criar uma ou mais organizações. Para criar uma nova organização:1.
Na janela principal, clique em Organizações no painel de navegação à esquerda para abrir a página de gerenciamento de organizações.
2.
Clique no botão + Nova Organização no canto inferior esquerdo.
3.
Insira o nome da organização.
4.
Clique em Criar. Sua nova organização agora está configurada.
Membros e Funções da Organização#
Você pode convidar membros para a sua organização e atribuir diferentes funções a eles:Administrador da Organização: Tem as permissões mais altas (exceto o proprietário da organização). Pode gerenciar membros da organização, equipes e configurações da organização.
Membro da Organização: Pode ingressar na organização e em suas equipes, além de colaborar em projetos. Não pode alterar as configurações da organização.
Convite de Membros para a Organização#
Como Proprietário ou Administrador da Organização, você pode introduzir diretamente pessoal na empresa a partir do nível da organização. Isso é altamente adequado para departamentos de RH ou TI distribuírem contas centralmente para a integração de funcionários.💡 Pré-requisito:
Antes de enviar um convite de organização, sua organização deve ter pelo menos uma Equipe criada, caso contrário não haverá onde atribuir funções de equipe.
Para convidar membros para a organização, acesse Membros na sua organização:Clique em Convidar, onde você pode escolher um método de convite e conceder permissões adequadamente:Função da Organização: Geralmente, novos funcionários recebem uniformemente a função Member.
Todas as Funções de Equipe: Ao convidá-los para a empresa, você pode adicioná-los diretamente aos pools de negócios subordinados correspondentes. Você pode definir universalmente a mesma função para todas as equipes ou clicar em "Custom" para abrir os detalhes e especificar com precisão: "Eles ingressam apenas na Equipe A como Membro e permanecem sem ingressar na Equipe B".
2.
Convidar via E-mail (ou Importação em Massa):
Além de oferecer suporte a configurações independentes para cada e-mail e importação em massa por CSV, assim como no nível da equipe, você também pode usar a ferramenta de Configuração em Massa na parte superior para configurar de forma rápida e uniforme a Organization Role e as Team Roles especificamente atribuídas a esse grupo de pessoas.
Cascata de Permissões e Mapeamento de Funções Padrão#
É crucial entender que Funções da Organização e Funções de Equipe/Projeto operam em duas trilhas separadas. Entender como as permissões são propagadas em cascata — ou não — é essencial ao atribuir funções:Funções da Organização vs. Acesso à Equipe: Administradores da Organização têm poder administrativo sobre a estrutura da empresa (por exemplo, criar equipes, gerenciar cobrança e supervisionar o diretório de membros). No entanto, eles não obtêm automaticamente acesso aos dados de API em projetos individuais. Para acessar ou editar um projeto, um Administrador da Organização ainda deve ser adicionado à Equipe ou ao Projeto relevante.
Administrador da Equipe → Editor do Projeto: Usuários atribuídos como Administradores da Equipe recebem automaticamente permissões de Editor para todos os projetos dentro dessa equipe.
Membro da Equipe → Projeto Somente Leitura: Usuários atribuídos como Membros padrão da Equipe recebem acesso seguro de Somente Leitura aos projetos da equipe por padrão.
Proibido / Não ingressou: Se um usuário não for atribuído a uma equipe (ou for definido como Proibido), ele não receberá acesso a projetos dentro dessa equipe.
Observação:
Estas são apenas as permissões iniciais de linha de base. Uma vez dentro da equipe, os Administradores da Equipe podem ajustar individualmente as permissões do projeto ou personalizar funções com base nas necessidades reais do negócio.
Funções de Projeto Personalizadas#
Funções personalizadas oferecem suporte apenas ao nível de Projeto. Funções da organização atualmente não oferecem suporte à personalização.
Relação Entre Organizações e Equipes#
Organização: A unidade de gerenciamento de nível mais alto, representando uma empresa ou um grupo grande. Ela gerencia várias equipes.
Equipes: Uma subunidade dentro de uma organização, geralmente um departamento ou grupo menor. Ela gerencia vários projetos.
Organização vs. Equipe — Qual Você Deve Escolher?#
Ao usar o Apidog, uma pergunta comum é: você deve gerenciar tudo diretamente em uma Organização ou confiar principalmente em Equipes? A resposta realmente se resume a duas coisas — tamanho da equipe e escopo de negócios.Se a Sua Equipe é Pequena e Focada#
Digamos que você tenha cerca de dez pessoas trabalhando todas na mesma linha de produto. Nesse caso, uma única Equipe é mais do que suficiente. Uma Equipe pode lidar com projetos, APIs e membros em um só lugar — de forma simples e eficiente, sem a sobrecarga extra de uma Organização.Se a Sua Empresa é Grande e Distribuída#
Se você tem muitas pessoas e várias linhas de negócios não relacionadas, é melhor criar uma Organização primeiro e, em seguida, configurar Equipes separadas dentro dela para cada área de negócios. Cada Equipe gerencia seus próprios projetos e membros, com limites claros e sem sobreposição.Administradores podem atualizar o nome ou os detalhes da organização em Configurações. Todos os membros verão as informações atualizadas.Transferência da Organização#
O proprietário da organização pode transferir a propriedade para outro membro via Configurações da Organização → Zona de Perigo → Transferir.Encerramento da Organização#
O proprietário da organização pode excluir permanentemente a organização em Configurações da Organização → Zona de Perigo → Encerrar Organização.Encerrar uma organização é permanente e não pode ser desfeito. Todas as equipes e projetos dentro da organização serão excluídos.
