Kimlik doğrulama

Bir Meshy hesabı ve bir API anahtarı oluşturun, ardından her istekte bu anahtarı gönderin.

API anahtarları

Bir Meshy hesabı oluşturun

API anahtarları oluşturmak ve yönetmek için bir Meshy hesabına ihtiyacınız vardır. API anahtarı olmayan bir istek 401 Unauthorized döndürür.

Bir hesap oluşturmak için Meshy web sitesine kaydolun.

Bir API anahtarı oluşturun

Hesabınızı oluşturduktan sonra, Geliştirici Platformu'nun API Anahtarları sayfasında API anahtarları oluşturabilirsiniz.

Farklı amaçlar için birden fazla API anahtarı oluşturabilirsiniz; örneğin biri iOS uygulamanız, diğeri ise web uygulamanız için. Meshy her anahtarın kullanımını ayrı ayrı izler ve bir anahtarı istediğiniz zaman iptal edebilirsiniz.

Ayrıca herhangi bir anahtar için aylık bir kredi sınırı da belirleyebilirsiniz. Bu sınır, hesabınızın genel kullanımı ne olursa olsun, ilgili anahtarın harcayabileceği miktarı sınırlar. Örneğin, bunu bir yükleniciye verdiğiniz veya tek bir ortamda kullandığınız bir anahtar için kullanabilirsiniz.

Bir API anahtarı oluşturmak için şu adımları izleyin:

1. API Anahtarları sayfasında API Anahtarı Oluştur'a tıklayın.
2. Ad alanına anahtar için bir ad girin.
3. İsteğe bağlı: Aylık kredi sınırı (isteğe bağlı) alanına anahtarın her ay harcayabileceği en fazla kredi miktarını girin.
4. Oluştur'a tıklayın.
5. Anahtarı kopyalayın ve güvenli bir yerde saklayın. İletişim kutusunu kapattıktan sonra anahtarı tekrar görüntüleyemezsiniz.

Bir API anahtarı kullanın

API anahtarını her isteğin Authorization başlığında, bir Bearer belirteci olarak gönderin:

{
  "Authorization": "Bearer msy_sOmEbOgUsApIkEyFoReXaMpLe1234567890"
}

Başlık değerindeki Bearer ön eki zorunludur. Taşıyıcı (bearer) belirteçleri hakkında daha fazla bilgi için bkz. RFC 6750.

Bir anahtarı IP adresleriyle kısıtlayın

Bir IP izin listesi, bir API anahtarını isteklerinizin geldiği adreslerle, örneğin sunucularınızın genel çıkış adresleriyle sınırlar. Meshy daha sonra anahtarı başka herhangi bir adresten reddeder, böylece kopyalanmış bir anahtar çok daha az işe yarar. İzin listesi olmayan bir anahtar her adresten çalışır.

Bir takımın anahtarları için izin listesini yalnızca takım yöneticileri değiştirebilir. CLI anahtarlarının izin listesi yoktur.

Bir izin listesi ayarlamak için şu adımları izleyin:

1. API Anahtarları sayfasında anahtarın menüsünü açın ve IP izin listesini yönet'e tıklayın.
2. Her adresi veya aralığı ekleyin. İsteğe bağlı: her birine office NAT gibi bir ad verin.
3. İsteğe bağlı: listenin son 7 gündeki anahtar isteklerinin kaçını engellemiş olacağını görmek için Etkiyi kontrol et'e tıklayın.
4. Listeyi kaydedin.

Her girdi, 203.0.113.5 gibi tek bir IPv4 veya IPv6 adresi ya da 203.0.113.0/24 gibi bir CIDR blokudur. Liste şu kurallara uyar:

• Bir anahtar en fazla 50 girdiye sahip olabilir ve bir ad en fazla 60 karakter olabilir.
• Bir girdi genel (public) bir adres olmalıdır. Meshy, 10.0.0.0/8 veya 127.0.0.1 gibi özel, loopback ve link-local adresleri reddeder, çünkü bu adreslerden API'ye hiçbir istek ulaşmaz. Trafiğinizin çıktığı genel adresi kullanın.
• Bir girdi 0.0.0.0/0 gibi her adrese izin veremez. Herhangi bir adresi kabul etmek için izin listesini kaldırın.
• Meshy bir CIDR blokunu ağ adresi olarak kaydeder. Örneğin, 203.0.113.5/24, Meshy'nin uyguladığı aralık olan 203.0.113.0/24 olarak kaydedilir.

İletişim kutusu ayrıca son 7 günde anahtarı kullanan adresleri de listeler, böylece bunları doğrudan ekleyebilirsiniz. Yoğun kullanılan bir anahtar için Meshy adresleri örnekler, bu nedenle liste her birini göstermeyebilir.

Değişiklikler bir sonraki istekte, en fazla bir dakika içinde uygulanır. Bir izin listesini kaldırdıktan sonra, herhangi bir adres bir dakika içinde anahtarı yeniden kullanabilir.

İzin listesi dışındaki bir adresten gelen istek, ip_not_authorized hata koduyla birlikte 403 Forbidden döndürür. Hata mesajı reddedilen adresi belirtir, böylece sizinse ekleyebilirsiniz. Reddedilen bir istek kredi kullanmaz ve hız sınırlarınıza dahil edilmez.

Güvenlik

Verilerinizi ve isteklerinizi güvende tutmak için takımınızın kendi güvenlik uygulamalarıyla birlikte şu yönergeleri izleyin.

Taşıma Katmanı Güvenliği

Meshy, verilerinizi beklemede (at rest) şifreler ve Meshy API, aktarım sırasındaki verileri şifrelemek için TLS kullanır. API'ye ve API'den gelen tüm istekler HTTPS üzerinden geçer ve HTTP üzerinden gelen bir istek 301 Moved Permanently alır.

Mümkün olduğunda HTTP'den kaçının. HTTP üzerinden bir istek göndermeniz gerekiyorsa, HTTP istemcinize HTTPS'e yönlendirmeyi takip etmesini söyleyin. Aşağıdaki örnekler bunun nasıl yapılacağını gösterir:

# use `-L` to follow HTTP to HTTPS redirections
curl -L https://api.meshy.ai/openapi/v1/balance \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Yönlendirmeler yalnızca GET istekleri için çalışır. HTTP istemcileri, yönlendirilmiş bir POST isteğini gövdesi olmadan bir GET olarak yeniden gönderir, bu nedenle görev oluşturmak için her zaman doğrudan https:// adresini çağırın.

API anahtarı güvenliği

Bir API anahtarı oluşturduktan sonra, Geliştirici Platformu bunu bir daha göstermez. Güvenli bir yerde saklayın, çünkü anahtara sahip olan herkes Meshy API'yi siz gibi çağırabilir. Meshy takım üyeleri de sizin için iptal edilmiş bir anahtarı görüntüleyemez veya geri alamaz.

Başka birinin anahtarınıza sahip olduğunu düşünüyorsanız, API Anahtarları sayfasında anahtarı iptal edin. İptal edilmiş bir anahtar artık çalışmaz.

Bir IP izin listesi, sızdırılmış bir anahtarı çok daha az işe yarar hale getirir, ancak anahtarı iptal etmenin yerini tutmaz. Bir anahtar sızarsa, onu iptal edin ve yeni bir tane oluşturun.

Güvenlik bildirimi

Meshy API'de bir güvenlik sorunu bulursanız, Meshy destek ekibiyle iletişime geçin. Meshy, sorumlu bildirimi takdir eder ve katkınızı tanımak için elinden gelen her çabayı gösterir.