Gebruikerswachtwoord voor een klant opnieuw instellen

Artikel
09/11/2024

Het opnieuw instellen van een wachtwoord is vergelijkbaar met het bijwerken van andere gegevens in een bestaand gebruikersaccount voor uw klant.

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 partnercentrum. Selecteer de werkruimte Klanten op de startpagina van Partnercentrum. Selecteer de klant in de lijst Klant en selecteer Vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Details van het klantaccount. De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

GDAP-rollen

U hebt ten minste een van de volgende GDAP-rollen nodig:

Gebruikersbeheerder
Bevoorrechte verificatiebeheerder

C#

Als u een wachtwoord voor een opgegeven klantgebruiker opnieuw wilt instellen, moet u eerst de opgegeven klant-id en de beoogde gebruiker ophalen. Maak vervolgens een nieuw CustomerUser-object dat de informatie voor de bestaande klant bevat, maar met een nieuw PasswordProfile-object . Gebruik vervolgens uw verzameling IAggregatePartner.Customers en roep de Methode ById() aan. Roep vervolgens de eigenschap Users , de Methode ById() en vervolgens de Patch-methode aan.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// CustomerUser specifiedUser;

var selectedCustomer = partnerOperations.Customers.ById(selectedCustomerId).Get();
var userToUpdate = new CustomerUser()
   {
      PasswordProfile = new PasswordProfile() { ForceChangePassword = true, Password = "newPassword" },
      DisplayName = "Roger Federer",
      FirstName = "Roger",
      LastName = "Federer",
      UsageLocation = "US",
      UserPrincipalName = Guid.NewGuid().ToString("N") + "@" + selectedCustomer.CompanyProfile.Domain.ToString()
   };

// update customer user information
User updatedCustomerUserInfo = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(specifiedUser.Id).Patch(userToUpdate);

voorbeeld

Consoletest-app. Project: Klasse PartnerSDK.FeatureSamples: CustomerUserUpdate.cs

REST-aanvraag

Aanvraagsyntaxis

Method	Aanvraag-URI
PATCH	{baseURL}/v1/customers/{customer-tenant-id}/users/{user-id}/resetpassword HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om de juiste klant te identificeren.

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.
user-id	Guid	Y	De waarde is een gebruikers-id met EEN GUID-indeling die deel uitmaakt van één gebruikersaccount.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagvoorbeeld

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/users/<user-id>/resetpassword HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
     "passwordProfile":{
        password: "Renew456*",
        forceChangePassword: true
      },

      "attributes": {
        "objectType": "CustomerUser"
      }
}

REST-antwoord

Als dit lukt, retourneert deze methode de gebruikersgegevens, samen met de bijgewerkte wachtwoordgegevens.

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 Foutcodes voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Content-Length: 31942
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
Date: June 24 2016 22:00:25 PST
{
  "usageLocation": "AX",
  "id": "95794928-9abe-4548-8b43-50ffc20b9404",
  "userPrincipalName": "aaaa4@abcdefgh1234.onmicrosoft.com",
  "firstName": "aaaa4",
  "lastName": "aaaa4",
  "displayName": "aaaa4",
  "passwordProfile": {
    "forceChangePassword": false,
    "password": "Renew456*"
  },
  "lastDirectorySyncTime": null,
  "userDomainType": "none",
  "state": "active",
  "softDeletionTime": null,
  "links": {
    "self": {
      "uri": "/customers/eebd1b55-5360-4438-a11d-5c06918c3014/users/95794928-9abe-4548-8b43-50ffc20b9404",
      "method": "GET",
      "headers": [

      ]
    }
  },
  "attributes": {
    "objectType": "CustomerUser"
  }
}

Delen via