Referanslar API'sinde kimlik doğrulaması

Makale
09/30/2024

Şunlar için geçerlidir: İş Ortağı Merkezi

Bu makalede, Referans API'lerine erişmek üzere kullanıcı ve uygulama belirteçleri oluşturmak üzere bir kullanıcı hesabının nasıl ayarlanacağı özetlemektedir. Ayrıntılı bilgi için bkz . İş Ortağı API'si kimlik doğrulaması.

Önkoşullar

Şu iş ortağı rollerinden en az birine sahip geçerli bir İş Ortağı Merkezi hesabı: Referans Yöneticisi veya Referans Kullanıcısı. Bkz. Referans rolleri ile İş Ortağı Merkezi hesabı oluşturma
Microsoft İş Ortağı temsilcisi eklenerek Azure portalından Microsoft Entra Id (Uygulama kaydı). Bkz . İstemci uygulamasını ayarlama (Microsoft Entra Id)

REST isteği

Belirteç oluşturmak için bu HTTP betiğini çalıştırın veya eşdeğer POST isteği oluşturun:

POST https://login.microsoftonline.com/common/oauth2/token HTTP/1.1
Accept: application/json
Content-Type: application/x-www-form-urlencoded

resource=https://api.partner.microsoft.com
&grant_type=password
&scope=openid
&client_id={client-ID-here}
&client_secret={client-secret-here}
&username={partner-account-upn-here}
&password={partner-account-password-here}

Örnek isteği

POST https://login.microsoftonline.com/common/oauth2/token HTTP/1.1
Accept: application/json
Content-Type: application/x-www-form-urlencoded

resource=https://api.partner.microsoft.com
&grant_type=password
&scope=openid
&client_id=00001111-aaaa-2222-bbbb-3333cccc4444
&client_secret=TestClientAppSecret23456
&username=john.doe@contoso.com
&password=PCTestPassword@123

REST yanıtı

Yanıt örneği

HTTP/1.1 200 OK
Cache-Control: no-cache, no-store
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Content-Length: 1406

{"token_type":"Bearer","expires_in":"3600","ext_expires_in":"3600","expires_on":"1546469802","not_before":"1546465902","resource":"https://api.partner.microsoft.com","access_token":"token-value-removed"}

Yeni kullanıcı adı/parola veya istemci kimliği oluşturma

Yeni kullanıcı adı/parola veya istemci kimliği (Microsoft Entra Id) oluşturmak için aşağıdaki adımları kullanın.

1. Adım: Referans rolleri ile İş Ortağı Merkezi hesabı oluşturma

bir yönetici hesabıyla İş Ortağı Merkezi'nde oturum açın ve Ayarlar (dişli) seçeneğini belirleyin.
Kullanıcı yönetimi'ni ve ardından Kullanıcı ekle düğmesini seçin. Açılan modal'dan Yeni kullanıcı oluştur'u seçin ve devam edin.
Kullanıcının FirstName, LastName, UserName ve isteğe bağlı olarak parola kurtarma e-postasını girin.
Referans Rolleri: Aynı sayfada aşağı gidin ve uygun referanslara özel iş ortağı rolleri atayın - Referans Yöneticisi, ReferansLar Kullanıcısı.
- Referanslar Yöneticisi , ilişkili tüm iş ortağı konumları için referans oluşturabilir, güncelleştirebilir ve okuyabilir.
- Referanslar Kullanıcı bu referansları yalnızca referansın ekibinde bulunduğu yerlerde okuyabilir.
Tüm kullanıcı ayrıntılarını ve rol atamasını tamamladıktan sonra Kaydet düğmesini seçin. Başarılı olduğunda yeni bir kullanıcı adı (kullanıcı e-postası veya upn) ve geçici bir parola oluşturulur.
Parolanızı sıfırlamak ve hesabınızı etkinleştirmek için bu kimlik bilgilerini kopyalayın ve İş Ortağı Merkezi'nde oturum açın.

2. Adım: İstemci uygulamasını ayarlama (Microsoft Entra Id)

Yönetici hesabıyla Azure portalında oturum açın.
"Uygulama kayıtları" araması yapın ve + Yeni kayıt düğmesini seçin.
Uygulama adını (İş Ortağı Merkezi Erişim Uygulaması gibi) ve Desteklenen hesap türünü "Tek Kiracı" olarak girin (veya gereksinimlerinize göre tercih edin).
Kaydet düğmesini seçin ve yeni Uygulama kaydı oluştururken bekleyin.
Uygulama kaydedildikten sonra istemci kimliğini bulun ve bu tanıtımda vurgulandığı gibi bir istemci gizli dizisi oluşturun:

Ardından, İş Ortağı Merkezi API belirteçleri oluşturmasını sağlamak için bu istemci uygulamasına bir API izni veya temsilci (Microsoft İş Ortağı) eklemeniz gerekir.
API izinlerini yönet'i>ve ardından +İzin ekle düğmesini seçin. Yan panelden kuruluşumun kullandığı API'ler sekmesini seçin.
"Microsoft İş Ortağı" API'sini arayın ve 4990c* ile başlayan uygulama (istemci) kimliğine sahip birini seçin. user_impersonation kutusunu işaretleyin ve İzin ekle düğmesini seçin.

İpucu

"Microsoft İş Ortağı" ile yapılan aramalar 4990c* uygulamasını bulamıyorsa, "Microsoft Geliştirme Merkezi" ile aramayı deneyin veya doğrudan tam Uygulama Kimliği ile arama yapın.
Son olarak, kullanıcının eklenen izin için yönetici onayı alması gerekir. Onay vermek için yöneticinin kendi hesabıyla oturum açması ve uygulamaya gitmeleri gerekir.

Aracılığıyla paylaş