Organizações

Uma organização agrupa credenciais sob um único proprietário para que várias pessoas possam compartilhá-las: API keys para a JSON API e usuários de proxy para a porta de proxy. Todo o consumo das credenciais de uma organização é contabilizado no plano do proprietário da organização, e não na conta de quem disparou a request.

Onde encontrar

Faça login no dashboard e abra Organizations na barra lateral. Cada organização à qual você pertence aparece como uma linha:

Coluna	O que mostra
Organization	O nome. Clique nele, ou em Open, para acessar a página da organização.
Your role	Owner, Admin ou Member
Members	Quantas pessoas fazem parte dela, incluindo o proprietário
Keys	Quantas API keys a organização possui
Created	Quando foi criada
Actions	Open

Criando uma organização

Clique em New organization, digite um nome entre 2 e 60 caracteres e confirme. Você se torna o proprietário. O nome deve conter pelo menos uma letra ou dígito e não pode coincidir com o nome de uma organização existente (letras e dígitos são comparados; todo o resto é ignorado).

A criação de uma organização exige um plano que cubra mais de uma pessoa. A linha Organizations you own em Usage & Limits indica se o seu plano é compatível.

Funções

Existem três funções, e cada organização possui exatamente um proprietário.

Função	O que pode fazer
Member	Criar e usar as API keys e usuários de proxy da organização, renomear suas API keys e visualizar os membros e equipes da organização
Admin	Tudo o que um membro pode fazer, além de adicionar e remover pessoas, alterar suas funções, gerenciar todas as credenciais da organização e renomear a organização
Owner	Tudo o que um administrador pode fazer, além de transferir a organização para outra pessoa. O proprietário mantém o plano no qual todas as credenciais da organização são faturadas.

O proprietário não pode ser removido, não pode sair e não pode ser rebaixado de função. A propriedade muda de uma única forma: por transferência.

Estar na organização é o que concede acesso às credenciais dela. Um membro sem privilégios de administrador ainda pode criar uma key ou um usuário de proxy pago pela empresa, que é o objetivo principal: um desenvolvedor criando coletores não deve precisar de uma credencial pessoal que cobre dele silenciosamente em vez de faturar para a empresa.

A página da organização

Clicar em Open em qualquer linha leva você à página da respectiva organização. Seis cards aparecem no topo: Members (com a divisão entre proprietário, administradores e membros logo abaixo), Your role, Owner, API keys, Proxy users e Teams. Abaixo deles, duas abas:

• Members: as pessoas na organização, juntamente com os controles concedidos pela sua função.
• Teams: as equipes às quais você pertence dentro desta organização, somente leitura.

Proprietários e administradores também contam com um botão Rename no cabeçalho da página.

Adicionando pessoas

Proprietários e administradores visualizam um card Add a member acima da tabela Members. Insira um endereço de e-mail, selecione Member ou Admin e confirme o envio.

O que acontece a seguir depende do endereço, e o dashboard informa qual foi a situação:

• O endereço já tem uma conta FourA: a pessoa entra imediatamente e recebe um e-mail informando a organização, quem a adicionou e quais são as permissões da sua função.
• O endereço não tem conta: a FourA envia um convite por e-mail e a pessoa passa a fazer parte assim que fizer login com esse endereço. Não há nada para clicar, e o convite funciona quer ela crie uma nova conta ou já tivesse uma conta anterior nunca acessada.

Os convites expiram após 14 dias. Adicionar novamente o mesmo endereço renova o convite pendente em vez de acumular um segundo.

O proprietário recebe um e-mail sempre que alguém entra, pois o novo integrante consome os créditos do proprietário. Ninguém recebe e-mail de confirmação sobre sua própria ação.

Convites pendentes

Enquanto houver pelo menos um convite em aberto, uma tabela de Convites fica visível acima de Membros para proprietários e admins. Ela lista o endereço, a função atribuída, quem convidou e quando. Convites expirados permanecem listados e são identificados para que você entenda por que ninguém entrou. Use a ação na linha para revogar um convite.

Alterando uma função

Proprietários e admins alteram a função de um membro entre Membro e Admin no menu suspenso da coluna Função. Três regras:

• Você não pode alterar sua própria função. Peça a outro admin ou saia da organização.
• A função do proprietário não pode ser editada aqui. Use Tornar proprietário em vez disso.
• Toda alteração solicita confirmação antes e informa o que a pessoa poderá fazer em seguida.

Removendo alguém e saindo

Proprietários e admins veem o botão Remover em todas as linhas, exceto na própria e na do proprietário. Sua própria linha exibe Sair, independentemente da sua função.

Remover alguém também retira a pessoa dos times da organização, fazendo com que ela perca imediatamente o acesso às credenciais. As credenciais em si não são afetadas: a chave ou o usuário de proxy de uma organização pertence à organização, não a quem o criou.

O proprietário não pode ser removido nem sair da organização. Transfira a titularidade da organização antes.

Transferindo a titularidade da organização

Apenas o proprietário pode fazer isso. Na aba Membros, clique em Tornar proprietário na pessoa correspondente e confirme.

A organização passa para o plano dessa pessoa: a partir desse momento, cada request feito por suas chaves e cada túnel aberto por seus usuários de proxy consome os créditos, o tráfego, os limites e a fatura do novo proprietário. O proprietário anterior torna-se admin e mantém todas as permissões de admin.

Quais chaves você visualiza

Todas as chaves pertencentes a uma organização são visíveis para todos os membros da organização. O que varia são as ações permitidas para cada função:

Ação	Membro	Admin	Proprietário
Usar a chave, revelar, criar novas chaves da organização	Sim	Sim	Sim
Renomear, editar descrição	Sim	Sim	Sim
Gerar novamente, desativar, excluir	Não	Sim	Sim
Mover a chave para fora da organização	Não	Não	Sim

Renomear uma chave é inofensivo. Regenerar ou desativar uma chave interrompe o acesso de todos os colegas que a utilizam no instante em que a ação ocorre, e é por isso que essas funções ficam restritas aos administradores. Mover uma chave para fora remove o recurso da empresa e transfere o uso para o plano do próprio destinatário, motivo pelo qual essa ação cabe apenas ao proprietário.

Consulte Gerenciando Chaves de API para o passo a passo completo.

Quais Usuários de Proxy Você Vê

Um usuário de proxy segue os mesmos três níveis, pelos mesmos motivos.

Ação	Membro	Administrador	Proprietário
Usar, ler sua senha, criar novos	Sim	Sim	Sim
Nova senha, desativar, excluir, alterar segmentação salva	Não	Sim	Sim
Transferir para fora da organização	Não	Não	Sim

A segmentação salva fica com os administradores em vez dos membros porque redirecioná-la altera silenciosamente todas as conexões que a organização inteira faz com essa credencial. Uma nova senha fica restrita aos administradores porque invalida todos os arquivos de configuração nos quais a credencial já foi inserida.

O downloader de uma empresa deve usar um usuário de proxy da organização. Um usuário pessoal para de funcionar no dia em que essa pessoa sai da empresa, além de cobrar na conta dela. Consulte Usuários de Proxy para o passo a passo.

O Filtro de Proprietário

Assim que você passa a pertencer a uma organização, um menu suspenso de Proprietário aparece acima de Visão Geral, Métricas, Atividade, Chaves de API e Proxy. Ele possui três tipos de opções: Tudo, Pessoal e uma entrada para cada organização. A escolha é mantida entre visitas e se aplica a cada uma dessas cinco páginas.

Uso e Limites e Faturamento deliberadamente não usam o filtro. Essas telas respondem "o que é faturado para mim", o que é diferente de "o que posso ver": um membro nunca vê a cota do proprietário.

Atribuição de Faturamento

Toda request feita com uma chave pertencente à organização, e todo túnel aberto com um usuário de proxy da organização, é faturado para o proprietário da organização, independentemente de quem disparou a ação. Esse é o principal motivo para mover uma credencial para uma organização: isso muda para quem o uso é contabilizado em créditos, tráfego, limites do plano e faturas.

A página Uso e Limites do proprietário contabiliza as credenciais da organização junto com as pessoais, na aba de chaves de API e na aba de Usuários de proxy, separando as duas para deixar claro de onde veio o gasto.

Equipes

Toda organização recebe uma equipe padrão chamada Todos. Novas chaves são atribuídas a ela automaticamente e todos que entram na organização são adicionados a ela, que é o que concede o acesso às chaves pela condição de membro.

A aba Equipes lista as equipes às quais você pertence, com seu cargo em cada uma, a contagem de membros e as chaves que ela permite utilizar (Chaves que você pode usar). A criação e edição de equipes ainda não está disponível no painel.

Relacionado

• Gerenciando Chaves de API: Crie, transfira e gerencie chaves dentro de uma organização
• Usuários de Proxy: Crie e transfira usuários de proxy dentro de uma organização
• Uso e Limites: Membros da equipe, organizações e o que seu plano permite
• Faturamento e Assinaturas: Como o plano do proprietário cobre o uso de chaves da organização
• Visão Geral do Dashboard: Todas as seções do dashboard