ArcGIS Online ve ArcGIS Location Platform’da eski (legacy) API anahtarından yeni yapıya geçiş rehberi

Bu rehber, uygulama veya komut dosyasında legacy API key kullananlar içindir. Yeni bir anahtar oluşturup uygulamanıza tanımlayarak mevcut servis erişimini sürdürebilirsiniz. Eski anahtarların tamamen devre dışı bırakılması ertelenmiş olsa da geçişinizi şimdiden tamamlamanız önemle önerilmektedir.

Başlamadan önce

Anahtarı oluşturan hesaba erişiminiz ve uygulamanın yapılandırmasını güncelleme yetkiniz olmalıdır. Aynı anahtarı kullanan web uygulamalarını, mobil uygulamaları ve zamanlanmış görevleri listeleyin. Düzenleme için uygulamayı geliştiren ekipten yardım almanız gerekebilir.

1. Hesabınızın portalına giriş yapın

   • ArcGIS Location Platform kullanıyorsanız location.arcgis.com adresinde oturum açın ve My portal seçeneğini açın. ArcGIS Online kullanıyorsanız kuruluş portalınıza giriş yapın.
   • ArcGIS Online’da API anahtarı oluşturmak için Creator veya üzeri kullanıcı türü ve uygun rol gerekir. Rolde Generate API keys ile Assign privileges to OAuth 2.0 applications ayrıcalıklarını kontrol edin. Location Platform hesapları API anahtarı yönetme yetkilerine varsayılan olarak sahiptir.

2. Eski anahtarın izinlerini kaydedin

   • Content → My content bölümünden API key (legacy) ögesini açın. Credentials bölümündeki Manage seçeneğinden Location services altındaki seçili servis kapsamlarını inceleyin. Uygulamanın eriştiği özel içerik ögeleri varsa bunları da not edin.
   • Örneğin uygulama harita görüntülüyor ve rota hesaplıyorsa her iki işlem için gereken izinleri yeni anahtara tanımlamanız gerekir. Haritanın açılması tek başına rota yetkisinin de doğru olduğunu göstermez.

3. Yeni kimlik bilgisi ögesini oluşturun

   • Content → My content → New item → Developer credentials → API key credentials yolunu izleyin. Create developer credentials penceresinde uygulamanızın kullanımına uygun uygulama ve türünü seçin.
   • API key credentials, anahtarın izinlerini ve yaşam döngüsünü yönettiğiniz ögedir. Uygulamaya ekleyeceğiniz API key değeri bu öge üzerinden üretilir.

4. İçerik ve servis erişimini belirleyin

   • Item access kısmında yalnızca gerekli ögelere erişim verin. Uygulamanız sadece konum servislerini kullanıyorsa ve özel bir ögeye erişim gerekmiyorsa No item access seçeneğini kullanabilirsiniz. Hassas veya gizli içerikler için Esri’nin önerdiği kullanıcı ya da uygulama kimlik doğrulaması yöntemlerini değerlendirin.
   • Privileges ekranında, kaydettiğiniz eski servis kapsamlarına karşılık gelen izinleri seçin. Online ve Location Platform’da sunulan izin adları ve ayrıntı düzeyi farklı olabilir. Hesap türünüze uygun olarak API key retirement dokümanındaki izin tablosunu kullanabilirsiniz.
     

5. Geçerlilik süresi ve erişim adreslerini ayarlayın

   • Expiration date alanında bir bitiş tarihi belirleyin. Yeni API anahtarlarının geçerlilik süresi en fazla bir yıldır. Kurumunuzun yenileme sürecine uygun süreyi seçin ve süre dolmadan yenileme yapacak kişiyi belirleyin.
   • Web uygulaması için Referrers alanını uygulamanın çalıştığı adreslere göre yapılandırın. Test ve üretim adreslerini ayrı ayrı doğrulayın. Komut dosyası veya mobil uygulamada bu ayarı kullanacaksanız istemcinin gönderdiği isteklerle uyumluluğunu kontrol edin.
     

6. Kaydedin ve anahtarı alın

   • Ögeye uygulamayı tanımlayan bir ad verin, açıklamasını yazın ve Summary ekranındaki izinleri kontrol edin. Generate API key adımında anahtarı üretin. Tam değer yalnızca bu aşamada görüntülenir. Güvenli bir yerde saklayın.
   • Uygulamanızın API anahtarı alanına üretilen anahtar değerini yazın. Öge kimliği (Item ID) bu alanda kullanılamaz.

7. Uygulamayı güncelleyin ve işlevlerini deneyin

   • Önce eğer mevcutsa test ortamında eski anahtar değerini yenisiyle değiştirin. Uygulamanın yapısına göre yapılandırmayı kaydetmeniz, yeniden derlemeniz veya yeniden dağıtmanız gerekebilir.

8. Eski anahtarı kaldırın ve yenilemeyi planlayın

   • Aynı anahtarı kullanan tüm uygulamalarda geçişi doğruladıktan sonra eski ögeyi açın.
     Settings → General → Delete Item yoluyla kaldırın. Mobil uygulamaların hâlâ kullanılan eski sürümleri gibi bağımlılıkları da bu kontrolde dikkate alın.
   • Yeni yapıda aynı kimlik bilgisi ögesinde iki anahtar kullanılabilir. Bir anahtarın süresi dolmadan diğerini üretip uygulamalarınıza dağıtarak yenilemeyi planlayabilirsiniz. Yeni değerle erişimi doğruladıktan sonra önceki anahtarı geçersiz kılın.

Bu adımlar hakkındaki ayrıntılara erişmek için aşağıdaki kaynakları ve uygulamalı rehberi inceleyebilirsiniz:

• Location Platform için geçiş tutorial’ı
• ArcGIS Online için geçiş tutorial’ı
• Hesap gereksinimleri ve API anahtarı kullanımı
• Eski servis kapsamlarının yeni izinlerle eşleştirilmesi