Usa le chiavi API con l'API Address Validation

I prodotti Google Maps Platform sono protetti dall'uso non autorizzato limitando le chiamate API a quelle che forniscono le credenziali di autenticazione appropriate. Queste credenziali sono sotto forma di chiave API, una stringa alfanumerica univoca che associa il tuo account di fatturazione Google al tuo progetto e all'API o all'SDK specifici.

Questa guida illustra come creare, limitare e utilizzare la tua chiave API per Google Maps Platform.

Prima di iniziare: Per iniziare a utilizzare l'API Address Validation, devi avere un progetto con un account di fatturazione e l' l'API Address Validation abilitata. Consigliamo di creare più proprietari del progetto e amministratori di fatturazione in modo da avere sempre a disposizione qualcuno con questi ruoli per il tuo team. Per scoprire di più, consulta la pagina Configurazione nella console Cloud.

Creazione di chiavi API

La chiave API è un identificatore univoco che autentica le richieste associate al tuo progetto ai fini di utilizzo e fatturazione. Devi avere almeno una chiave API associata al tuo progetto.

Per creare una chiave API:

Console

1. Vai alla pagina Google Maps Platform > Credenziali.

   Vai alla pagina Credenziali

2. Nella pagina Credenziali, fai clic su Crea credenziali > Chiave API.
   Nella finestra di dialogo Chiave API creata viene visualizzata la chiave API appena creata.
3. Fai clic su Chiudi.
   La nuova chiave API è indicata nella pagina Credenziali, nella sezione Chiavi API.
   Ricorda di limitare la chiave API prima di utilizzarla in produzione.

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Scopri di più su Google Cloud SDK , installazione di Cloud SDK e sui seguenti comandi:

• gcloud alpha services api-keys create

Limitazione delle chiavi API

Google consiglia vivamente di limitare le chiavi API limitandone l'utilizzo alle sole API necessarie per l'applicazione. La limitazione delle chiavi API aggiunge sicurezza alla tua applicazione proteggendola da richieste ingiustificate. Per ulteriori informazioni, consulta le best practice per la sicurezza delle API.

Quando limiti una chiave API in Cloud Console, le restrizioni delle applicazioni hanno la precedenza su qualsiasi API abilitata in Restrizioni delle API. Segui le best practice creando una chiave API separata per ogni app e per ogni piattaforma su cui è disponibile.

Per limitare una chiave API:

Console

1. Vai alla pagina Google Maps Platform > Credenziali.

   Vai alla pagina Credenziali

2. Seleziona la chiave API per la quale vuoi impostare una limitazione. Viene visualizzata la pagina delle proprietà della chiave API.
3. In Limitazioni delle chiavi, imposta le seguenti restrizioni:
• Restrizioni delle applicazioni:
1. Per accettare richieste dall'elenco di indirizzi IP del server web fornito, seleziona Indirizzi IP (server web, cron job, ecc.) dall'elenco di Restrizioni delle applicazioni. Specifica uno o più indirizzi IPv4 o IPv6 oppure una subnet utilizzando la notazione CIDR. Gli indirizzi IP devono corrispondere all'indirizzo di origine osservato dai server di Google Maps Platform. Se usi il servizio Network Address Translation (NAT), questo corrisponde in genere all'indirizzo IP pubblico della tua macchina.
• Restrizioni delle API:
1. Fai clic su Limita chiave.
2. Seleziona API Address Validation dal menu a discesa Seleziona API. Se l'API Address Validation non è elencata, devi enable.
4. Per finalizzare le modifiche, fai clic su Salva.
   

Cloud SDK

Elenca le chiavi esistenti.

gcloud services api-keys list --project="PROJECT"

Cancella le limitazioni esistenti per la chiave esistente.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Imposta nuove limitazioni per la chiave esistente.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="addressvalidation.googleapis.com"
    --allowed-ips="IP_ADDRESS"

Scopri di più su Google Cloud SDK , installazione di Cloud SDK e sui seguenti comandi:

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

Aggiunta della chiave API alla richiesta

Devi includere una chiave API in ogni richiesta API Address Validation. Nell'esempio seguente, sostituisci YOUR_API_KEY con la tua chiave API.

https://addressvalidation.googleapis.com/v1:validateAddress?key=YOUR_API_KEY

HTTPS è richiesto per le richieste che utilizzano una chiave API.

Nota: quando si utilizzano i servizi web, tutti i caratteri speciali all'interno dei parametri devono avere codifica URL. Gli URL devono essere codificati correttamente per essere validi e avere un limite di 2048 caratteri per tutti i servizi web. Tieni presente questo limite durante la creazione degli URL. Anche browser, proxy e server diversi possono avere limiti di caratteri URL diversi.