Por padrão, Membros da Organização não podem criar equipes em uma organização Apidog. Um Proprietário ou Administrador da Organização pode habilitar esta permissão para que os membros possam criar equipes pertencentes à organização a partir da página Inicial.
O criador se torna o Proprietário da Equipe da nova equipe, mas permanece como Membro da Organização. A criação da equipe não concede acesso às páginas de gerenciamento da organização.
Antes de começar
Você precisa:
- Acesso de Proprietário da Organização ou Administrador da Organização;
- uma conta de Membro da Organização para teste;
- uma convenção de nomenclatura e propriedade para novas equipes;
- um membro ativo da organização que possa atuar como proprietário de backup, se necessário.
Esta configuração altera quem pode criar equipes pertencentes à organização. Ela não altera as funções da organização, as permissões de projeto ou as permissões das equipes existentes.
Passo 1: Permitir que Membros da Organização criem equipes
- Abra as configurações da organização.
- Vá para Funções e Permissões.
- Habilite a opção que permite que Membros da Organização criem equipes.
- Salve a configuração.
A permissão está desabilitada por padrão e pode ser alterada por um Proprietário ou Administrador da Organização.
Proprietários e Administradores da Organização podem criar equipes da organização independentemente desta configuração.
Passo 2: Testar a criação de equipes como Membro da Organização
Use uma conta de Membro da Organização piloto.
- Faça login como o membro.
- Abra a página Inicial do Apidog.
- Crie uma nova equipe na organização.
- Insira o nome da equipe e conclua o fluxo de criação.
- Abra a nova equipe.
Confirme todos os seguintes:
- a equipe pertence à organização;
- o membro que a criou é o Proprietário da Equipe;
- o membro pode gerenciar a nova equipe de acordo com a função de Proprietário da Equipe;
- o membro ainda não pode acessar as páginas de gerenciamento da organização.
A última verificação é importante. Um Proprietário da Equipe gerencia essa equipe, mas não se torna um Administrador da Organização.
Passo 3: Revisar equipes e status do proprietário
Proprietários e Administradores da Organização podem monitorar as equipes da organização a partir da página de gerenciamento de equipes.
- Abra a página de gerenciamento de equipes da organização.
- Revise o Proprietário da Equipe atribuído a cada equipe.
- Verifique o status do proprietário para contas inativas ou indisponíveis por outros motivos.
- Pesquise ou filtre por Proprietário da Equipe e status do proprietário quando for necessário acompanhamento.
Use a lista de equipes para identificar equipes cujos proprietários podem estar indisponíveis e exigem uma transferência de propriedade.
Uma regra operacional simples é revisar o status do proprietário durante as revisões regulares de acesso e antes de remover um membro da organização.
Passo 4: Transferir Propriedade da Equipe
Proprietários e Administradores da Organização podem transferir uma ou mais equipes para outro membro elegível da organização.
- Abra a página de gerenciamento de equipes da organização.
- Selecione a equipe ou equipes que precisam de um novo proprietário.
- Selecione Alterar Proprietários.
Múltiplas equipes selecionadas podem ser atribuídas ao mesmo novo proprietário.
- Selecione o novo Proprietário da Equipe.
- Confirme a transferência.
O novo proprietário deve ser um membro elegível e ativo da organização.
O novo proprietário deve:
- ter uma conta Apidog utilizável;
- ser um membro ativo da organização;
- ter uma identidade SSO associada à organização quando a organização usa SAML SSO.
Usuários SSO pendentes, removidos, desativados ou incompletamente associados não podem ser selecionados.
O que muda após a transferência de propriedade
Após a transferência:
- o membro selecionado torna-se Proprietário da Equipe;
- o Apidog adiciona o novo proprietário à equipe, se necessário;
- o proprietário anterior torna-se Administrador da Equipe se permanecer na equipe;
- a transferência é registrada nos Logs de Auditoria da organização.
A transferência de propriedade altera apenas o Proprietário da Equipe. Ela não move a equipe para dentro ou para fora da organização.
Verificar a configuração
Execute estas verificações antes de habilitar a permissão para todos os membros:
| Verificação | Resultado esperado |
|---|---|
| Membro cria uma equipe | A equipe é criada sob a organização |
| Função da equipe do criador | O criador é Proprietário da Equipe |
| Função da organização do criador | O criador permanece Membro da Organização |
| Configurações da organização | O criador não pode abrir as páginas de gerenciamento da organização |
| Revisão do proprietário | Proprietário/Administrador da Organização pode ver a equipe e o status do proprietário |
| Transferência de propriedade | Novo proprietário elegível recebe a propriedade e o evento aparece nos Logs de Auditoria |
Após o piloto, comunique as convenções de nomenclatura, proprietário e criação de projetos exigidas aos membros que usarão a permissão.
Solução de problemas
| Problema | O que verificar |
|---|---|
| Um membro não consegue criar uma equipe | Confirme se a configuração está habilitada e se o usuário é um Membro da Organização ativo na organização correta. |
| O membro espera acesso às configurações da organização | A propriedade da equipe não concede permissões de Administrador da Organização. |
| Um novo proprietário não pode ser selecionado | Confirme se a conta está ativa e, para uma organização SAML, vinculada à identidade SSO da organização. |
| Um ex-proprietário ainda tem acesso à equipe | Se o ex-proprietário permanecer na equipe, sua função muda para Administrador da Equipe. Revise se esse acesso ainda é necessário. |
| A equipe foi movida para outra organização | A transferência de propriedade não move equipes. Revise se uma ação de transferência de equipe separada foi realizada. |
Limitações importantes
- A configuração permite que os membros criem equipes pertencentes à organização; ela não permite que gerenciem a organização.
- O criador recebe a função interna de Proprietário da Equipe. Permissões personalizadas para funções de equipe não são atualmente suportadas.
- A propriedade em nível de equipe não determina automaticamente todas as funções de projeto. Revise o acesso ao projeto separadamente.
- A transferência de propriedade não transfere a equipe entre organizações.
Tutoriais relacionados sobre governança de API:
Estes tutoriais abordam controles complementares para governar um espaço de trabalho de API empresarial:
- Estrutura de Governança de API — conecte propriedade, controles, evidências e decisões de ciclo de vida.
- Mapeamento de Grupo SAML com Microsoft Entra ID — atribua acesso à equipe a partir de grupos de provedores de identidade.
- Scanner de Segredos — revise possíveis credenciais expostas em ativos Apidog suportados.
- Logs de Auditoria — investigue e exporte atividades administrativas da organização.
- Provisionamento SCIM — gerencie usuários da organização através do ciclo de vida da identidade.
- Políticas Empresariais — configure controles de credenciais, associação, sessão SSO e convites.
- Equipes de API de Autoatendimento — permita equipes criadas por membros, mantendo a supervisão da propriedade.
- Integração com GitHub Enterprise Cloud — conecte repositórios GHE.com suportados para fluxos de trabalho OpenAPI.
Documentação oficial relacionada: