Google Haritalar Platformu ürünleri, API çağrılarını uygun kimlik doğrulama bilgileri sağlayanlarla kısıtlayarak yetkisiz kullanıma karşı güvenlik sağlar. Bu kimlik bilgileri, Google faturalandırma hesabınızı projenizle ve belirli API veya SDK ile ilişkilendiren benzersiz bir alfanümerik dize olan API anahtarı biçimindedir.
Google Haritalar Platformu için API anahtarınızı nasıl oluşturacağınızı, kısıtlayacağınızı ve kullanacağınızı öğrenin.
Başlamadan önce
Directions API'yi (Eski) kullanmaya başlamadan önce faturalandırma hesabı olan ve Directions API'nin (Eski) etkinleştirildiği bir projeniz olmalıdır. Daha fazla bilgi için Cloud Console'da kurulum başlıklı makaleyi inceleyin.
API anahtarı 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şkili 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şturduğunuz API anahtarı gösterilir. -
Kapat'ı tıklayın.
Yeni API anahtarı, Kimlik bilgileri sayfasındaki API anahtarları bölümünde listelenir.
(Üretimde kullanmadan önce API anahtarını kısıtlamayı unutmayın.)
Google Cloud SDK
gcloud services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
Google Cloud SDK, Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:
API anahtarlarını kısıtlama
Google, API anahtarlarınızı yalnızca uygulamanız için gereken API'lerle sınırlayarak kısıtlamanızı önemle tavsiye eder. API anahtarlarını kısıtlamak, uygulamanızı istenmeyen isteklere karşı koruyarak güvenliğini artırır. Kısıtlanmamış API anahtarlarının kötüye kullanımından kaynaklanan ücretlerden mali olarak siz sorumlu olursunuz. Daha fazla bilgi için API güvenliğiyle ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.
API anahtarını kısıtlamak için:
Konsol
-
Google Haritalar Platformu > Kimlik bilgileri sayfasına gidin.
- Kısıtlama uygulamak istediğiniz API anahtarını seçin. API anahtarı özellik sayfası görünür.
- 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 ya da IPv6 adresi veya alt ağ belirtin. IP adresleri, Google Haritalar Platformu sunucularının gözlemlediği kaynak adresle eşleşmelidir. Ağ adresi çevirisi (NAT) kullanıyorsanız bu genellikle makinenizin genel IP adresine karşılık gelir.
- API kısıtlamaları:
- Anahtarı kısıtla'yı tıklayın.
- API'leri seçin açılır listesinden Directions API (Eski) seçeneğini belirleyin. Directions API (Eski) listede yoksa etkinleştirmeniz 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 services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
Mevcut anahtarda yeni kısıtlamalar ayarlayın.
gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \ --api-target=service=directions-backend.googleapis.com --allowed-ips="IP_ADDRESS"
Google Cloud SDK, Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:
API anahtarını isteğinize ekleme
Her Directions API (Eski) isteğine bir API anahtarı eklemeniz gerekir. Aşağıdaki örnekte YOUR_API_KEY kısmını API anahtarınızla değiştirin:
https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY
API anahtarı kullanan istekler için HTTPS kullanmanız gerekir.