Sectigo sertifikaları, kurumsal tarafta Sectigo Certificate Manager (SCM) üzerinden, bayi tarafında ise çeşitli partner API'leri ile yönetilir. Entegrasyona başlamadan önce hangi hesap türüne sahip olduğunuzu netleştirmek gerekir, çünkü uç noktalar buna göre değişir.
SCM REST API'nin çalışma biçimi
SCM API'sinde kimlik bilgisi genellikle istek başlıklarında login, password ve customerUri alanlarıyla iletilir. Kayıt (enroll) işlemi, CSR ile birlikte sertifika türü ve geçerlilik süresini bildiren bir JSON gövdesiyle yapılır.
curl -X POST "https://cert-manager.com/api/ssl/v1/enroll" \
-H "login: $SCM_USER" \
-H "password: $SCM_PASS" \
-H "customerUri: $SCM_CUSTOMER" \
-H "Content-Type: application/json" \
-d '{"orgId": 1234, "csr": "...", "certType": 1, "term": 365}'Buradaki değerler örnektir; certType kimliği ve orgId hesabınıza özgüdür. Geçerli değerleri SCM arayüzünden veya API'nin tür listesi uç noktasından alın.
Entegrasyon adımları
- API için ayrı bir hesap/kullanıcı oluşturun ve yetkisini daraltın.
- Kuruluş (organization) ve alan adı doğrulamalarını önceden tamamlayın.
- Enroll isteği sonrası dönen sipariş kimliğini kaydedin.
- Durum "issued" olunca sertifikayı istenen biçimde (ör. X509 PEM) indirin.
Sık yapılan hatalar
- Doğrulanmamış alan adı için istek atmak, isteğin reddedilmesine yol açar.
- Parolayı kod içine gömmek; bunun yerine gizli değer yönetimi kullanın.
- Sertifika türü kimliğini başka bir hesaptan kopyalamak.
Sectigo ürünlerine göz atmak için SSL sertifikaları sayfasını, API entegrasyonu için bayi hesabı sorularınızda Türkçe teknik destek kanalını kullanabilirsiniz.
Güvenlik ve sürdürülebilirlik
API için kullanılan kullanıcıyı normal yönetici hesabından ayırın ve yalnızca gerekli organizasyon ve sertifika türleriyle yetkilendirin. Parolayı düzenli aralıklarla değiştirin ve değişimi betiklerinize yansıtmayı unutmayın. Sectigo tarafında yenileme ve yeniden yayınlama çağrıları da ayrı uç noktalardır; bunları kendi iş akışınıza eklerken sipariş kimliğini mutlaka saklayın.