Autenticare le richieste

Le librerie client di Cloud per Java utilizzano la libreria di autenticazione Google per Java per autenticare le richieste. Questa libreria supporta più tipi di autenticazione. Per maggiori dettagli, consulta la README.md e la javadoc del progetto.

Autenticazione in un ambiente Google Cloud

Quando utilizzi le librerie Google Cloud da un ambiente Google Cloud (come Compute Engine, Google Kubernetes Engine o App Engine), non devi eseguire passaggi di autenticazione aggiuntivi.

Esempio di chiamata senza autenticazione aggiuntiva:

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

Autenticazione in ambienti nonGoogle Cloud

Per l'autenticazione in un ambiente nonGoogle Cloud , esistono tre opzioni comuni:

1. (Consigliato) Utilizza un service account.
2. Utilizza Google Cloud SDK con un ambiente di test locale.
3. Utilizza un token di accesso OAuth2 esistente.

Utilizzare un service account

1. Genera una chiave service account JSON.

2. Dopo aver scaricato la chiave, devi effettuare una delle seguenti operazioni:

   • Definisci la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS in modo che corrisponda alla posizione della chiave. Ad esempio:

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

   • Fornisci il file JSON delle credenziali durante la creazione delle opzioni di servizio. Ad esempio, questo oggetto Storage dispone delle autorizzazioni necessarie per interagire con i tuoi dati Cloud Storage:

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

Utilizzare Google Cloud SDK con un ambiente di test locale

Se utilizzi un ambiente locale per lo sviluppo o il test, puoi utilizzare Google Cloud SDK.

Crea le credenziali predefinite dell'applicazione con gcloud auth application-default login. Le librerie client di Cloud per Java rileveranno automaticamente queste credenziali.

Utilizzare un token di accesso OAuth2 esistente

Se hai un token di accesso OAuth2, puoi utilizzarlo per l'autenticazione. In questo caso, il token di accesso non viene aggiornato automaticamente:

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

Un altro esempio:

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

Credenziali predefinite dell'applicazione

Se non fornisci le credenziali, le librerie client di Cloud per Java tenteranno di rilevarle dall'ambiente utilizzando GoogleCredentials.getApplicationDefault(). Questo metodo cerca le credenziali predefinite dell'applicazione nelle seguenti posizioni, in ordine:

1. Il file delle credenziali a cui fa riferimento la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS.
2. Credenziali fornite dal comando gcloud auth application-default login di Google Cloud SDK.
3. Le credenziali integrate di Google App Engine.
4. Google Cloud Credenziali integrate di Shell.
5. Credenziali del service account integrate di Google Compute Engine.

Autenticazione con una chiave API

Alcune API Google Cloud supportano l'autenticazione con le chiavi API.

Per utilizzare una chiave API con le librerie client Cloud per Java, devi impostare manualmente l'intestazione x-goog-api-key per il client di servizio pertinente.

Ad esempio, per impostare la chiave API con 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;
  }

Un esempio di creazione di istanze con il client Language utilizzando 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;
  }