Bu sayfada
> kaynaklar > belgeler > api > API anahtarları

API anahtarları

ProcessMind’de API anahtarı yönetimi

ProcessMind API ile entegrasyon için API anahtarları oluşturmanız ve yönetmeniz gerekir. API anahtarlarınızı nasıl oluşturacağınızı, kullanacağınızı ve koruyacağınızı öğrenin.

ProcessMind hesabınızın ayarlarında “API anahtarları” bölümüne gidin. Burada Yeni ortam API anahtarı düğmesine tıklayarak yeni bir API anahtarı oluşturabilirsiniz. Daha sonra tanıyabilmek için anahtara bir ad verin.

API anahtarı oluşturma

görsel

Farklı uygulamalar veya hizmetler için birden fazla API anahtarı oluşturabilirsiniz. Her anahtarı ayrı ayrı yönetebilir, diğer entegrasyonları etkilemeden gerektiğinde iptal edebilirsiniz. Anahtar oluşturulduktan sonra kopyalayıp güvenli bir yerde saklayın. Güvenlik nedeniyle anahtar yalnızca oluşturulurken bir kez gösterilir.

görsel

warning

API anahtarlarınızı güvenli tutun; istemci tarafındaki kodda veya herkese açık depolarda paylaşmayın. Bir anahtar ele geçirilirse hemen iptal edip yenisini oluşturun.

Kuruluş API anahtarları

Kuruluş yöneticileri aynı sayfada kuruluş API anahtarları da oluşturabilir. Ortam anahtarlarından farklı olarak kuruluş anahtarı, kuruluşun tüm ortamlarında (kiracılarında) çalışır; böylece tek bir entegrasyon hepsine hizmet verebilir. Kuruluş anahtarlarını şu amaçlarla kullanın:

  • Ortam API anahtarları oluşturun: Harici API (/v1/tenant/{tenantId}/api-keys) üzerinden kiracı kapsamındaki anahtarları oluşturun, güncelleyin ve silin.
  • Tek kullanımlık giriş bağlantıları oluşturun: Kullanıcıyı kendi ürününüzden doğrudan ProcessMind’e yönlendirin; kullanıcı oturumu açılmış olarak gelir (/v1/tenant/{tenantId}/users/{userId}/login-token).

Kapsamlar

Kapsam Verdiği izinler
read Kiracı verilerini okur (listeleme/alma uç noktaları). Varsayılan olarak açık.
write Kiracı verilerini oluşturur, günceller ve siler. Varsayılan olarak açık.
uploadData Veri tabloları için önceden imzalanmış yükleme URL’leri ister. Varsayılan olarak açık.
sessions Tek kullanımlık giriş devri belirteçleri oluşturur. Varsayılan olarak kapalı.

sessions kapsamını yalnızca giriş devri gereken anahtarlarda etkinleştirin ve bu anahtarları parola gibi koruyun: oluşturulan belirteç, kullanıcıyı parola istemeden oturum açmış duruma getirir. Kuruluş anahtarı, kuruluştaki tüm ortamların kullanıcıları için belirteç oluşturabilir; ortam anahtarı ise yalnızca kendi ortamındaki kullanıcılar için belirteç oluşturabilir.

Tek kullanımlık giriş devri

POST /v1/tenant/{tenantId}/users/{userId}/login-token, kullanıcıya, ortama ve kuruluşa bağlı, 60 saniye geçerli tek kullanımlık bir belirteç ve bir url döndürür. Kullanıcının tarayıcısını bu URL’ye yönlendirin; kullanıcı kendi oturumuyla ProcessMind’e girer. E-posta bağlantısı gönderilmez ve başka bir kullanıcı gibi oturum açılmaz. İsteğe bağlı olarak, belirli bir sayfaya doğrudan gitmek için istek gövdesine path ekleyin. Anahtarda sessions kapsamı bulunmalıdır. Ayrıca, yalnızca anahtarın erişebildiği bir kiracıdaki kullanıcı için belirteç oluşturabilirsiniz.

Belirteç oluşturma işlemleri denetlenir ve sıkı hız sınırlarına tabidir. Anahtar devre dışı bırakıldığında veya kullanıcı erişimini kaybettiğinde işlem hemen engellenir. Belirteç yalnızca bir kez döndürülür ve hiçbir zaman günlüğe kaydedilmez.

İlgili konular

İlgili dokümantasyon

Süreçlerinizi daha iyi tasarlayın. Bağlantılı bir mimari kurun. Kontrolü elinizde tutun.

Kredi kartı gerekmeden, beklemeden hemen erişin. Kuruluşunuzdaki çalışma biçimini net ve birbiriyle bağlantılı süreç tasarımlarına dönüştürün.

Süreç mimarinizi oluşturun, sahiplik ve kontrolleri tanımlayın; rol ve sorumlulukları her düzeyde uyumlu hâle getirin.

Ücretsiz denemeyi başlatın; süreçlerinizi yönetmek ve sürekli iyileştirmek için güvenilir bir temel oluşturun.

Ücretsiz denemeyi başlatın