using System; using System.Collections.Generic; using System.Globalization; using System.Linq; using System.Threading.Tasks; using BTCPayServer.Abstractions.Extensions; using BTCPayServer.Abstractions.Models; using BTCPayServer.Client; using BTCPayServer.Data; using BTCPayServer.Models; using BTCPayServer.Security.GreenField; using Microsoft.AspNetCore.Authorization; using Microsoft.AspNetCore.Mvc; using NBitcoin; using NBitcoin.DataEncoders; namespace BTCPayServer.Controllers { public partial class ManageController { [HttpGet] public async Task APIKeys() { return View(new ApiKeysViewModel() { ApiKeyDatas = await _apiKeyRepository.GetKeys(new APIKeyRepository.APIKeyQuery() { UserId = new[] { _userManager.GetUserId(User) } }) }); } [HttpGet("~/api-keys/{id}/delete")] public async Task DeleteAPIKey(string id) { var key = await _apiKeyRepository.GetKey(id); if (key == null || key.UserId != _userManager.GetUserId(User)) { return NotFound(); } return View("Confirm", new ConfirmModel { Title = "Delete API key", DescriptionHtml = true, Description = $"Any application using the API key {key.Label ?? key.Id} will immediately lose access.", Action = "Delete", ActionUrl = Url.ActionLink(nameof(DeleteAPIKeyPost), values: new { id }) }); } [HttpPost("~/api-keys/{id}/delete")] public async Task DeleteAPIKeyPost(string id) { var key = await _apiKeyRepository.GetKey(id); if (key == null || key.UserId != _userManager.GetUserId(User)) { return NotFound(); } await _apiKeyRepository.Remove(id, _userManager.GetUserId(User)); TempData.SetStatusMessageModel(new StatusMessageModel() { Severity = StatusMessageModel.StatusSeverity.Success, Message = "API Key removed" }); return RedirectToAction("APIKeys"); } [HttpGet] public async Task AddApiKey() { if (!_btcPayServerEnvironment.IsSecure) { TempData.SetStatusMessageModel(new StatusMessageModel() { Severity = StatusMessageModel.StatusSeverity.Error, Message = "Cannot generate api keys while not on https or tor" }); return RedirectToAction("APIKeys"); } return View("AddApiKey", await SetViewModelValues(new AddApiKeyViewModel())); } [HttpGet("~/api-keys/authorize")] public async Task AuthorizeAPIKey(string[] permissions, string applicationName = null, Uri redirect = null, bool strict = true, bool selectiveStores = false, string applicationIdentifier = null) { if (!_btcPayServerEnvironment.IsSecure) { TempData.SetStatusMessageModel(new StatusMessageModel() { Severity = StatusMessageModel.StatusSeverity.Error, Message = "Cannot generate api keys while not on https or tor" }); return RedirectToAction("APIKeys"); } permissions ??= Array.Empty(); var requestPermissions = Permission.ToPermissions(permissions); if (redirect?.IsAbsoluteUri is false) { redirect = null; } if (!string.IsNullOrEmpty(applicationIdentifier) && redirect != null) { //check if there is an app identifier that matches and belongs to the current user var keys = await _apiKeyRepository.GetKeys(new APIKeyRepository.APIKeyQuery() { UserId = new[] {_userManager.GetUserId(User)} }); foreach (var key in keys) { var blob = key.GetBlob(); if (blob.ApplicationIdentifier != applicationIdentifier || blob.ApplicationAuthority != redirect.AbsoluteUri) { continue; } //matched the identifier and authority, but we need to check if what the app is requesting in terms of permissions is enough var alreadyPresentPermissions = Permission.ToPermissions(blob.Permissions) .GroupBy(permission => permission.Policy); var fail = false; foreach (var permission in requestPermissions.GroupBy(permission => permission.Policy)) { var presentPermission = alreadyPresentPermissions.SingleOrDefault(grouping => permission.Key == grouping.Key); if (strict && presentPermission == null) { fail = true; break; } if (Policies.IsStorePolicy(permission.Key)) { if (!selectiveStores && permission.Any(permission1 => !string.IsNullOrEmpty(permission1.Scope))) { TempData.SetStatusMessageModel(new StatusMessageModel() { Severity = StatusMessageModel.StatusSeverity.Error, Message = "Cannot request specific store permission when selectiveStores is not enable" }); return RedirectToAction("APIKeys"); } else if (!selectiveStores && presentPermission.Any(permission1 => !string.IsNullOrEmpty(permission1.Scope))) { fail = true; break; } } } if (fail) { continue; } //we have a key that is sufficient, redirect to a page to confirm that it's ok to provide this key to the app. return View("ConfirmAPIKey", new AuthorizeApiKeysViewModel() { ApiKey = key.Id, RedirectUrl = redirect, Label = applicationName, ApplicationName = applicationName, SelectiveStores = selectiveStores, Strict = strict, Permissions = string.Join(';', permissions), ApplicationIdentifier = applicationIdentifier }); } } var vm = await SetViewModelValues(new AuthorizeApiKeysViewModel() { RedirectUrl = redirect, Label = applicationName, ApplicationName = applicationName, SelectiveStores = selectiveStores, Strict = strict, Permissions = string.Join(';', requestPermissions), ApplicationIdentifier = applicationIdentifier }); AdjustVMForAuthorization(vm); return View(vm); } private void AdjustVMForAuthorization(AuthorizeApiKeysViewModel vm) { var permissions = vm.Permissions?.Split(';') ?? Array.Empty(); var permissionsWithStoreIDs = new List(); /** * Go over each permission and associated store IDs and * join them so that permission for a specific store is parsed correctly */ for (var i = 0; i < permissions.Length; i++) { var currPerm = permissions[i]; var storeIds = vm.PermissionValues[i].SpecificStores.ToArray(); if (storeIds.Length > 0) { for (var x = 0; x < storeIds.Length; x++) { permissionsWithStoreIDs.Add($"{currPerm}:{storeIds[x]}"); } } else { permissionsWithStoreIDs.Add(currPerm); } } var parsedPermissions = Permission.ToPermissions(permissionsWithStoreIDs.ToArray()).GroupBy(permission => permission.Policy); for (var index = vm.PermissionValues.Count - 1; index >= 0; index--) { var permissionValue = vm.PermissionValues[index]; var wanted = parsedPermissions?.SingleOrDefault(permission => permission.Key.Equals(permissionValue.Permission, StringComparison.InvariantCultureIgnoreCase)); if (vm.Strict && !(wanted?.Any() ?? false)) { vm.PermissionValues.RemoveAt(index); continue; } else if (wanted?.Any() ?? false) { var commandParts = vm.Command?.Split(':', StringSplitOptions.RemoveEmptyEntries) ?? Array.Empty(); var command = commandParts.Length > 1 ? commandParts[1] : null; var isPerformingAnAction = command == "change-store-mode" || command == "add-store"; // Don't want to accidentally change mode for the user if they are explicitly performing some action if (isPerformingAnAction) { continue; } if (vm.SelectiveStores && Policies.IsStorePolicy(permissionValue.Permission) && wanted.Any(permission => !string.IsNullOrEmpty(permission.Scope))) { permissionValue.StoreMode = AddApiKeyViewModel.ApiKeyStoreMode.Specific; permissionValue.SpecificStores = wanted.Select(permission => permission.Scope).ToList(); } else { permissionValue.StoreMode = AddApiKeyViewModel.ApiKeyStoreMode.AllStores; permissionValue.SpecificStores = new List(); permissionValue.Value = true; } } } } [HttpPost("~/api-keys/authorize")] public async Task AuthorizeAPIKey([FromForm] AuthorizeApiKeysViewModel viewModel) { await SetViewModelValues(viewModel); AdjustVMForAuthorization(viewModel); var ar = HandleCommands(viewModel); if (ar != null) { return ar; } for (int i = 0; i < viewModel.PermissionValues.Count; i++) { if (viewModel.PermissionValues[i].Forbidden && viewModel.Strict) { viewModel.PermissionValues[i].Value = false; ModelState.AddModelError($"{viewModel.PermissionValues}[{i}].Value", $"The permission '{viewModel.PermissionValues[i].Title}' is required for this application."); } if (viewModel.PermissionValues[i].StoreMode == AddApiKeyViewModel.ApiKeyStoreMode.Specific && !viewModel.SelectiveStores) { viewModel.PermissionValues[i].StoreMode = AddApiKeyViewModel.ApiKeyStoreMode.AllStores; ModelState.AddModelError($"{viewModel.PermissionValues}[{i}].Value", $"The permission '{viewModel.PermissionValues[i].Title}' cannot be store specific for this application."); } } if (!ModelState.IsValid) { return View(viewModel); } var command = viewModel.Command.ToLowerInvariant(); switch (command) { case "cancel": return RedirectToAction("APIKeys"); case "authorize": case "confirm": var key = command == "authorize" ? await CreateKey(viewModel, (viewModel.ApplicationIdentifier, viewModel.RedirectUrl.AbsoluteUri)) : await _apiKeyRepository.GetKey(viewModel.ApiKey); if (viewModel.RedirectUrl != null) { var permissions = key.GetBlob().Permissions; var redirectVm = new PostRedirectViewModel() { FormUrl = viewModel.RedirectUrl.AbsoluteUri, Parameters = { new KeyValuePair("apiKey", key.Id), new KeyValuePair("userId", key.UserId) } }; foreach (var permission in permissions) { redirectVm.Parameters.Add( new KeyValuePair("permissions[]", permission)); } return View("PostRedirect", redirectVm); } TempData.SetStatusMessageModel(new StatusMessageModel() { Severity = StatusMessageModel.StatusSeverity.Success, Html = $"API key generated! {key.Id}" }); return RedirectToAction("APIKeys", new { key = key.Id }); default: return View(viewModel); } } [HttpPost] public async Task AddApiKey(AddApiKeyViewModel viewModel) { await SetViewModelValues(viewModel); var ar = HandleCommands(viewModel); if (ar != null) { return ar; } if (!ModelState.IsValid) { return View(viewModel); } var key = await CreateKey(viewModel); TempData.SetStatusMessageModel(new StatusMessageModel() { Severity = StatusMessageModel.StatusSeverity.Success, Html = $"API key generated! {key.Id}" }); return RedirectToAction("APIKeys"); } private IActionResult HandleCommands(AddApiKeyViewModel viewModel) { if (string.IsNullOrEmpty(viewModel.Command)) { return null; } var parts = viewModel.Command.Split(':', StringSplitOptions.RemoveEmptyEntries); var permission = parts[0]; if (!Policies.IsStorePolicy(permission)) { return null; } var permissionValueItem = viewModel.PermissionValues.Single(item => item.Permission == permission); var command = parts[1]; var storeIndex = parts.Length == 3 ? parts[2] : null; ModelState.Clear(); switch (command) { case "change-store-mode": permissionValueItem.StoreMode = permissionValueItem.StoreMode == AddApiKeyViewModel.ApiKeyStoreMode.Specific ? AddApiKeyViewModel.ApiKeyStoreMode.AllStores : AddApiKeyViewModel.ApiKeyStoreMode.Specific; // Make sure we don't keep specific store IDs if we switched back to "all stores" from "specific stores" if (permissionValueItem.StoreMode == AddApiKeyViewModel.ApiKeyStoreMode.AllStores) { permissionValueItem.SpecificStores = new List(); } if (permissionValueItem.StoreMode == AddApiKeyViewModel.ApiKeyStoreMode.Specific && !permissionValueItem.SpecificStores.Any() && viewModel.Stores.Any()) { permissionValueItem.SpecificStores.Add(null); } return View(viewModel); case "add-store": permissionValueItem.SpecificStores.Add(null); return View(viewModel); case "remove-store": { if (storeIndex != null) permissionValueItem.SpecificStores.RemoveAt(int.Parse(storeIndex, CultureInfo.InvariantCulture)); return View(viewModel); } } return null; } private async Task CreateKey(AddApiKeyViewModel viewModel, (string appIdentifier, string appAuthority) app = default) { var key = new APIKeyData() { Id = Encoders.Hex.EncodeData(RandomUtils.GetBytes(20)), Type = APIKeyType.Permanent, UserId = _userManager.GetUserId(User), Label = viewModel.Label, }; key.SetBlob(new APIKeyBlob() { Permissions = GetPermissionsFromViewModel(viewModel).Select(p => p.ToString()).Distinct().ToArray(), ApplicationAuthority = app.appAuthority, ApplicationIdentifier = app.appIdentifier }); await _apiKeyRepository.CreateKey(key); return key; } private IEnumerable GetPermissionsFromViewModel(AddApiKeyViewModel viewModel) { List permissions = new List(); foreach (var p in viewModel.PermissionValues.Where(tuple => !tuple.Forbidden)) { if (Policies.IsStorePolicy(p.Permission)) { if (p.StoreMode == AddApiKeyViewModel.ApiKeyStoreMode.AllStores && p.Value) { permissions.Add(Permission.Create(p.Permission)); } else if (p.StoreMode == AddApiKeyViewModel.ApiKeyStoreMode.Specific) { permissions.AddRange(p.SpecificStores.Select(s => Permission.Create(p.Permission, s))); } } else if (p.Value && Permission.TryCreatePermission(p.Permission, null, out var pp)) permissions.Add(pp); } return permissions.Distinct(); } private async Task SetViewModelValues(T viewModel) where T : AddApiKeyViewModel { viewModel.Stores = await _StoreRepository.GetStoresByUserId(_userManager.GetUserId(User)); var isAdmin = (await _authorizationService.AuthorizeAsync(User, Policies.CanModifyServerSettings)) .Succeeded; viewModel.PermissionValues ??= Policies.AllPolicies .Where(p => AddApiKeyViewModel.PermissionValueItem.PermissionDescriptions.ContainsKey(p)) .Select(s => new AddApiKeyViewModel.PermissionValueItem() { Permission = s, Value = false, Forbidden = Policies.IsServerPolicy(s) && !isAdmin }).ToList(); if (!isAdmin) { foreach (var p in viewModel.PermissionValues.Where(item => item.Permission is null || Policies.IsServerPolicy(item.Permission))) { p.Forbidden = true; } } return viewModel; } public class AddApiKeyViewModel { public string Label { get; set; } public StoreData[] Stores { get; set; } public string Command { get; set; } public List PermissionValues { get; set; } public enum ApiKeyStoreMode { AllStores, Specific } public class PermissionValueItem { public static readonly Dictionary PermissionDescriptions = new Dictionary() { {BTCPayServer.Client.Policies.Unrestricted, ("Unrestricted access", "The app will have unrestricted access to your account.")}, {BTCPayServer.Client.Policies.CanCreateUser, ("Create new users", "The app will be able to create new users on this server.")}, {BTCPayServer.Client.Policies.CanDeleteUser, ("Delete user", "The app will be able to delete the user to whom it is assigned. Admin users can delete any user without this permission.")}, {BTCPayServer.Client.Policies.CanModifyStoreSettings, ("Modify your stores", "The app will be able to manage invoices on all your stores and modify their settings.")}, {$"{BTCPayServer.Client.Policies.CanModifyStoreSettings}:", ("Manage selected stores", "The app will be able to manage invoices on the selected stores and modify their settings.")}, {BTCPayServer.Client.Policies.CanModifyStoreWebhooks, ("Modify stores webhooks", "The app will modify the webhooks of all your stores.")}, {$"{BTCPayServer.Client.Policies.CanModifyStoreWebhooks}:", ("Modify selected stores' webhooks", "The app will modify the webhooks of the selected stores.")}, {BTCPayServer.Client.Policies.CanViewStoreSettings, ("View your stores", "The app will be able to view stores settings.")}, {$"{BTCPayServer.Client.Policies.CanViewStoreSettings}:", ("View your stores", "The app will be able to view the selected stores' settings.")}, {BTCPayServer.Client.Policies.CanModifyServerSettings, ("Manage your server", "The app will have total control on the server settings of your server.")}, {BTCPayServer.Client.Policies.CanViewProfile, ("View your profile", "The app will be able to view your user profile.")}, {BTCPayServer.Client.Policies.CanModifyProfile, ("Manage your profile", "The app will be able to view and modify your user profile.")}, {BTCPayServer.Client.Policies.CanManageNotificationsForUser, ("Manage your notifications", "The app will be able to view and modify your user notifications.")}, {BTCPayServer.Client.Policies.CanViewNotificationsForUser, ("View your notifications", "The app will be able to view your user notifications.")}, {BTCPayServer.Client.Policies.CanCreateInvoice, ("Create an invoice", "The app will be able to create new invoices.")}, {$"{BTCPayServer.Client.Policies.CanCreateInvoice}:", ("Create an invoice", "The app will be able to create new invoices on the selected stores.")}, {BTCPayServer.Client.Policies.CanViewInvoices, ("View invoices", "The app will be able to view invoices.")}, {BTCPayServer.Client.Policies.CanModifyInvoices, ("Modify invoices", "The app will be able to modify and view invoices.")}, {$"{BTCPayServer.Client.Policies.CanViewInvoices}:", ("View invoices", "The app will be able to view invoices on the selected stores.")}, {$"{BTCPayServer.Client.Policies.CanModifyInvoices}:", ("Modify invoices", "The app will be able to modify and view invoices on the selected stores.")}, {BTCPayServer.Client.Policies.CanModifyPaymentRequests, ("Modify your payment requests", "The app will be able to view, modify, delete and create new payment requests on all your stores.")}, {$"{BTCPayServer.Client.Policies.CanModifyPaymentRequests}:", ("Manage selected stores' payment requests", "The app will be able to view, modify, delete and create new payment requests on the selected stores.")}, {BTCPayServer.Client.Policies.CanViewPaymentRequests, ("View your payment requests", "The app will be able to view payment requests.")}, {$"{BTCPayServer.Client.Policies.CanViewPaymentRequests}:", ("View your payment requests", "The app will be able to view the selected stores' payment requests.")}, {BTCPayServer.Client.Policies.CanUseInternalLightningNode, ("Use the internal lightning node", "The app will be able to use the internal BTCPay Server lightning node to create BOLT11 invoices, connect to other nodes, open new channels and pay BOLT11 invoices.")}, {BTCPayServer.Client.Policies.CanCreateLightningInvoiceInternalNode, ("Create invoices with internal lightning node", "The app will be able to use the internal BTCPay Server lightning node to create BOLT11 invoices.")}, {BTCPayServer.Client.Policies.CanUseLightningNodeInStore, ("Use the lightning nodes associated with your stores", "The app will be able to use the lightning nodes connected to all your stores to create BOLT11 invoices, connect to other nodes, open new channels and pay BOLT11 invoices.")}, {BTCPayServer.Client.Policies.CanCreateLightningInvoiceInStore, ("Create invoices the lightning nodes associated with your stores", "The app will be able to use the lightning nodes connected to all your stores to create BOLT11 invoices.")}, {$"{BTCPayServer.Client.Policies.CanUseLightningNodeInStore}:", ("Use the lightning nodes associated with your stores", "The app will be able to use the lightning nodes connected to the selected stores to create BOLT11 invoices, connect to other nodes, open new channels and pay BOLT11 invoices.")}, {$"{BTCPayServer.Client.Policies.CanCreateLightningInvoiceInStore}:", ("Create invoices the lightning nodes associated with your stores", "The app will be able to use the lightning nodes connected to the selected stores to create BOLT11 invoices.")}, }; public string Title { get { return PermissionDescriptions[$"{Permission}{(StoreMode == ApiKeyStoreMode.Specific ? ":" : "")}"].Title; } } public string Description { get { return PermissionDescriptions[$"{Permission}{(StoreMode == ApiKeyStoreMode.Specific ? ":" : "")}"].Description; } } public string Permission { get; set; } public bool Value { get; set; } public bool Forbidden { get; set; } public ApiKeyStoreMode StoreMode { get; set; } = ApiKeyStoreMode.AllStores; public List SpecificStores { get; set; } = new List(); } } public class AuthorizeApiKeysViewModel : AddApiKeyViewModel { public string ApplicationName { get; set; } public string ApplicationIdentifier { get; set; } public Uri RedirectUrl { get; set; } public bool Strict { get; set; } public bool SelectiveStores { get; set; } public string Permissions { get; set; } public string ApiKey { get; set; } } public class ApiKeysViewModel { public List ApiKeyDatas { get; set; } } } }