Reset user password for a customer (Restablecer la contraseña de usuario de un cliente)
Restablecer una contraseña es similar a actualizar otros detalles en una cuenta de usuario existente para el cliente.
Requisitos previos
Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.
Un id. de cliente (
customer-tenant-id
). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners. Seleccione el área de trabajo Clientes en la página principal del Centro de partners. Seleccione el cliente en la lista Customer (Cliente) y, a continuación, seleccione Account (Cuenta). En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Detalles de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id
).
Roles de GDAP
Necesitará al menos uno de los siguientes roles de GDAP:
- Administrador de usuarios
- Administrador de autenticación con privilegios
C#
Para restablecer una contraseña para un usuario cliente especificado, primero recupere el identificador de cliente especificado y el usuario de destino. A continuación, cree un nuevo objeto CustomerUser que contenga la información del cliente existente, pero con un nuevo objeto PasswordProfile . A continuación, use la colección IAggregatePartner.Customers y llame al método ById(). A continuación, llame a la propiedad Users , al método ById() y, a continuación, al método Patch .
// 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);
Ejemplo
Aplicación de prueba de consola. Project: PartnerSDK.FeatureSamples (Clase): CustomerUserUpdate.cs
Solicitud REST
Sintaxis de la solicitud
Method | URI de solicitud |
---|---|
PATCH | {baseURL}/v1/customers/{customer-tenant-id}/users/{user-id}/resetpassword HTTP/1.1 |
Parámetro de URI
Use el siguiente parámetro de consulta para identificar el cliente correcto.
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
customer-tenant-id | guid | Y | El valor es un GUID con formato customer-tenant-id que permite al revendedor filtrar los resultados de un cliente determinado que pertenece al revendedor. |
user-id | guid | Y | El valor es un identificador de usuario con formato GUID que pertenece a una sola cuenta de usuario. |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Ejemplo de solicitud
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"
}
}
Respuesta REST
Si se ejecuta correctamente, este método devuelve la información del usuario, junto con la información de contraseña actualizada.
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error.
Ejemplo de respuesta
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"
}
}
Comentarios
https://aka.ms/ContentUserFeedback.
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte:Enviar e ver os comentarios