Nastavení uživatelských rolí pro zákazníka
V rámci účtu zákazníka existuje sada rolí adresáře. K těmto rolím můžete přiřadit uživatelské účty.
Požadavky
Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze s přihlašovacími údaji aplikace a uživatele.
ID zákazníka (
customer-tenant-id
). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id
).
Role GDAP
Budete potřebovat následující roli GDAP:
- Správce privilegovaných rolí
C#
Pokud chcete přiřadit roli adresáře uživateli zákazníka, vytvořte nový UserMember s příslušnými podrobnostmi o uživateli. Potom zavolejte metodu IAggregatePartner.Customers.ById se zadaným ID zákazníka k identifikaci zákazníka. Odtud použijte metodu DirectoryRoles.ById s ID role adresáře k určení role. Pak přejděte k kolekci UserMembers a pomocí metody Create přidejte nového člena uživatele do kolekce členů uživatelů přiřazených k této roli.
// 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);
Ukázka: Konzolová testovací aplikace Projekt: Ukázky sady SDK v Partnerském centru – třída: AddUserMemberToDirectoryRole.cs
Požadavek REST
Syntaxe požadavku
Metoda | Identifikátor URI žádosti |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers HTTP/1.1 |
Parametr identifikátoru URI
Pomocí následujících parametrů identifikátoru URI identifikujte správného zákazníka a roli. Pokud chcete identifikovat uživatele, kterému má role přiřadit, zadejte identifikační informace v textu požadavku.
Jméno | Typ | Požadováno | Popis |
---|---|---|---|
customer-tenant-id | Identifikátor guid | Y | Hodnota je GUID formátované ID tenanta zákazníka, které umožňuje prodejci filtrovat výsledky pro daného zákazníka, který patří k prodejci. |
ID role | Identifikátor guid | Y | Hodnota je IDENTIFIKÁTOR GUID formátovaný ID role, který identifikuje roli, kterou má uživatel přiřadit. |
Záhlaví žádosti
Další informace najdete v tématu Hlavičky REST Partnerského centra.
Text požadavku
Tato tabulka popisuje požadované vlastnosti v textu požadavku.
Jméno | Typ | Požadováno | Popis |
---|---|---|---|
Id | string | Y | ID uživatele, který chcete přidat do role. |
DisplayName | string | Y | Popisný zobrazovaný název uživatele. |
UserPrincipalName | string | Y | Název objektu zabezpečení uživatele. |
Atributy | object | Y | Obsahuje "ObjectType":"UserMember" |
Příklad požadavku
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: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}
}
Odpověď REST
Tato metoda vrátí uživatelský účet s ID role připojené, když je uživatel úspěšně přiřazena role.
Kódy úspěšnosti a chyb odpovědi
Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.
Příklad odpovědi
HTTP/1.1 201 Created
Content-Length: 231
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}
}