Google Haritalar Platformu ürünleri, API çağrılarının uygun kimlik doğrulama kimlik bilgilerini sağlayanlarla kısıtlanmasıyla yetkisiz kullanıma karşı korunur. Bu kimlik bilgileri, API anahtarı (Google faturalandırma hesabınızı projenizle ve belirli bir API veya SDK ile ilişkilendiren benzersiz bir alfanümerik dize) biçimindedir.
Bu kılavuzda, Google Haritalar Platformu için API anahtarınızı nasıl oluşturacağınız, kısıtlayacağınız ve kullanacağınız gösterilmektedir.
API anahtarları oluşturma
API anahtarı, kullanım ve faturalandırma amacıyla projenizle ilişkili isteklerin kimliğini doğrulayan benzersiz bir tanımlayıcıdır. Projenizle ilişkilendirilmiş en az bir API anahtarınız olmalıdır.
API anahtarı oluşturmak için:
Konsol
-
Google Haritalar Platformu > Kimlik Bilgileri sayfasına gidin.
-
Kimlik bilgileri sayfasında Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
API anahtarı oluşturuldu iletişim kutusunda yeni oluşturulan API anahtarınız gösterilir. -
Kapat'ı tıklayın.
Yeni API anahtarı, Kimlik bilgileri sayfasında API anahtarları'nın altında listelenmiştir.
(API anahtarını üretimde kullanmadan önce kısıtlamayı unutmayın.)
Google Cloud SDK
gcloud alpha services api-keys create \
--project "PROJECT" \
--display-name "DISPLAY_NAME"
Google Cloud SDK, Google Cloud SDK kurulumu ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:
API anahtarlarını kısıtlama
Google, API anahtarlarınızın kullanımını yalnızca uygulamanız için gereken API'lerle sınırlandırarak API anahtarlarınızı kısıtlamanızı önemle tavsiye eder. API anahtarlarını kısıtlamak, uygulamanızı istenmeyen isteklerden koruyarak güvenliği artırır. Daha fazla bilgi edinmek için API güvenliğiyle ilgili en iyi uygulamaları inceleyin.
Bir API anahtarını kısıtlamak için:
Konsol
-
Google Haritalar Platformu > Kimlik Bilgileri sayfasına gidin.
- Kısıtlama ayarlamak istediğiniz API anahtarını seçin. API anahtarı mülkü sayfası görüntülenir.
- Anahtar kısıtlamaları bölümünde aşağıdaki kısıtlamaları ayarlayın:
- Uygulama kısıtlamaları:
- Sağladığınız web sunucusu IP adresleri listesinden gelen istekleri kabul etmek için Uygulama kısıtlamaları listesinden IP adresleri (web sunucuları, cron işleri vb.) seçeneğini belirleyin. CIDR gösterimini kullanarak bir veya daha fazla IPv4 veya IPv6 adresi ya da alt ağ belirtin. IP adresleri, Google Haritalar Platformu sunucularının gözlemlediği kaynak adresiyle eşleşmelidir. Ağ adresi dönüştürme (NAT) kullanırsanız bu genellikle makinenizin herkese açık IP adresine karşılık gelir.
- API kısıtlamaları:
- Anahtarı kısıtla'yı tıklayın.
- Select APIs (API'leri seç) açılır listesinden Address Validation API'yi (Adres Doğrulama API'si) seçin. Address Validation API listede yoksa enable gerekir.
- Değişikliklerinizi tamamlamak için Kaydet'i tıklayın.
Google Cloud SDK
Mevcut anahtarları listeleme.
gcloud services api-keys list --project="PROJECT"
Mevcut anahtardaki mevcut kısıtlamaları temizleyin.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--clear-restrictions
Mevcut anahtarda yeni kısıtlamalar belirleyin.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--api-target="addressvalidation.googleapis.com"
--allowed-ips="IP_ADDRESS"
Google Cloud SDK, Google Cloud SDK kurulumu ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:
İsteğinize API anahtarını ekleme
Her Address Validation API isteğine bir API anahtarı eklemeniz gerekir. Aşağıdaki örnekte YOUR_API_KEY değerini API anahtarınızla değiştirin.
https://addressvalidation.googleapis.com/v1:validateAddress?key=YOUR_API_KEY
API anahtarı kullanan istekler için HTTPS gereklidir.