Gebruikersrollen voor een klant instellen

Artikel
03/06/2024

Binnen een klantaccount is er een set directoryrollen. U kunt gebruikersaccounts toewijzen aan deze rollen.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

GDAP-rollen

U hebt de volgende GDAP-rol nodig:

Beheerder voor bevoorrechte rollen

C#

Als u een directoryrol wilt toewijzen aan een klantgebruiker, maakt u een nieuwe UserMember met de relevante gebruikersgegevens. Roep vervolgens de methode IAggregatePartner.Customers.ById aan met de opgegeven klant-id om de klant te identificeren. Gebruik hier de methode DirectoryRoles.ById met de maprol-id om de rol op te geven. Open vervolgens de verzameling UserMembers en gebruik de methode Create om het nieuwe gebruikerslid toe te voegen aan de verzameling gebruikersleden die aan die rol zijn toegewezen.

// 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);

Voorbeeld: consoletest-app. Project: Voorbeeldklasse Partner Center SDK: AddUserMemberToDirectoryRole.cs

REST-aanvraag

Aanvraagsyntaxis

Method	Aanvraag-URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers HTTP/1.1

URI-parameter

Gebruik de volgende URI-parameters om de juiste klant en rol te identificeren. Als u de gebruiker wilt identificeren aan wie de rol moet worden toegewezen, geeft u de identificatiegegevens op in de hoofdtekst van de aanvraag.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	Guid	Y	De waarde is een door een GUID opgemaakte klant-tenant-id waarmee de reseller de resultaten kan filteren op een bepaalde klant die deel uitmaakt van de reseller.
role-id	Guid	Y	De waarde is een door de GUID opgemaakte rol-id waarmee de rol wordt geïdentificeerd die aan de gebruiker moet worden toegewezen.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

In deze tabel worden de vereiste eigenschappen in de aanvraagbody beschreven.

Naam	Type	Vereist	Beschrijving
Id	Tekenreeks	Y	De id van de gebruiker die moet worden toegevoegd aan de rol.
DisplayName	Tekenreeks	Y	De beschrijvende weergavenaam van de gebruiker.
UserPrincipalName	Tekenreeks	Y	De naam van de principal van de gebruiker.
Kenmerken	Object	Y	Bevat ObjectType:"UserMember"

Aanvraagvoorbeeld

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-antwoord

Deze methode retourneert het gebruikersaccount waaraan de rol-id is gekoppeld wanneer de gebruiker de rol heeft toegewezen.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Responsvoorbeeld

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"
    }
}

Delen via