| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659 | 
							- using System;
 
- using System.Collections.Generic;
 
- using System.ComponentModel.DataAnnotations;
 
- using System.Linq;
 
- using System.Threading.Tasks;
 
- using Jellyfin.Api.Constants;
 
- using Jellyfin.Api.Extensions;
 
- using Jellyfin.Api.Helpers;
 
- using Jellyfin.Api.Models.UserDtos;
 
- using Jellyfin.Data;
 
- using Jellyfin.Database.Implementations.Enums;
 
- using Jellyfin.Extensions;
 
- using MediaBrowser.Common.Api;
 
- using MediaBrowser.Common.Extensions;
 
- using MediaBrowser.Common.Net;
 
- using MediaBrowser.Controller.Authentication;
 
- using MediaBrowser.Controller.Configuration;
 
- using MediaBrowser.Controller.Devices;
 
- using MediaBrowser.Controller.Library;
 
- using MediaBrowser.Controller.Net;
 
- using MediaBrowser.Controller.Playlists;
 
- using MediaBrowser.Controller.QuickConnect;
 
- using MediaBrowser.Controller.Session;
 
- using MediaBrowser.Model.Configuration;
 
- using MediaBrowser.Model.Dto;
 
- using MediaBrowser.Model.Users;
 
- using Microsoft.AspNetCore.Authorization;
 
- using Microsoft.AspNetCore.Http;
 
- using Microsoft.AspNetCore.Mvc;
 
- using Microsoft.Extensions.Logging;
 
- namespace Jellyfin.Api.Controllers;
 
- /// <summary>
 
- /// User controller.
 
- /// </summary>
 
- [Route("Users")]
 
- public class UserController : BaseJellyfinApiController
 
- {
 
-     private readonly IUserManager _userManager;
 
-     private readonly ISessionManager _sessionManager;
 
-     private readonly INetworkManager _networkManager;
 
-     private readonly IDeviceManager _deviceManager;
 
-     private readonly IAuthorizationContext _authContext;
 
-     private readonly IServerConfigurationManager _config;
 
-     private readonly ILogger _logger;
 
-     private readonly IQuickConnect _quickConnectManager;
 
-     private readonly IPlaylistManager _playlistManager;
 
-     /// <summary>
 
-     /// Initializes a new instance of the <see cref="UserController"/> class.
 
-     /// </summary>
 
-     /// <param name="userManager">Instance of the <see cref="IUserManager"/> interface.</param>
 
-     /// <param name="sessionManager">Instance of the <see cref="ISessionManager"/> interface.</param>
 
-     /// <param name="networkManager">Instance of the <see cref="INetworkManager"/> interface.</param>
 
-     /// <param name="deviceManager">Instance of the <see cref="IDeviceManager"/> interface.</param>
 
-     /// <param name="authContext">Instance of the <see cref="IAuthorizationContext"/> interface.</param>
 
-     /// <param name="config">Instance of the <see cref="IServerConfigurationManager"/> interface.</param>
 
-     /// <param name="logger">Instance of the <see cref="ILogger"/> interface.</param>
 
-     /// <param name="quickConnectManager">Instance of the <see cref="IQuickConnect"/> interface.</param>
 
-     /// <param name="playlistManager">Instance of the <see cref="IPlaylistManager"/> interface.</param>
 
-     public UserController(
 
-         IUserManager userManager,
 
-         ISessionManager sessionManager,
 
-         INetworkManager networkManager,
 
-         IDeviceManager deviceManager,
 
-         IAuthorizationContext authContext,
 
-         IServerConfigurationManager config,
 
-         ILogger<UserController> logger,
 
-         IQuickConnect quickConnectManager,
 
-         IPlaylistManager playlistManager)
 
-     {
 
-         _userManager = userManager;
 
-         _sessionManager = sessionManager;
 
-         _networkManager = networkManager;
 
-         _deviceManager = deviceManager;
 
-         _authContext = authContext;
 
-         _config = config;
 
-         _logger = logger;
 
-         _quickConnectManager = quickConnectManager;
 
-         _playlistManager = playlistManager;
 
-     }
 
-     /// <summary>
 
-     /// Gets a list of users.
 
-     /// </summary>
 
-     /// <param name="isHidden">Optional filter by IsHidden=true or false.</param>
 
-     /// <param name="isDisabled">Optional filter by IsDisabled=true or false.</param>
 
-     /// <response code="200">Users returned.</response>
 
-     /// <returns>An <see cref="IEnumerable{UserDto}"/> containing the users.</returns>
 
-     [HttpGet]
 
-     [Authorize]
 
-     [ProducesResponseType(StatusCodes.Status200OK)]
 
-     public ActionResult<IEnumerable<UserDto>> GetUsers(
 
-         [FromQuery] bool? isHidden,
 
-         [FromQuery] bool? isDisabled)
 
-     {
 
-         var users = Get(isHidden, isDisabled, false, false);
 
-         return Ok(users);
 
-     }
 
-     /// <summary>
 
-     /// Gets a list of publicly visible users for display on a login screen.
 
-     /// </summary>
 
-     /// <response code="200">Public users returned.</response>
 
-     /// <returns>An <see cref="IEnumerable{UserDto}"/> containing the public users.</returns>
 
-     [HttpGet("Public")]
 
-     [ProducesResponseType(StatusCodes.Status200OK)]
 
-     public ActionResult<IEnumerable<UserDto>> GetPublicUsers()
 
-     {
 
-         // If the startup wizard hasn't been completed then just return all users
 
-         if (!_config.Configuration.IsStartupWizardCompleted)
 
-         {
 
-             return Ok(Get(false, false, false, false));
 
-         }
 
-         return Ok(Get(false, false, true, true));
 
-     }
 
-     /// <summary>
 
-     /// Gets a user by Id.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <response code="200">User returned.</response>
 
-     /// <response code="404">User not found.</response>
 
-     /// <returns>An <see cref="UserDto"/> with information about the user or a <see cref="NotFoundResult"/> if the user was not found.</returns>
 
-     [HttpGet("{userId}")]
 
-     [Authorize(Policy = Policies.IgnoreParentalControl)]
 
-     [ProducesResponseType(StatusCodes.Status200OK)]
 
-     [ProducesResponseType(StatusCodes.Status404NotFound)]
 
-     public ActionResult<UserDto> GetUserById([FromRoute, Required] Guid userId)
 
-     {
 
-         var user = _userManager.GetUserById(userId);
 
-         if (user is null)
 
-         {
 
-             return NotFound("User not found");
 
-         }
 
-         var result = _userManager.GetUserDto(user, HttpContext.GetNormalizedRemoteIP().ToString());
 
-         return result;
 
-     }
 
-     /// <summary>
 
-     /// Deletes a user.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <response code="204">User deleted.</response>
 
-     /// <response code="404">User not found.</response>
 
-     /// <returns>A <see cref="NoContentResult"/> indicating success or a <see cref="NotFoundResult"/> if the user was not found.</returns>
 
-     [HttpDelete("{userId}")]
 
-     [Authorize(Policy = Policies.RequiresElevation)]
 
-     [ProducesResponseType(StatusCodes.Status204NoContent)]
 
-     [ProducesResponseType(StatusCodes.Status404NotFound)]
 
-     public async Task<ActionResult> DeleteUser([FromRoute, Required] Guid userId)
 
-     {
 
-         var user = _userManager.GetUserById(userId);
 
-         if (user is null)
 
-         {
 
-             return NotFound();
 
-         }
 
-         await _sessionManager.RevokeUserTokens(user.Id, null).ConfigureAwait(false);
 
-         await _playlistManager.RemovePlaylistsAsync(userId).ConfigureAwait(false);
 
-         await _userManager.DeleteUserAsync(userId).ConfigureAwait(false);
 
-         return NoContent();
 
-     }
 
-     /// <summary>
 
-     /// Authenticates a user.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <param name="pw">The password as plain text.</param>
 
-     /// <response code="200">User authenticated.</response>
 
-     /// <response code="403">Sha1-hashed password only is not allowed.</response>
 
-     /// <response code="404">User not found.</response>
 
-     /// <returns>A <see cref="Task"/> containing an <see cref="AuthenticationResult"/>.</returns>
 
-     [HttpPost("{userId}/Authenticate")]
 
-     [ProducesResponseType(StatusCodes.Status200OK)]
 
-     [ProducesResponseType(StatusCodes.Status403Forbidden)]
 
-     [ProducesResponseType(StatusCodes.Status404NotFound)]
 
-     [ApiExplorerSettings(IgnoreApi = true)]
 
-     [Obsolete("Authenticate with username instead")]
 
-     public async Task<ActionResult<AuthenticationResult>> AuthenticateUser(
 
-         [FromRoute, Required] Guid userId,
 
-         [FromQuery, Required] string pw)
 
-     {
 
-         var user = _userManager.GetUserById(userId);
 
-         if (user is null)
 
-         {
 
-             return NotFound("User not found");
 
-         }
 
-         AuthenticateUserByName request = new AuthenticateUserByName
 
-         {
 
-             Username = user.Username,
 
-             Pw = pw
 
-         };
 
-         return await AuthenticateUserByName(request).ConfigureAwait(false);
 
-     }
 
-     /// <summary>
 
-     /// Authenticates a user by name.
 
-     /// </summary>
 
-     /// <param name="request">The <see cref="AuthenticateUserByName"/> request.</param>
 
-     /// <response code="200">User authenticated.</response>
 
-     /// <returns>A <see cref="Task"/> containing an <see cref="AuthenticationRequest"/> with information about the new session.</returns>
 
-     [HttpPost("AuthenticateByName")]
 
-     [ProducesResponseType(StatusCodes.Status200OK)]
 
-     public async Task<ActionResult<AuthenticationResult>> AuthenticateUserByName([FromBody, Required] AuthenticateUserByName request)
 
-     {
 
-         var auth = await _authContext.GetAuthorizationInfo(Request).ConfigureAwait(false);
 
-         try
 
-         {
 
-             var result = await _sessionManager.AuthenticateNewSession(new AuthenticationRequest
 
-             {
 
-                 App = auth.Client,
 
-                 AppVersion = auth.Version,
 
-                 DeviceId = auth.DeviceId,
 
-                 DeviceName = auth.Device,
 
-                 Password = request.Pw,
 
-                 RemoteEndPoint = HttpContext.GetNormalizedRemoteIP().ToString(),
 
-                 Username = request.Username
 
-             }).ConfigureAwait(false);
 
-             return result;
 
-         }
 
-         catch (SecurityException e)
 
-         {
 
-             // rethrow adding IP address to message
 
-             throw new SecurityException($"[{HttpContext.GetNormalizedRemoteIP()}] {e.Message}", e);
 
-         }
 
-     }
 
-     /// <summary>
 
-     /// Authenticates a user with quick connect.
 
-     /// </summary>
 
-     /// <param name="request">The <see cref="QuickConnectDto"/> request.</param>
 
-     /// <response code="200">User authenticated.</response>
 
-     /// <response code="400">Missing token.</response>
 
-     /// <returns>A <see cref="Task"/> containing an <see cref="AuthenticationRequest"/> with information about the new session.</returns>
 
-     [HttpPost("AuthenticateWithQuickConnect")]
 
-     [ProducesResponseType(StatusCodes.Status200OK)]
 
-     public ActionResult<AuthenticationResult> AuthenticateWithQuickConnect([FromBody, Required] QuickConnectDto request)
 
-     {
 
-         try
 
-         {
 
-             return _quickConnectManager.GetAuthorizedRequest(request.Secret);
 
-         }
 
-         catch (SecurityException e)
 
-         {
 
-             // rethrow adding IP address to message
 
-             throw new SecurityException($"[{HttpContext.GetNormalizedRemoteIP()}] {e.Message}", e);
 
-         }
 
-     }
 
-     /// <summary>
 
-     /// Updates a user's password.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <param name="request">The <see cref="UpdateUserPassword"/> request.</param>
 
-     /// <response code="204">Password successfully reset.</response>
 
-     /// <response code="403">User is not allowed to update the password.</response>
 
-     /// <response code="404">User not found.</response>
 
-     /// <returns>A <see cref="NoContentResult"/> indicating success or a <see cref="ForbidResult"/> or a <see cref="NotFoundResult"/> on failure.</returns>
 
-     [HttpPost("Password")]
 
-     [Authorize]
 
-     [ProducesResponseType(StatusCodes.Status204NoContent)]
 
-     [ProducesResponseType(StatusCodes.Status403Forbidden)]
 
-     [ProducesResponseType(StatusCodes.Status404NotFound)]
 
-     public async Task<ActionResult> UpdateUserPassword(
 
-         [FromQuery] Guid? userId,
 
-         [FromBody, Required] UpdateUserPassword request)
 
-     {
 
-         var requestUserId = userId ?? User.GetUserId();
 
-         var user = _userManager.GetUserById(requestUserId);
 
-         if (user is null)
 
-         {
 
-             return NotFound();
 
-         }
 
-         if (!RequestHelpers.AssertCanUpdateUser(User, user, true))
 
-         {
 
-             return StatusCode(StatusCodes.Status403Forbidden, "User is not allowed to update the password.");
 
-         }
 
-         if (request.ResetPassword)
 
-         {
 
-             await _userManager.ResetPassword(user).ConfigureAwait(false);
 
-         }
 
-         else
 
-         {
 
-             if (!User.IsInRole(UserRoles.Administrator) || (userId.HasValue && User.GetUserId().Equals(userId.Value)))
 
-             {
 
-                 var success = await _userManager.AuthenticateUser(
 
-                     user.Username,
 
-                     request.CurrentPw ?? string.Empty,
 
-                     HttpContext.GetNormalizedRemoteIP().ToString(),
 
-                     false).ConfigureAwait(false);
 
-                 if (success is null)
 
-                 {
 
-                     return StatusCode(StatusCodes.Status403Forbidden, "Invalid user or password entered.");
 
-                 }
 
-             }
 
-             await _userManager.ChangePassword(user, request.NewPw ?? string.Empty).ConfigureAwait(false);
 
-             var currentToken = User.GetToken();
 
-             await _sessionManager.RevokeUserTokens(user.Id, currentToken).ConfigureAwait(false);
 
-         }
 
-         return NoContent();
 
-     }
 
-     /// <summary>
 
-     /// Updates a user's password.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <param name="request">The <see cref="UpdateUserPassword"/> request.</param>
 
-     /// <response code="204">Password successfully reset.</response>
 
-     /// <response code="403">User is not allowed to update the password.</response>
 
-     /// <response code="404">User not found.</response>
 
-     /// <returns>A <see cref="NoContentResult"/> indicating success or a <see cref="ForbidResult"/> or a <see cref="NotFoundResult"/> on failure.</returns>
 
-     [HttpPost("{userId}/Password")]
 
-     [Authorize]
 
-     [ProducesResponseType(StatusCodes.Status204NoContent)]
 
-     [ProducesResponseType(StatusCodes.Status403Forbidden)]
 
-     [ProducesResponseType(StatusCodes.Status404NotFound)]
 
-     [Obsolete("Kept for backwards compatibility")]
 
-     [ApiExplorerSettings(IgnoreApi = true)]
 
-     public Task<ActionResult> UpdateUserPasswordLegacy(
 
-         [FromRoute, Required] Guid userId,
 
-         [FromBody, Required] UpdateUserPassword request)
 
-         => UpdateUserPassword(userId, request);
 
-     /// <summary>
 
-     /// Updates a user's easy password.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <param name="request">The <see cref="UpdateUserEasyPassword"/> request.</param>
 
-     /// <response code="204">Password successfully reset.</response>
 
-     /// <response code="403">User is not allowed to update the password.</response>
 
-     /// <response code="404">User not found.</response>
 
-     /// <returns>A <see cref="NoContentResult"/> indicating success or a <see cref="ForbidResult"/> or a <see cref="NotFoundResult"/> on failure.</returns>
 
-     [HttpPost("{userId}/EasyPassword")]
 
-     [Obsolete("Use Quick Connect instead")]
 
-     [ApiExplorerSettings(IgnoreApi = true)]
 
-     [Authorize]
 
-     [ProducesResponseType(StatusCodes.Status204NoContent)]
 
-     [ProducesResponseType(StatusCodes.Status403Forbidden)]
 
-     [ProducesResponseType(StatusCodes.Status404NotFound)]
 
-     public ActionResult UpdateUserEasyPassword(
 
-         [FromRoute, Required] Guid userId,
 
-         [FromBody, Required] UpdateUserEasyPassword request)
 
-     {
 
-         return Forbid();
 
-     }
 
-     /// <summary>
 
-     /// Updates a user.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <param name="updateUser">The updated user model.</param>
 
-     /// <response code="204">User updated.</response>
 
-     /// <response code="400">User information was not supplied.</response>
 
-     /// <response code="403">User update forbidden.</response>
 
-     /// <returns>A <see cref="NoContentResult"/> indicating success or a <see cref="BadRequestResult"/> or a <see cref="ForbidResult"/> on failure.</returns>
 
-     [HttpPost]
 
-     [Authorize]
 
-     [ProducesResponseType(StatusCodes.Status204NoContent)]
 
-     [ProducesResponseType(StatusCodes.Status400BadRequest)]
 
-     [ProducesResponseType(StatusCodes.Status403Forbidden)]
 
-     public async Task<ActionResult> UpdateUser(
 
-         [FromQuery] Guid? userId,
 
-         [FromBody, Required] UserDto updateUser)
 
-     {
 
-         var requestUserId = userId ?? User.GetUserId();
 
-         var user = _userManager.GetUserById(requestUserId);
 
-         if (user is null)
 
-         {
 
-             return NotFound();
 
-         }
 
-         if (!RequestHelpers.AssertCanUpdateUser(User, user, true))
 
-         {
 
-             return StatusCode(StatusCodes.Status403Forbidden, "User update not allowed.");
 
-         }
 
-         if (!string.Equals(user.Username, updateUser.Name, StringComparison.Ordinal))
 
-         {
 
-             await _userManager.RenameUser(user, updateUser.Name).ConfigureAwait(false);
 
-         }
 
-         await _userManager.UpdateConfigurationAsync(requestUserId, updateUser.Configuration).ConfigureAwait(false);
 
-         return NoContent();
 
-     }
 
-     /// <summary>
 
-     /// Updates a user.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <param name="updateUser">The updated user model.</param>
 
-     /// <response code="204">User updated.</response>
 
-     /// <response code="400">User information was not supplied.</response>
 
-     /// <response code="403">User update forbidden.</response>
 
-     /// <returns>A <see cref="NoContentResult"/> indicating success or a <see cref="BadRequestResult"/> or a <see cref="ForbidResult"/> on failure.</returns>
 
-     [HttpPost("{userId}")]
 
-     [Authorize]
 
-     [ProducesResponseType(StatusCodes.Status204NoContent)]
 
-     [ProducesResponseType(StatusCodes.Status400BadRequest)]
 
-     [ProducesResponseType(StatusCodes.Status403Forbidden)]
 
-     [Obsolete("Kept for backwards compatibility")]
 
-     [ApiExplorerSettings(IgnoreApi = true)]
 
-     public Task<ActionResult> UpdateUserLegacy(
 
-         [FromRoute, Required] Guid userId,
 
-         [FromBody, Required] UserDto updateUser)
 
-         => UpdateUser(userId, updateUser);
 
-     /// <summary>
 
-     /// Updates a user policy.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <param name="newPolicy">The new user policy.</param>
 
-     /// <response code="204">User policy updated.</response>
 
-     /// <response code="400">User policy was not supplied.</response>
 
-     /// <response code="403">User policy update forbidden.</response>
 
-     /// <returns>A <see cref="NoContentResult"/> indicating success or a <see cref="BadRequestResult"/> or a <see cref="ForbidResult"/> on failure..</returns>
 
-     [HttpPost("{userId}/Policy")]
 
-     [Authorize(Policy = Policies.RequiresElevation)]
 
-     [ProducesResponseType(StatusCodes.Status204NoContent)]
 
-     [ProducesResponseType(StatusCodes.Status400BadRequest)]
 
-     [ProducesResponseType(StatusCodes.Status403Forbidden)]
 
-     public async Task<ActionResult> UpdateUserPolicy(
 
-         [FromRoute, Required] Guid userId,
 
-         [FromBody, Required] UserPolicy newPolicy)
 
-     {
 
-         var user = _userManager.GetUserById(userId);
 
-         if (user is null)
 
-         {
 
-             return NotFound();
 
-         }
 
-         // If removing admin access
 
-         if (!newPolicy.IsAdministrator && user.HasPermission(PermissionKind.IsAdministrator))
 
-         {
 
-             if (_userManager.Users.Count(i => i.HasPermission(PermissionKind.IsAdministrator)) == 1)
 
-             {
 
-                 return StatusCode(StatusCodes.Status403Forbidden, "There must be at least one user in the system with administrative access.");
 
-             }
 
-         }
 
-         // If disabling
 
-         if (newPolicy.IsDisabled && user.HasPermission(PermissionKind.IsAdministrator))
 
-         {
 
-             return StatusCode(StatusCodes.Status403Forbidden, "Administrators cannot be disabled.");
 
-         }
 
-         // If disabling
 
-         if (newPolicy.IsDisabled && !user.HasPermission(PermissionKind.IsDisabled))
 
-         {
 
-             if (_userManager.Users.Count(i => !i.HasPermission(PermissionKind.IsDisabled)) == 1)
 
-             {
 
-                 return StatusCode(StatusCodes.Status403Forbidden, "There must be at least one enabled user in the system.");
 
-             }
 
-             var currentToken = User.GetToken();
 
-             await _sessionManager.RevokeUserTokens(user.Id, currentToken).ConfigureAwait(false);
 
-         }
 
-         await _userManager.UpdatePolicyAsync(userId, newPolicy).ConfigureAwait(false);
 
-         return NoContent();
 
-     }
 
-     /// <summary>
 
-     /// Updates a user configuration.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <param name="userConfig">The new user configuration.</param>
 
-     /// <response code="204">User configuration updated.</response>
 
-     /// <response code="403">User configuration update forbidden.</response>
 
-     /// <returns>A <see cref="NoContentResult"/> indicating success.</returns>
 
-     [HttpPost("Configuration")]
 
-     [Authorize]
 
-     [ProducesResponseType(StatusCodes.Status204NoContent)]
 
-     [ProducesResponseType(StatusCodes.Status403Forbidden)]
 
-     public async Task<ActionResult> UpdateUserConfiguration(
 
-         [FromQuery] Guid? userId,
 
-         [FromBody, Required] UserConfiguration userConfig)
 
-     {
 
-         var requestUserId = userId ?? User.GetUserId();
 
-         var user = _userManager.GetUserById(requestUserId);
 
-         if (user is null)
 
-         {
 
-             return NotFound();
 
-         }
 
-         if (!RequestHelpers.AssertCanUpdateUser(User, user, true))
 
-         {
 
-             return StatusCode(StatusCodes.Status403Forbidden, "User configuration update not allowed");
 
-         }
 
-         await _userManager.UpdateConfigurationAsync(requestUserId, userConfig).ConfigureAwait(false);
 
-         return NoContent();
 
-     }
 
-     /// <summary>
 
-     /// Updates a user configuration.
 
-     /// </summary>
 
-     /// <param name="userId">The user id.</param>
 
-     /// <param name="userConfig">The new user configuration.</param>
 
-     /// <response code="204">User configuration updated.</response>
 
-     /// <response code="403">User configuration update forbidden.</response>
 
-     /// <returns>A <see cref="NoContentResult"/> indicating success.</returns>
 
-     [HttpPost("{userId}/Configuration")]
 
-     [Authorize]
 
-     [Obsolete("Kept for backwards compatibility")]
 
-     [ApiExplorerSettings(IgnoreApi = true)]
 
-     [ProducesResponseType(StatusCodes.Status204NoContent)]
 
-     [ProducesResponseType(StatusCodes.Status403Forbidden)]
 
-     public Task<ActionResult> UpdateUserConfigurationLegacy(
 
-         [FromRoute, Required] Guid userId,
 
-         [FromBody, Required] UserConfiguration userConfig)
 
-         => UpdateUserConfiguration(userId, userConfig);
 
-     /// <summary>
 
-     /// Creates a user.
 
-     /// </summary>
 
-     /// <param name="request">The create user by name request body.</param>
 
-     /// <response code="200">User created.</response>
 
-     /// <returns>An <see cref="UserDto"/> of the new user.</returns>
 
-     [HttpPost("New")]
 
-     [Authorize(Policy = Policies.RequiresElevation)]
 
-     [ProducesResponseType(StatusCodes.Status200OK)]
 
-     public async Task<ActionResult<UserDto>> CreateUserByName([FromBody, Required] CreateUserByName request)
 
-     {
 
-         var newUser = await _userManager.CreateUserAsync(request.Name).ConfigureAwait(false);
 
-         // no need to authenticate password for new user
 
-         if (request.Password is not null)
 
-         {
 
-             await _userManager.ChangePassword(newUser, request.Password).ConfigureAwait(false);
 
-         }
 
-         var result = _userManager.GetUserDto(newUser, HttpContext.GetNormalizedRemoteIP().ToString());
 
-         return result;
 
-     }
 
-     /// <summary>
 
-     /// Initiates the forgot password process for a local user.
 
-     /// </summary>
 
-     /// <param name="forgotPasswordRequest">The forgot password request containing the entered username.</param>
 
-     /// <response code="200">Password reset process started.</response>
 
-     /// <returns>A <see cref="Task"/> containing a <see cref="ForgotPasswordResult"/>.</returns>
 
-     [HttpPost("ForgotPassword")]
 
-     [ProducesResponseType(StatusCodes.Status200OK)]
 
-     public async Task<ActionResult<ForgotPasswordResult>> ForgotPassword([FromBody, Required] ForgotPasswordDto forgotPasswordRequest)
 
-     {
 
-         var ip = HttpContext.GetNormalizedRemoteIP();
 
-         var isLocal = HttpContext.IsLocal()
 
-                       || _networkManager.IsInLocalNetwork(ip);
 
-         if (!isLocal)
 
-         {
 
-             _logger.LogWarning("Password reset process initiated from outside the local network with IP: {IP}", ip);
 
-         }
 
-         var result = await _userManager.StartForgotPasswordProcess(forgotPasswordRequest.EnteredUsername, isLocal).ConfigureAwait(false);
 
-         return result;
 
-     }
 
-     /// <summary>
 
-     /// Redeems a forgot password pin.
 
-     /// </summary>
 
-     /// <param name="forgotPasswordPinRequest">The forgot password pin request containing the entered pin.</param>
 
-     /// <response code="200">Pin reset process started.</response>
 
-     /// <returns>A <see cref="Task"/> containing a <see cref="PinRedeemResult"/>.</returns>
 
-     [HttpPost("ForgotPassword/Pin")]
 
-     [ProducesResponseType(StatusCodes.Status200OK)]
 
-     public async Task<ActionResult<PinRedeemResult>> ForgotPasswordPin([FromBody, Required] ForgotPasswordPinDto forgotPasswordPinRequest)
 
-     {
 
-         var result = await _userManager.RedeemPasswordResetPin(forgotPasswordPinRequest.Pin).ConfigureAwait(false);
 
-         return result;
 
-     }
 
-     /// <summary>
 
-     /// Gets the user based on auth token.
 
-     /// </summary>
 
-     /// <response code="200">User returned.</response>
 
-     /// <response code="400">Token is not owned by a user.</response>
 
-     /// <returns>A <see cref="UserDto"/> for the authenticated user.</returns>
 
-     [HttpGet("Me")]
 
-     [Authorize]
 
-     [ProducesResponseType(StatusCodes.Status200OK)]
 
-     [ProducesResponseType(StatusCodes.Status400BadRequest)]
 
-     public ActionResult<UserDto> GetCurrentUser()
 
-     {
 
-         var userId = User.GetUserId();
 
-         if (userId.IsEmpty())
 
-         {
 
-             return BadRequest();
 
-         }
 
-         var user = _userManager.GetUserById(userId);
 
-         if (user is null)
 
-         {
 
-             return BadRequest();
 
-         }
 
-         return _userManager.GetUserDto(user);
 
-     }
 
-     private IEnumerable<UserDto> Get(bool? isHidden, bool? isDisabled, bool filterByDevice, bool filterByNetwork)
 
-     {
 
-         var users = _userManager.Users;
 
-         if (isDisabled.HasValue)
 
-         {
 
-             users = users.Where(i => i.HasPermission(PermissionKind.IsDisabled) == isDisabled.Value);
 
-         }
 
-         if (isHidden.HasValue)
 
-         {
 
-             users = users.Where(i => i.HasPermission(PermissionKind.IsHidden) == isHidden.Value);
 
-         }
 
-         if (filterByDevice)
 
-         {
 
-             var deviceId = User.GetDeviceId();
 
-             if (!string.IsNullOrWhiteSpace(deviceId))
 
-             {
 
-                 users = users.Where(i => _deviceManager.CanAccessDevice(i, deviceId));
 
-             }
 
-         }
 
-         if (filterByNetwork)
 
-         {
 
-             if (!_networkManager.IsInLocalNetwork(HttpContext.GetNormalizedRemoteIP()))
 
-             {
 
-                 users = users.Where(i => i.HasPermission(PermissionKind.EnableRemoteAccess));
 
-             }
 
-         }
 
-         var result = users
 
-             .OrderBy(u => u.Username)
 
-             .Select(i => _userManager.GetUserDto(i, HttpContext.GetNormalizedRemoteIP().ToString()));
 
-         return result;
 
-     }
 
- }
 
 
  |