2.9 KiB
Configuração de Acesso Administrativo ao Google Cloud
Esta documentação descreve as permissões e configurações necessárias no Google Cloud Platform (GCP) para que o aplicativo possa ler e monitorar as métricas de latência e cota de uso da API Google Sheets em tempo real.
1. Permissões Necessárias no GCP (IAM)
Para consultar as métricas de uso e limites do console do Google Cloud, a conta de serviço (Service Account) utilizada pelo aplicativo precisa dos seguintes papéis (IAM Roles) associados:
-
Leitura de Métricas (Cloud Monitoring):
- Papel: Leitor do Monitoring (
roles/monitoring.viewer) - Motivo: Permite fazer requisições para a API do Cloud Monitoring v3 (
monitoring.googleapis.com) para consultar a série temporal de contagem de requisições (request_count).
- Papel: Leitor do Monitoring (
-
Leitura de Limites de Cota (Service Usage):
- Papel: Visualizador do Service Usage (
roles/serviceusage.serviceUsageViewer) - Motivo: Permite consultar os limites das APIs ativas no projeto (como os limites de cota da Sheets API por minuto) via API Service Usage (
serviceusage.googleapis.com).
- Papel: Visualizador do Service Usage (
2. Configuração de Credenciais no Aplicativo
O aplicativo aceita duas abordagens para gerenciar as chaves de acesso:
Opção A: Credencial Única (Padrão)
Se a chave de serviço padrão (chaveacesso_sheets.apikey.json em assets ou SHEETS_CREDENTIALS_JSON nas variáveis de ambiente) tiver os papéis de visualização IAM citados acima vinculados a ela no GCP Console, nenhuma configuração extra de credencial é necessária. O aplicativo utilizará a mesma chave para sincronizar as planilhas e ler as métricas.
Opção B: Credenciais Administrativas Separadas (Recomendado para Segurança)
Por boas práticas de privilégio mínimo, você pode querer que a chave de leitura/escrita do Google Sheets seja restrita, e usar outra chave distinta com privilégios de monitoramento. Para fazer isso:
- Gere um arquivo de credenciais JSON de uma Conta de Serviço no GCP que possua os papéis
roles/monitoring.viewereroles/serviceusage.serviceUsageViewer. - Renomeie o arquivo gerado para
chaveacesso_admin.apikey.json. - Adicione-o à pasta de ativos do projeto:
app/src/main/assets/chaveacesso_admin.apikey.json. - Opcionalmente, configure a variável de ambiente
ADMIN_CREDENTIALS_JSONno arquivo.envpara que ela seja injetada via Gradle em produção (semelhante ao fluxo padrão do Sheets).
3. Fluxo de Tratamento de Erros no App
Se o aplicativo tentar conectar e:
- A chave de acesso administrativo não for reconhecida,
- Faltarem as permissões IAM necessárias na conta de serviço,
- O dispositivo estiver sem internet na primeira tentativa,
A tela de configurações exibirá um status de erro visual (ex: "Erro de Autenticação" ou "Acesso Negado"). Valores e métricas em tempo real só serão exibidos após uma conexão e validação bem-sucedidas.