🔥Firebase

Imagem 1 - Integração com o Firebase.

🔑 1. Pré-requisitos – Obtendo Credenciais

Para utilizar os conectores, é necessário configurar uma Conta de Serviço (Service Account) do Firebase, que fornece credenciais administrativas.

⚠️ Atenção: Essas credenciais são sensíveis e nunca devem ser expostas no lado do cliente (navegador ou apps públicos).

Como gerar as credenciais (arquivo JSON):

1. Acesse o Console do Firebase e selecione seu projeto.

2. Clique no ícone de engrenagem → Configurações do projeto.

   

   Imagem 2 - Clicar em engrenagem -> Configurações do projeto.
3. Vá até a aba Contas de serviço.

   

   Imagem 3 - Aba 'Contas de serviço'.
4. Clique em Gerenciar permissões da conta de serviço (redireciona ao Console do Google Cloud).

   

   Imagem 4 - Clicar em 'Gerenciar permissões da conta de serviço'.
5. Localize a conta de serviço padrão do Firebase Admin SDK.

6. Clique nos três pontos verticais → Gerenciar chaves.

   

   Imagem 5 - Clicar em 'Gerenciar chaves'.
7. Selecione Adicionar chave → Criar nova chave.

   

   Imagem 6 - Criar nova chave.
8. Escolha o formato JSON e clique em Criar.

   

   Imagem 7 - Selecionar JSON e criar.

➡️ Um arquivo .json será baixado. Ele contém todas as credenciais necessárias.

Imagem 8 - Após a geração da chave, é feito o download automaticamente do JSON.

Imagem 9 - Caso o download não seja iniciado, deve-se clicar em 'Gerar nova chave privada'.

---

📂 2. Estrutura das Credenciais

O arquivo JSON terá uma estrutura semelhante a:

{
  "type": "service_account",
  "project_id": "seu-id-do-projeto",
  "private_key_id": "uma-longa-string-de-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...",
  "client_email": "[email protected]",
  "client_id": "12345678901234567890",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk..."
}

---

⚙️ 3. Parâmetros de Conexão

O conector utiliza os seguintes campos do arquivo para autenticação:

Parâmetro	Descrição	Exemplo
project_id	Identificador único do projeto Firebase.	"seu-id-do-projeto"
private_key	Chave privada completa (com BEGIN/END).	"-----BEGIN PRIVATE KEY-----\n..."
client_email	E-mail associado à Conta de Serviço.	"[email protected]"

💡 4. Boas Práticas e Dicas

• Organização: use nomes de pastas bem estruturados (ex.: uploads/ano/mes/arquivo.pdf).

• Segurança: nunca exponha a private_key em front-end.

• Logs: evite registrar arquivos ou credenciais em logs.

• Permissões: revise as regras de segurança no Firebase para evitar erros de permission denied.

• Teste gradual: crie documento → busque → atualize → delete, para validar a configuração passo a passo.

• IDs: para testes, use IDs simples (qa-001) em Firestore. Após push, consulte o retorno para capturar o ID gerado.

Após concluir a configuração da integração com o Firebase, você poderá utilizar os módulos Firestore e Storage, criados para oferecer controle completo sobre dados ou arquivos, conforme o conector escolhido.