Müşterinin kullanıcı parolasını sıfırlama
Parolayı sıfırlamak, mevcut bir kullanıcı hesabındaki diğer ayrıntıları müşteriniz için güncelleştirmeye benzer.
Ö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, bunu İş Ortağı Merkezi'nde arayabilirsiniz. İş Ortağı Merkezi Giriş sayfasından Müşteriler çalışma alanını seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında, Müşteri Hesabı ayrıntıları bölümünde Microsoft Kimliğini bulun. Microsoft Kimliği, müşteri kimliğiyle (customer-tenant-id
) aynıdır.
GDAP rolleri
Aşağıdaki GDAP rollerinden en az birine ihtiyacınız vardır:
- Kullanıcı Yöneticisi
- Ayrıcalıklı Kimlik Doğrulama Yöneticisi
C#
Belirtilen müşteri kullanıcısının parolasını sıfırlamak için önce belirtilen müşteri kimliğini ve hedeflenen kullanıcıyı alın. Ardından, mevcut müşterinin bilgilerini içeren ancak yeni bir PasswordProfile nesnesi içeren yeni bir CustomerUser nesnesi oluşturun. Ardından, IAggregatePartner.Customers koleksiyonunuzu kullanın ve ById() yöntemini çağırın. Ardından Users özelliğini, ById() yöntemini ve ardından Patch yöntemini çağırın.
// 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);
Örnek
Konsol test uygulaması. Proje: PartnerSDK.FeatureSamples Sınıfı: CustomerUserUpdate.cs
REST isteği
İstek söz dizimi
Yöntem | İstek URI'si |
---|---|
PATCH | {baseURL}/v1/customers/{customer-tenant-id}/users/{user-id}/resetpassword HTTP/1.1 |
URI parametresi
Doğru müşteriyi tanımlamak için aşağıdaki sorgu parametresini kullanı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 . |
kullanıcı kimliği | Guıd | Y | Değer, tek bir kullanıcı hesabına ait GUID biçimli bir kullanıcı kimliğidir . |
İstek üst bilgileri
Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.
İstek örneği
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: 8a53b025-d5be-4d98-ab20-229d1813de76
{
"passwordProfile":{
password: "Renew456*",
forceChangePassword: true
},
"attributes": {
"objectType": "CustomerUser"
}
}
REST yanıtı
Başarılı olursa, bu yöntem güncelleştirilmiş parola bilgileriyle birlikte kullanıcı bilgilerini 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 . Hata Kodları.
Yanıt örneği
HTTP/1.1 200 OK
Content-Length: 31942
Content-Type: application/json
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
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"
}
}
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin