Impostare i ruoli utente per un cliente

Articolo
09/11/2024

All'interno di un account cliente è disponibile un set di ruoli della directory. È possibile assegnare account utente a tali ruoli.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali app + utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).

Ruoli GDAP

Sarà necessario il ruolo GDAP seguente:

Amministratore ruolo con privilegi

C#

Per assegnare un ruolo di directory a un utente cliente, creare un nuovo UserMember con i dettagli dell'utente pertinenti. Chiamare quindi il metodo IAggregatePartner.Customers.ById con l'ID cliente specificato per identificare il cliente. Da qui usare il metodo DirectoryRoles.ById con l'ID ruolo della directory per specificare il ruolo. Accedere quindi all'insieme UserMembers e usare il metodo Create per aggiungere il nuovo membro utente alla raccolta di membri utente assegnati a tale ruolo.

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

Esempio: App di test della console. Project: Partner Center SDK Samples Class: AddUserMemberToDirectoryRole.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
POST	{baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers HTTP/1.1

Parametro URI

Usare i parametri URI seguenti per identificare il cliente corretto e il ruolo. Per identificare l'utente a cui assegnare il ruolo, fornire le informazioni di identificazione nel corpo della richiesta.

Nome	Digita	Obbligatorio	Descrizione
customer-tenant-id	guid	Y	Il valore è un GUID formattato customer-tenant-id che consente al rivenditore di filtrare i risultati per un determinato cliente appartenente al rivenditore.
role-id	guid	Y	Il valore è un ID ruolo formattato con GUID che identifica il ruolo da assegnare all'utente.

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della richiesta

Questa tabella descrive le proprietà necessarie nel corpo della richiesta.

Nome	Digita	Obbligatorio	Descrizione
ID	string	Y	ID dell'utente da aggiungere al ruolo.
DisplayName	string	Y	Nome visualizzato descrittivo dell'utente.
UserPrincipalName	string	Y	Nome dell'entità utente.
Attributi	object	Y	Contiene "ObjectType":"UserMember"

Esempio di richiesta

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

Risposta REST

Questo metodo restituisce l'account utente con l'ID ruolo associato quando all'utente viene assegnato correttamente il ruolo.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Risposta di esempio

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

Condividi tramite