İş Ortağı Merkezi’nde API erişimini ayarlama

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Bu makalede, İş Ortağı Merkezi SDK'sına karşı geliştirmeniz gereken hesaplar açıklanmaktadır. Bu makalede ayrıca tümleştirme korumalı alanı hesabı oluşturma ve tümleştirme korumalı alanında test etme adımları açıklanmaktadır.

Not

API'lere erişim elde etmek için kiracınızın bir CSP kiracısı ve dolaylı bir sağlayıcı veya Doğrudan fatura iş ortağı olmanız gerekir.

Hesap tanımları

API tümleştirmenizi tümleştirmenize ve test etmeye yardımcı olmak için İş Ortağı Merkezi iki tür hesabı destekler:

Birincil İş Ortağı hesabı

Bu hesap, gerçek müşteriler için gerçek siparişler oluşturduğunuz yerdir. Birincil hesapta oturum açtığınızda İş Ortağı Merkezi SDK'sını veya İş Ortağı Panosu kullanıcı arabirimini kullanarak herhangi bir değişiklik veya işlem yaparsanız, bunlar gerçek müşteriler için resmi siparişler olarak değerlendirilir. Bunlar faturanıza yansıtılır ve bunların ödemesini şirketiniz yapar.

Tümleştirme korumalı alanı hesabı

Bu hesap, kodunuzu ve kapsamlı olarak dağıtmadan önce İş Ortağı Merkezi API'leriyle tümleştirmesini test etme amaçlıdır. Tümleştirme korumalı alanı hesabında oturum açtığınızda yaptığınız değişiklikler ve işlemler faturanızda görünür, ancak fatura tutarını ödemeniz gerekmez. Fatura pdf'sinde "ÖDEME YAPMAYIN. BU BIR KORUMALı ALAN FATURASıDıR VE EYLEM GEREKMEZ."

Tümleştirme korumalı alanı hesabı ve birincil hesap bağımsız olarak çalışır ve yönetici hesaplarını, kullanıcı hesaplarını, müşterileri, siparişleri, abonelikleri veya diğer verileri paylaşmaz.

Tümleştirme korumalı alanı sınırlı sayıda müşteri, sipariş, abonelik, lisans vb. içeren işlemleri destekler.

İlkeye göre, tümleştirme korumalı alanı hesapları yalnızca tümleştirme testi amaçlıdır.

Varsayılan olarak tümleştirme korumalı alan hesabı yoktur. İş Ortağı Merkezi SDK'sını kullanmayı planlıyorsanız kendiniz oluşturmanız gerekir.

Hesaplarınızı ayarlama

Bu bölümde, İş Ortağı Merkezi SDK'sı için birincil İş Ortağı hesabı ve tümleştirme korumalı alanı hesabının nasıl ayarlanacağı açıklanmaktadır.

Tümleştirme korumalı alanı oluşturma

  1. Genel yönetici hesabıyla İş Ortağı Merkezi'nde oturum açın ve Ayarlar (dişli) seçeneğini belirleyin.

    Not

    Korumalı Alan oluşturmak için iş ortağı Genel Yönetici onmicrosoft.com etki alanı diğer adıyla (örneğin) alias@domain.onmicrosoft.comİş Ortağı Merkezi'ne oturum açması gerekir. Kullanıcı kendi özel etki alanıyla oturum açtığında korumalı alan oluşturma başarısız olur.

  2. Hesap ayarları'nı ve ardından Tümleştirme korumalı alanı'nı seçin.

    Not

    Tümleştirme korumalı alanı seçeneğini görmüyorsanız genel yönetici hesabınız olmayabilir. Ayrıca bir tümleştirme korumalı alanı hesabı kullanıyor olabilirsiniz ve bir tümleştirme korumalı alanı zaten ayarlanmıştır.

  3. Tümleştirme korumalı alanı yönetici hesabının iletişim bilgilerini girin. Ardından Hesap oluştur'u seçin. Hesabın oluşturulduğunu belirten bir onay iletisi için birkaç dakika bekleyin.

  4. Onay iletisini gördükten sonra İş Ortağı Panosu'nun oturumunu kapatın.

  5. Yeni tümleştirme korumalı alanı yönetici hesabınızla yeniden oturum açın. Kimlik bilgileriniz için username@domain biçimini ve belirttiğiniz parolayı kullandığınızdan emin olun.

  6. Korumalı alan hesabı kurulumunu tamamlamak için Tümleştirme Korumalı Alanı sayfasında Hesap ayarla'yı seçin.

API erişimini etkinleştirme

Hesabınız ayarlandıktan sonra, İş Ortağı Merkezi SDK'sını tümleştirme korumalı alanıyla kullanabilmek için öncelikle API erişimini etkinleştirmeniz gerekir. Hem birincil İş Ortağı hesabınız hem de tümleştirme korumalı alanı hesabınız için API erişimini ayrı ayrı etkinleştirmelisiniz.

  1. Genel yönetici hesabıyla İş Ortağı Merkezi'nde oturum açın ve Ayarlar (dişli) seçeneğini belirleyin.

  2. Hesap ayarları'nı ve ardından Uygulama yönetimi'yi seçin.

  3. Henüz bir uygulamanız yoksa yeni bir web uygulaması ekleyin. Mevcut bir web uygulamanız varsa, Anahtar ekle düğmesini seçin.

  4. Uygulama kayıt bilgilerini, özellikle de web uygulaması oluşturuyorsanız Anahtar'ı kopyalayın ve güvenli bir yerde saklayın.

  5. İş Ortağı Panosu'nun oturumunu kapatın.

  6. Tümleştirme korumalı alanı hesabınızla yeniden oturum açın. Tümleştirme korumalı alanında API erişimini etkinleştirmek için 2-5 arası adımları yineleyin.

Kod yazma ve test

Tümleştirme korumalı alanında kod yazabilir ve kodu test edebilirsiniz. Microsoft Entra Id ile İş Ortağı Merkezi kimlik doğrulamasını ayarlamak için aşağıdaki bilgilere ihtiyacınız olacaktır.

Madde adı Öğe konumu
Uygulama Kimliği / İstemci Kimliği Ayarlar (dişli) bölümünden Hesap ayarları'nı ve ardından Uygulama Yönetimi'yi seçin. Uygulama Kimliği/İstemci Kimliği, Kayıtlı uygulama Uygulama Kimliği olarak listelenir.
Tuş API erişimini etkinleştirme bölümünde bir web uygulaması oluşturduysanız, 5. adımda kaydettiğiniz anahtar budur.
Domain Tümleştirme korumalı alanının etki alanı.

Test edilmiş kodu çalıştırma

Çözümünüzü gerçek müşteri verileriyle kullanmak için tümleştirme korumalı alanı kimlik bilgilerinizi birincil İş Ortağı hesabı kimlik bilgilerinize değiştirmeniz gerekir.

Test edilen kodunuzu birincil İş Ortağı hesabınızda kullanmaya hazır olduğunuzda bir Microsoft Entra güvenlik belirteci almanız gerekir. Bu güvenlik belirteci İş Ortağı Merkezi uygulamanızı, anahtarınızı ve etki alanınızı temel alır (tümleştirme korumalı alanı uygulamanız, anahtarınız ve etki alanınız yerine).

  1. Birincil İş Ortağı Merkezi kimlik bilgilerinizi kullanarak bir Microsoft Entra güvenlik belirteci almak için İş Ortağı Merkezi kimlik doğrulamasındaki adımları izleyin. (Daha önce tümleştirme korumalı alanınız için bir Microsoft Entra güvenlik belirteci almak için bu adımları izlemiştiniz.)

  2. Kodunuzdaki tümleştirme güvenlik belirtecini birincil İş Ortağı hesabınızın yeni güvenlik belirteciyle değiştirin.