Tudo no Ephemeral pertence a uma organização. As pessoas entram em uma organização com uma função, e o software usa chaves de API da organização, com uma função própria. Os dois tipos de função são separados.
Pessoas
| Função | Pode |
|---|---|
| Proprietário | Tudo o que um administrador pode, além de alterar funções, remover administradores e transferir a propriedade. Cada organização tem um proprietário. |
| Administrador | Tudo o que um membro pode, além de gerenciar conexões, membros, convites, chaves de API, faturamento e licenças de implantação. |
| Membro | Iniciar, ler e cancelar execuções; gerenciar arquivos e fluxos de trabalho; usar conexões pelo nome. |
Quem cria uma organização se torna seu proprietário. Os administradores podem convidar pessoas como administradores ou membros e remover membros. Somente o proprietário pode remover um administrador ou alterar a função de alguém. O proprietário não pode ser removido; para deixar o cargo, transfira a propriedade a um membro existente, que passa a ser o proprietário enquanto você passa a ser administrador.
Chaves de API
Uma chave de API age em nome da sua organização. Cada chave tem a função member ou admin, escolhida quando você a cria. O segredo da chave é exibido uma única vez; guarde-o no seu servidor e revogue a chave se ele vazar. A revogação tem efeito imediato.
- Use uma chave de membro no código da aplicação que inicia execuções. Este é o padrão.
- Use uma chave de administrador apenas em ferramentas de configuração confiáveis que também precisem criar ou alterar conexões.
Ambas as funções abrangem toda a organização. Uma chave de membro não é somente leitura, e nenhuma chave pode ser limitada a determinados fluxos de trabalho ou arquivos. Se precisar dessa separação, use organizações separadas.
O que cada função pode fazer
| Ação | Usuário ou chave de membro | Chave de administrador | Usuário proprietário ou administrador |
|---|---|---|---|
| Iniciar, ler e cancelar execuções | Sim | Sim | Sim |
| Enviar, renomear e excluir arquivos | Sim | Sim | Sim |
| Salvar e excluir fluxos de trabalho | Sim | Sim | Sim |
| Listar as conexões disponíveis e usá-las pelo nome | Sim | Sim | Sim |
| Ler e alterar as configurações das conexões, iniciar o OAuth | Não | Sim | Sim |
| Gerenciar membros, convites, chaves de API, faturamento e licenças | Não | Não | Sim |
Chaves hospedadas e auto-hospedadas
| Serviço hospedado | Instalação auto-hospedada | |
|---|---|---|
| Prefixo da chave | eak_ | eph_ |
| Criada em | O painel, em Chaves de API, ou a API de organizações | O painel, em Chaves de API, ou POST /v1/keys |
| Quem pode criar chaves | Proprietário ou administrador, conectado | Uma chave de administrador |
| Primeira chave | Criada por você depois de se cadastrar | Emitida pela requisição de bootstrap durante a configuração |
Uma instalação auto-hospedada não tem contas de clientes, então suas chaves de administrador também gerenciam as chaves da instalação. Veja a auto-hospedagem para a primeira chave e as organizações para os endpoints de chaves do serviço hospedado.
X-Ephemeral-Organization; as chaves de API já pertencem a uma organização.