Organizações
Uma organização agrupa credenciais sob um único proprietário para que várias pessoas possam compartilhá-las: API keys para a API JSON e usuários de proxy para a proxy port. Tudo o que as credenciais de uma organização consomem é cobrado no plano do proprietário da organização, não de quem disparou a request.
Onde encontrar
Faça login no dashboard e abra Organizations na barra lateral. Cada organização à qual você pertence é uma linha:
| Coluna | O que exibe |
|---|---|
| Organization | O nome. Clique nele, ou em Open, para ir à página da organização. |
| Your role | Owner, Admin ou Member |
| Members | Quantas pessoas estão nela, incluindo o proprietário |
| Keys | Quantas API keys a organização possui |
| Created | Quando foi criada |
| Actions | Open |
Como criar uma organização
Clique em New organization, insira um nome entre 2 e 60 caracteres e confirme. Você se torna o proprietário. O nome pode usar letras, números, espaços e . , & + ( ) - _ ', até oito palavras, sem endereço web, e a mesma regra se aplica ao renomeá-la. Ele deve conter pelo menos uma letra latina (a a z) ou dígito, e não pode coincidir com o nome de uma organização existente (apenas letras latinas e dígitos são comparados, ignorando maiúsculas e minúsculas; todo o resto é desconsiderado).
Criar uma organização requer um plano que cubra mais de uma pessoa. A linha Organizations you own em Usage & Limits mostra se o seu plano permite.
Funções
Existem três, e cada organização tem 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 ver os membros e times 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 admin 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. A propriedade muda em apenas uma direção: por transferência.
Estar na organização é o que concede acesso às credenciais dela. Um membro sem direitos de admin ainda pode criar uma chave ou um usuário de proxy pago pela empresa, que é o objetivo: um desenvolvedor escrevendo coletores não deve precisar de uma credencial pessoal que cobre dele silenciosamente em vez da empresa.
A página da organização
Open em qualquer linha leva você à página dessa organização. Seis cards ficam no topo: Members (com a divisão entre owner, admin e member abaixo), Your role, Owner, API keys, Proxy users e Teams. Abaixo deles, duas abas:
- Members: as pessoas na organização, além dos controles que a sua função permite.
- Teams: os times aos quais você pertence dentro desta organização, somente leitura.
Proprietários e admins também têm um botão Rename no cabeçalho da página.
Como adicionar pessoas
Proprietários e admins veem um card Add a member acima da tabela Members. Digite um endereço de email, selecione Member ou Admin e confirme.
O que acontece a seguir depende do endereço, e o dashboard informa o caso correspondente:
- O endereço já tem uma conta FourA: a pessoa entra imediatamente e recebe um email informando a organização, quem a adicionou e o que a função dela permite fazer.
- O endereço não tem conta: o FourA envia um convite por email e ela entra assim que fizer login com esse endereço. Não é preciso clicar em nada, e o convite funciona tanto se ela criar uma conta nova quanto se já tiver uma conta que nunca abriu.
Os convites expiram após 14 dias. Adicionar o mesmo endereço novamente não acumula um segundo convite. O FourA envia um convite por endereço e organização a cada 24 horas (um convite cancelado também conta): uma segunda tentativa dentro dessa janela é recusada com We already sent an invitation to this address today. Try again tomorrow., e o convite já enviado permanece válido. Cada pessoa pode enviar 20 convites em 24 horas considerando todas as suas organizações.
O proprietário recebe um email sempre que alguém entra, pois o novo integrante consome os créditos do proprietário. Ninguém recebe email confirmando a própria ação.
Convites Pendentes
Enquanto houver pelo menos um convite aberto, uma tabela Invitations fica visível para proprietários e admins acima de Members. Ela lista o endereço, a função atribuída, quem convidou e a data. Convites expirados continuam listados e marcados para você identificar por que ninguém entrou. Use a ação na linha correspondente para cancelar um convite.
Alterar uma Função
Proprietários e admins alteram a função de um membro entre Member e Admin usando o menu suspenso na coluna Role. 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 Make owner em vez disso.
- Toda alteração solicita confirmação prévia e descreve as permissões que a pessoa terá depois.
Remover Alguém e Sair da Organização
Proprietários e admins têm o botão Remove em todas as linhas, exceto na sua própria e na do proprietário. Na sua própria linha é exibido Leave, a menos que você seja o proprietário: a linha do proprietário exibe Carries the billing.
Remover alguém também retira o usuário dos times da organização, interrompendo imediatamente o acesso às credenciais correspondentes. As credenciais em si não são afetadas: a chave ou o usuário proxy de uma organização pertence à organização, não a quem o criou.
O proprietário não pode ser removido nem pode sair. É necessário transferir a organização primeiro.
Transferir a Organização
Apenas o proprietário pode fazer isso. Na aba Members, clique em Make owner na pessoa que vai assumir e confirme.
A organização migra para o plano dessa pessoa: a partir desse momento, cada request de suas chaves e cada túnel aberto por seus usuários proxy consome créditos, tráfego, limites e fatura dela. O proprietário anterior se torna admin e mantém todas as permissões dessa função.
Quais Chaves Você Visualiza
Toda chave pertencente a uma organização fica visível para todos os membros da organização. O que varia é o que você pode fazer com ela:
| Ação | Membro | Admin | Proprietário |
|---|---|---|---|
| Usar a chave, revelá-la, criar novas chaves da organização | Sim | Sim | Sim |
| Renomeá-la, editar sua 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. Gerar novamente ou desativar uma chave interrompe o uso por qualquer colega no mesmo instante, e é por isso que essas ações ficam com admins. Mover uma chave para fora remove o recurso da empresa e transfere seu uso para o plano do próprio destinatário, por isso essa ação fica exclusivamente com o proprietário.
Consulte Managing API Keys para ver 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 | Admin | Proprietário |
|---|---|---|---|
| Usar, ler a senha, criar novos | Sim | Sim | Sim |
| Nova senha, desativar, excluir, alterar o direcionamento salvo | Não | Sim | Sim |
| Transferir para fora da organização | Não | Não | Sim |
O direcionamento salvo fica com admins em vez de membros porque redirecioná-lo altera silenciosamente todas as conexões que a organização inteira faz usando essa credencial. Uma nova senha fica com admins porque quebra todos os arquivos de configuração onde a credencial já foi inserida.
O downloader de uma empresa deve usar um usuário de proxy da organização. Um usuário de proxy pessoal para de funcionar no dia em que a pessoa sai da empresa, além de ser faturado para ela. Consulte Proxy Users para ver 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 é exibido acima de Overview, Metrics, Activity, API Keys e Proxy. Ele oferece três tipos de opção: Tudo, Pessoal e uma entrada para cada organização. A escolha permanece salva entre visitas e se aplica a todas essas cinco páginas.
Usage & Limits e Billing deliberadamente não recebem o filtro. Essas seções respondem a "o que é faturado para mim", o que é diferente de "o que posso visualizar": um membro nunca vê a cota do proprietário.
Atribuição de faturamento
Toda request feita com uma chave da organização e todo túnel aberto com um usuário de proxy da organização são cobrados do proprietário da organização, não importa quem tenha disparado a ação. Esse é o principal motivo para transferir uma credencial para uma organização: isso define quem absorve o uso em termos de créditos, tráfego, limites do plano e faturas.
A página Usage & Limits do proprietário contabiliza credenciais da organização ao lado das pessoais, tanto na guia de API keys quanto na de usuários de proxy, e separa os dois grupos para deixar claro de onde veio o gasto.
Times
Toda organização recebe um time padrão chamado Everyone. Novas chaves são atribuídas a ele automaticamente e qualquer pessoa que entra na organização é adicionada a ele, permitindo que a associação conceda acesso às chaves.
A aba Teams lista as equipes às quais você pertence, com a sua função em cada uma, a contagem de membros e as chaves que ela permite usar (Keys you can use). A criação e a edição de equipes ainda não estão disponíveis no dashboard.
Relacionados
- Gerenciando API Keys: 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 o 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