Müşteri için kullanıcı rolleri ayarlama

Makale
03/06/2024

Müşteri hesabı içinde bir dizi dizin rolü vardır. Bu rollere kullanıcı hesapları atayabilirsiniz.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde Müşteriler çalışma alanını, ardından müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek bunu arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği'ni arayın. Microsoft Kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.

GDAP rolleri

Aşağıdaki GDAP rolüne ihtiyacınız vardır:

Ayrıcalıklı Rol Yöneticisi

C#

Bir müşteri kullanıcısına dizin rolü atamak için, ilgili kullanıcı ayrıntılarıyla yeni bir UserMember oluşturun. Ardından, müşteriyi tanımlamak için belirtilen müşteri kimliğiyle IAggregatePartner.Customers.ById yöntemini çağırın. Burada, rolü belirtmek için dizin rol kimliğiyle DirectoryRoles.ById yöntemini kullanın. Ardından UserMembers koleksiyonuna erişin ve Create yöntemini kullanarak yeni kullanıcı üyesini bu role atanan kullanıcı üyeleri koleksiyonuna ekleyin.

// UserMember createdUser;
// IAggregatePartner partnerOperations;
// Customer selectedCustomer;
// IDirectoryRole selectedRole;

// Create the new user member.
UserMember userMemberToAdd = new UserMember()
{
    UserPrincipalName = createdUser.UserPrincipalName,
    DisplayName = createdUser.DisplayName,
    Id = createdUser.Id
};

// Add the new user member to the role.
var userMemberAdded = partnerOperations.Customers.ById(selectedCustomer.Id).DirectoryRoles.ById(selectedRole.Id).UserMembers.Create(userMemberToAdd);

Örnek: Konsol test uygulaması. Proje: İş Ortağı Merkezi SDK Örnekleri Sınıfı: AddUserMemberToDirectoryRole.cs

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
POST	{baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers HTTP/1.1

URI parametresi

Doğru müşteriyi ve rolü tanımlamak için aşağıdaki URI parametrelerini kullanın. Rolün atandığı kullanıcıyı tanımlamak için, istek gövdesinde tanımlayıcı bilgileri sağlayın.

Ad	Tür	Zorunlu	Açıklama
customer-tenant-id	Guıd	Y	Değer, kurumsal bayinin kurumsal bayiye ait belirli bir müşterinin sonuçlarını filtrelemesine olanak tanıyan GUID biçimli müşteri kiracı kimliğidir .
rol kimliği	Guıd	Y	Değer, kullanıcıya atanacak rolü tanımlayan GUID biçimli bir rol kimliğidir .

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

Request body

Bu tablo, istek gövdesindeki gerekli özellikleri açıklar.

Ad	Tür	Zorunlu	Açıklama
Kimlik	string	Y	Role eklenecek kullanıcının kimliği.
DisplayName	string	Y	Kullanıcının kolay görünen adı.
UserPrincipalName	string	Y	Kullanıcı sorumlusunun adı.
Öznitelikler	object	Y	"ObjectType":"UserMember" içerir

İstek örneği

POST https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/directoryroles/f023fd81-a637-4b56-95fd-791ac0226033/usermembers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: a56cb2e5-a156-4f68-9155-57ffe2b93d18
MS-CorrelationId: 90bda268-7929-4ad6-be01-89c5af5fc504
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 180
Expect: 100-continue

{
    "Id": "a9ef48bb-8758-4590-a312-d4a47bfaded4",
    "DisplayName": "Daniel Tsai",
    "UserPrincipalName": "Daniel@dtdemocspcustomer005.onmicrosoft.com",
    "Attributes": {
        "ObjectType": "UserMember"
    }
}

REST yanıtı

Bu yöntem, kullanıcıya rol başarıyla atandığında rol kimliğinin eklendiği kullanıcı hesabını döndürür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST hata kodları.

Yanıt örneği

HTTP/1.1 201 Created
Content-Length: 231
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 90bda268-7929-4ad6-be01-89c5af5fc504
MS-RequestId: a56cb2e5-a156-4f68-9155-57ffe2b93d18
MS-CV: aia94+gnrEeQqkGr.0
MS-ServerId: 101112202
Date: Tue, 20 Dec 2016 23:36:55 GMT

{
    "displayName": "Daniel Tsai",
    "userPrincipalName": "Daniel@dtdemocspcustomer005.onmicrosoft.com",
    "roleId": "f023fd81-a637-4b56-95fd-791ac0226033",
    "id": "a9ef48bb-8758-4590-a312-d4a47bfaded4",
    "attributes": {
        "objectType": "UserMember"
    }
}

Aracılığıyla paylaş