Chaves e segredos

Chaves

O card Keys lista os serviços conectados à sua conta, como Stripe, OpenAI ou Shopify, que seus apps podem usar, com uma contagem. Ele mostra todas as conexões ativas da conta, não só as deste app. Ao clicar nele, você abre Conectores, onde você os adiciona uma só vez e escolhe quais apps usam cada um.

Segredos

Chaves para serviços que o app chama e que não têm um conector: um serviço de clima, SMS, a API de um cliente. Ficam no menu, em Cloud, e é preciso alguém que possa editar o app. Clique em Add secret, dê um nome e o endereço do serviço e cole a chave.

• A chave é enviada somente para esse endereço, nunca para outro lugar, e nunca fica no código do app.
• Ela é guardada criptografada. Depois de salva, pode ser substituída ou excluída, mas não lida.
• Uma mudança vale na hora, na pré-visualização e no app publicado, sem publicar de novo.

Depois, peça no chat pelo nome: “Mostre o clima em Paris usando WEATHER_KEY”. O app escreve o nome no lugar da chave, e o Setherion coloca a chave na hora de enviar. Cada solicitação com um segredo usa um crédito de integração. Apps no seu próprio Supabase ainda não podem usar segredos.

Regras de um segredo

• O nome é feito de letras maiúsculas, dígitos e sublinhados, começa com uma letra e tem de 2 a 64 caracteres, como WEATHER_KEY. Um nome que contém uma chave é recusado, assim como um nome que já está em uso: substitua o segredo antigo pelo menu dele.
• O valor pode ter até 4.096 caracteres, e um app pode guardar 50 segredos.
• O endereço do serviço precisa ser um endereço https público. Endereços IP, localhost, portas e nomes privados são recusados. Se você colar um link inteiro, só o host dele é mantido.
• Uma solicitação só é enviada se o endereço dela for o salvo com o segredo. Caso contrário, ela é recusada com uma mensagem dizendo que o segredo só pode ser enviado para aquele host.
• A chave é removida da resposta antes de o app a ver.
• Uma solicitação espera até 30 segundos, não é redirecionada, e a resposta pode ter até 5 MB.
• Um visitante pode fazer até 600 solicitações desse tipo por hora. Elas param enquanto o backend está pausado ou a cota mensal se esgotou.
• A tabela mostra o nome de cada segredo, o endereço para onde ele é enviado e quando foi atualizado, com Replace e Delete em cada linha.