Autenticar suas solicitações

As bibliotecas de cliente do Cloud para Java usam a biblioteca de autenticação do Google para Java para autenticar solicitações. Essa biblioteca oferece suporte a vários tipos de autenticação. Para mais detalhes, consulte o README.md e o javadoc do projeto.

Autenticação em um Google Cloud ambiente

Ao usar Google Cloud bibliotecas de um Google Cloud ambiente (como o Compute Engine, o Google Kubernetes Engine ou o App Engine), não é necessário realizar etapas de autenticação adicionais.

Um exemplo de chamada sem autenticação adicional:

Storage storage = StorageOptions.getDefaultInstance().getService();

Autenticação em ambientes não-Google Cloud

Para autenticar em um ambiente não-Google Cloud há três opções comuns:

1. (Recomendado) Use uma conta de serviço.
2. Use o SDK Google Cloud com um ambiente de teste local.
3. Use um token de acesso OAuth2.

Usar uma conta de serviço

1. Gere uma chave de conta de serviço JSON.

2. Depois de fazer o download da chave, faça uma destas ações:

   • Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o local da chave. Exemplo:

   export GOOGLE_APPLICATION_CREDENTIALS=/path/to/my/key.json
   

   • Forneça o arquivo de credenciais JSON ao criar as opções de serviço. Por exemplo, esse objeto Storage tem as permissões necessárias para interagir com os dados do Cloud Storage:

   Storage storage = StorageOptions.newBuilder()
       .setCredentials(ServiceAccountCredentials.fromStream(new FileInputStream("/path/to/my/key.json")))
       .build()
       .getService();
   

Usar o SDK Google Cloud com um ambiente de teste local

Se você estiver usando um ambiente local para desenvolvimento ou teste, use o SDK Google Cloud.

Crie as credenciais padrão do aplicativo com gcloud auth application-default login. As bibliotecas de cliente do Cloud para Java vão detectar essas credenciais automaticamente.

Usar um token de acesso OAuth2

Se você tiver um token de acesso OAuth2, use-o para autenticar. Nesse caso, o token de acesso não será atualizado automaticamente:

Credentials credentials = GoogleCredentials.create(new AccessToken(accessToken, expirationTime));
Storage storage = StorageOptions.newBuilder()
    .setCredentials(credentials)
    .build()
    .getService();

Vejamos outro exemplo:

Credentials credentials = GoogleCredentials.create(new AccessToken(accessToken, expirationTime));
CloudTasksSettings cloudTasksSettings = CloudTasksSettings.newBuilder()
    .setCredentialProvider(FixedCredentialsProvider.create(credentials))
    .build();
CloudTasksClient cloudTasksClient = CloudTasksClient.create(cloudTasksSettings);

Application Default Credentials

Se você não fornecer credenciais, as bibliotecas de cliente do Cloud para Java vão tentar detectá-las no ambiente usando GoogleCredentials.getApplicationDefault(). Esse método pesquisa as Application Default Credentials nos seguintes locais, em ordem:

1. O arquivo de credenciais apontado pela variável de ambiente GOOGLE_APPLICATION_CREDENTIALS.
2. Credenciais fornecidas pelo comando gcloud auth application-default login do SDK Google Cloud.
3. Credenciais integradas do Google App Engine.
4. Google Cloud Credenciais integradas do shell.
5. Credenciais de conta de serviço integradas do Google Compute Engine.

Autenticação com uma chave de API

Algumas Google Cloud APIs oferecem suporte à autenticação com chaves de API.

Para usar uma chave de API com as bibliotecas de cliente do Cloud para Java, defina manualmente o cabeçalho x-goog-api-key para o cliente de serviço relevante.

Por exemplo, para definir a chave de API com o Language service:

public LanguageServiceClient createGrpcClientWithApiKey(String apiKey) throws Exception {
    // Manually set the API key using the header
    Map<String, String> header = new HashMap<String, String>() { {put("x-goog-api-key", apiKey);}};
    FixedHeaderProvider headerProvider = FixedHeaderProvider.create(header);

    // Create the client
    TransportChannelProvider transportChannelProvider = InstantiatingGrpcChannelProvider.newBuilder().setHeaderProvider(headerProvider).build();
    LanguageServiceSettings settings = LanguageServiceSettings.newBuilder().setTransportChannelProvider(transportChannelProvider).build();
    LanguageServiceClient client = LanguageServiceClient.create(settings);
    return client;
  }

Um exemplo de instanciação com o cliente de linguagem usando REST:

 public LanguageServiceClient createRestClientWithApiKey(String apiKey) throws Exception {
    // Manually set the API key header
    Map<String, String> header = new HashMap<String, String>() { {put("x-goog-api-key", apiKey);}};
    FixedHeaderProvider headerProvider = FixedHeaderProvider.create(header);

    // Create the client
    TransportChannelProvider transportChannelProvider = InstantiatingHttpJsonChannelProvider.newBuilder().setHeaderProvider(headerProvider).build();
    LanguageServiceSettings settings = LanguageServiceSettings.newBuilder().setTransportChannelProvider(transportChannelProvider).build();
    LanguageServiceClient client = LanguageServiceClient.create(settings);
    return client;
  }