API anahtarları
Amaç
API anahtarları, oyununuzun sunucusunun Open Play’e kimliğini kanıtlamasını sağlar. Bu sayfa seçili oyunun ve ortamın anahtarlarını listeler; yeni anahtar oluşturmanızı, süresini ve durumunu yönetmenizi sağlar. Sayfa, Oyun ayarları içindeki API anahtarları sekmesidir.
Ne zaman kullanılır
- Oyun sunucunuzu Open Play’e ilk kez bağlarken.
- Bir anahtar sızdıysa ya da artık gerekmiyorsa iptal etmek için.
- Anahtarın süresini uzatmak ya da adını değiştirmek için.
Adım adım
Yeni anahtar oluşturma
- Üstteki ortam seçicisinden anahtarın çalışacağı oyunu ve ortamı seçin.
- Anahtar oluştur düğmesine basın. Düğmeyi yalnızca anahtar yazma yetkisi olan yöneticiler görür.
- Anahtara bir ad verin ve Anahtar türü seçin: oyun sunucunuz için Sunucu anahtarı, oyun istemcisi için İstemci anahtarı.
- Geçerlilik bölümünden bir süre seçin. Emin değilseniz 90 gün gibi bir süre seçip düzenli yenilemek daha güvenlidir.
- Not alanına kısa bir gerekçe yazın.
- Anahtarı oluştur düğmesine basın.
- Sayfada görünen gizli değeri hemen kopyalayıp güvenli bir yere kaydedin.
Uyarı
Gizli değer yalnızca oluşturulurken bir kez gösterilir; sonradan görüntülenemez. Kaybederseniz anahtarı yenilemeniz (rotate) gerekir.
Anahtarı kullanma
Oyun sunucunuz anahtarı her istekte Authorization başlığıyla gönderir:
curl https://<sunucu-adresiniz>/v1/<uç-nokta> \
-H "Authorization: Bearer crx_live_<önek>_<gizli>"
Yer tutucuları kendi değerlerinizle değiştirin. Gerçek anahtarı kaynak koduna ya da oyun istemcisine yazmayın.
Anahtarı düzenleme, yenileme ve iptal etme
- Listeden anahtarın satırına tıklayarak ayrıntı sayfasını açın.
- Düzenle ile adı, süreyi ve notları değiştirin; gizli değer değişmez.
- Rotate (yenile) eski gizli değeri iptal eder ve yeni değeri bir kez gösterir.
- Devre dışı bırak anahtarı geçici durdurur, Etkinleştir geri açar; Revoke (iptal) kalıcıdır.
Alanlar ve seçenekler
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Anahtar adı | Evet | Listede tanımak için ad; en az 2 karakter |
| Anahtar türü | Evet | Sunucu (gizli) ya da istemci (oyuna gömülebilir) |
| Geçerlilik | Evet | Süresiz, 30 gün, 90 gün, 1 yıl ya da özel tarih; düzenlemede ayrıca “Değiştirme” |
| Not | Evet | İşlem geçmişine yazılan gerekçe, 8-500 karakter |
| Anahtarın sahibi | Hayır | Varsayılan “Bu ortam”; “Gelişmiş ayarlar” içindedir |
| Sahip oyuncu / organizasyon | Sahip türüne bağlı | Sahibi seçtiğinizde zorunludur |
| Kapsam etiketleri | Hayır | Yalnızca not amaçlı etiketler |
| İzinler | Hayır | Ad-değer notları; erişimi kısıtlamaz |
| Ek bilgiler | Hayır | Ad-değer notları; erişimi kısıtlamaz |
Not
Kapsam etiketleri, izinler ve ek bilgiler şimdilik yalnızca kayıt amaçlıdır. Anahtarın neye erişebileceğini anahtar türü (sunucu ya da istemci) belirler.
Sık karşılaşılan durumlar
| Durum | Ne yapmalı |
|---|---|
| Gizli değeri kaybettim | Anahtarı Rotate ile yenileyin; yeni değeri kaydedin ve sunucunuzda güncelleyin. |
| Anahtar bir gün çalışmayı bıraktı | Süresi dolmuş, devre dışı bırakılmış ya da iptal edilmiş olabilir; ayrıntı sayfasından durumunu ve bitiş tarihini kontrol edin. |
| “Anahtar oluştur” düğmesi yok | Rolünüzde anahtar yazma yetkisi yoktur; bir yöneticiden isteyin. |
| Sunucu anahtarı istemciye gömüldü | Anahtarı hemen iptal edin, yenisini oluşturun ve yalnızca sunucuda kullanın. |