Boas práticas com chaves de API e acessos
Uma chave de API dá acesso à sua conta da Provei e pode gastar seus créditos. Guarde as chaves só no servidor, nunca no código do site, e troque a chave na hora se ela vazar.
Onde a chave pode ficar
Seção intitulada “Onde a chave pode ficar”Use a chave apenas em sistemas que rodam no servidor da sua loja, como um ERP ou uma integração própria.
Nunca coloque a chave:
- no tema, no HTML ou em scripts da loja que rodam no navegador;
- em aplicativos instalados no celular dos clientes;
- em repositórios de código, planilhas compartilhadas, e-mails ou mensagens.
O código de instalação do provador não leva chave de API. Se alguém pedir a chave para instalar o provador no tema, desconfie.
No painel, as chaves aparecem mascaradas, como pv_xxxxxxxx••••. A chave completa aparece só uma vez, quando você cria.
Criar uma chave
Seção intitulada “Criar uma chave”- Abra Conta › Desenvolvedor e toque em Criar chave.
- Em Nome (opcional), escreva onde a chave vai ser usada, por exemplo Servidor da loja. Isso ajuda a saber onde cada chave está em uso.
- Copie a chave na tela Copie sua chave agora. Por segurança, ela não aparece de novo.
- Guarde a chave em um lugar seguro, como o cofre de senhas da sua equipe.
Crie uma chave para cada sistema. Assim, se um sistema for comprometido, você revoga só a chave dele. Veja mais em Chaves de API.
Trocar ou revogar uma chave
Seção intitulada “Trocar ou revogar uma chave”Troque a chave se ela vazou, se alguém que tinha acesso a ela saiu da equipe ou se você não sabe onde ela está em uso.
- Crie uma chave nova e configure-a nos seus sistemas.
- Na chave antiga, toque em Revogar e confirme em Revogar chave.
Se a chave vazou, não espere: crie a nova, revogue a antiga e depois atualize os sistemas.
Dar acesso à equipe
Seção intitulada “Dar acesso à equipe”Não compartilhe o seu login. Cada pessoa da equipe deve ter o próprio acesso.
- Abra Conta › Equipe e toque em Convidar pessoa.
- Informe Nome completo e E-mail e toque em Enviar convite. A pessoa recebe um e-mail para criar a senha.
Quem você convida acessa tudo, menos Equipe e Plano e créditos. Isso inclui Conta › Desenvolvedor, então membros da equipe também podem criar e revogar chaves.
Quando alguém sair da equipe, toque em Remover ao lado do nome. A pessoa perde o acesso ao painel na hora. Revise também as chaves que ela conhecia e troque as que forem necessárias.
Se alguém esquecer a senha, use Redefinir senha. O painel mostra uma senha temporária uma única vez: envie para a pessoa por um canal seguro.
Pedidos suspeitos
Seção intitulada “Pedidos suspeitos”A Provei nunca pede sua senha, senha temporária, chave de API ou token por e-mail, WhatsApp ou telefone. Só use os canais desta página: suporte@provei.ai e WhatsApp +55 11 5296-0168. Pedidos de liberação de endereço, ativação de recursos ou mudança de plano devem partir do dono da conta.
Perguntas frequentes
Preciso colocar a chave de API no tema da loja para o provador funcionar?
Não. O código de instalação do provador não leva chave de API. A chave serve só para sistemas da sua loja que chamam a API da Provei a partir de um servidor.
O que faço se uma chave vazar?
Crie uma chave nova, troque nos seus sistemas e revogue a chave que vazou em Conta › Desenvolvedor. Os sistemas que usam a chave revogada param de funcionar na hora.
Posso compartilhar meu login do painel com a equipe?
Não é recomendado. Convide cada pessoa em Conta › Equipe. Cada uma entra com o próprio e-mail e senha, e você remove o acesso quando precisar.