🔥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.

   
3. Vá até a aba Contas de serviço.

   
4. Clique em Gerenciar permissões da conta de serviço (redireciona ao Console do Google Cloud).

   
5. Localize a conta de serviço padrão do Firebase Admin SDK.

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

   
7. Selecione Adicionar chave → Criar nova chave.

   
8. Escolha o formato JSON e clique em Criar.

   

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

📂 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:

💡 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.