Maps JavaScript API  |  Google for Developers (original) (raw)

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Usar a verificação de app para proteger sua chave de API

O Firebase App Check protege as chamadas do seu app para a Plataforma Google Maps, bloqueando o tráfego de fontes que não são apps legítimos. Para isso, ele verifica um token de um provedor de atestado, como o reCAPTCHA Enterprise. A integração dos seus apps com o App Check ajuda a proteger contra solicitações maliciosas, para que você não seja cobrado por chamadas de API não autorizadas.

A Verificação de app é ideal para mim?

O App Check é recomendado na maioria dos casos, mas não é necessário nem compatível nos seguintes casos:

Visão geral das etapas de implementação

Em um nível alto, estas são as etapas que você vai seguir para integrar seu app ao App Check:

  1. Adicione o Firebase ao aplicativo.
  2. Adicione e inicialize a biblioteca do App Check.
  3. Adicione o provedor de token ao app.
  4. Inicializar as APIs Places e App Check.
  5. Ative a depuração.
  6. Monitore as solicitações do app e decida sobre a aplicação.

Depois de integrar o App Check, você poderá conferir as métricas de tráfego de back-end no console do Firebase. Essas métricas detalham as solicitações que são acompanhadas por um token válido do App Check. Consulte a documentação do Firebase App Check para mais informações.

Quando você tiver certeza de que a maioria das solicitações é de fontes legítimas e que os usuários atualizaram para a versão mais recente do app que inclui a implementação do App Check, ative a aplicação obrigatória. Quando a aplicação estiver ativada, o App Check vai rejeitar todo o tráfego sem um token válido.

Considerações ao planejar uma integração do App Check

Confira alguns pontos a serem considerados ao planejar sua integração:

Integrar seu app com o App Check

Pré-requisitos e requisitos

Etapa 1: adicionar o Firebase ao app

Siga as instruções na documentação para desenvolvedores do Firebase para adicionar o Firebase ao seu app.

Etapa 2: adicionar a biblioteca do App Check e inicializar o App Check

O Firebase oferece instruções para cada provedor de atestado padrão. Estas instruções mostram como configurar um projeto do Firebase e adicionar a biblioteca App Check ao seu app. Siga os exemplos de código fornecidos para inicializar o App Check.

Etapa 3: carregar as bibliotecas da API Maps JS

  1. Carregue as bibliotecas principais, do Maps e do Places, conforme mostrado no snippet a seguir. Para mais informações e instruções, consulte a documentação da classe Place da API Maps JavaScript.
    async function init() {
    const {Settings} = await google.maps.importLibrary('core');
    const {Map} = await google.maps.importLibrary('maps');
    const {Place} = await google.maps.importLibrary('places');
    }

Etapa 4: inicializar as APIs Places e App Check

  1. Inicialize o App Check usando a configuração fornecida pelo Console do Firebase.

  2. Verifique se as solicitações para a API Maps JS são acompanhadas por tokens do App Check:
    async function init() {
    const {Settings} = await google.maps.importLibrary('core');
    const {Map} = await google.maps.importLibrary('maps');
    const {Place} = await google.maps.importLibrary('places');

    const app = initializeApp({
    // Your firebase configuration object
    });

    // Pass your reCAPTCHA Enterprise site key to initializeAppCheck().
    const appCheck = initializeAppCheck(app, {
    provider: new ReCaptchaEnterpriseProvider(
    'abcdefghijklmnopqrstuvwxy-1234567890abcd',
    ),

    // Optional argument. If true, the SDK automatically refreshes App Check
    // tokens as needed.
    isTokenAutoRefreshEnabled: true,
    });

    Settings.getInstance().fetchAppCheckToken = () =>
    getToken(appCheck, /* forceRefresh = / false);
    // Make a Places JS request
    const place = new Place({id: 'ChIJN5Nz71W3j4ARhx5bwpTQEGg'});
    await place.fetchFields({fields: ['    ']});

    // Load a map
    map = new Map(document.getElementById("map"), {
    center: { lat: 37.4161493, lng: -122.0812166 },
    zoom: 8,
    });

}

Etapa 5: ativar a depuração (opcional)

Se você quiser desenvolver e testar seu app localmente ou executá-lo em um ambiente de integração contínua (CI), crie um build de depuração do app que use um segredo de depuração para receber tokens válidos do App Check. Isso evita o uso de provedores de atestado reais no build de depuração.

Para testar o app localmente:

Para executar o app em um ambiente de CI:

Etapa 6: monitorar as solicitações do app e decidir sobre a aplicação

Antes de começar a aplicação, verifique se você não vai interromper os usuários legítimos do app. Para isso, acesse a tela de métricas do App Check e confira qual porcentagem do tráfego do app é verificada, desatualizada ou não legítima. Quando a maioria do seu tráfego estiver verificado, você poderá ativar a aplicação.

Consulte a documentação do Firebase App Check para mais informações e instruções.