passbolt-styleguide 3.5.2 → 3.6.0-alpha2

package/src/react-extension/contexts/AccountRecoveryUserContext.js

@@ -0,0 +1,223 @@
+/**
+ * Passbolt ~ Open source password manager for teams
+ * Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ *
+ * Licensed under GNU Affero General Public License version 3 of the or any later version.
+ * For full copyright and license information, please see the LICENSE.txt
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ * @license       https://opensource.org/licenses/AGPL-3.0 AGPL License
+ * @link          https://www.passbolt.com Passbolt(tm)
+ * @since         3.6.0
+ */
+
+import React from "react";
+import PropTypes from "prop-types";
+import {withAppContext} from "./AppContext";
+
+export const AccountRecoveryUserContext = React.createContext({
+  accountRecoveryOrganizationPolicy: null, // The current organization policy
+  status: null, // The current account recovery user settings status
+  findAccountRecoveryPolicy: () => {},
+  getOrganizationPolicy: () => {},
+  getRequestor: () => {},
+  getRequestedDate: () => {},
+  getPolicy: () => {},
+  getUserAccountRecoverySubscriptionStatus: () => {},
+  isAccountRecoveryChoiceRequired: () => {},
+  isPolicyEnabled: () => {},
+});
+
+const ACCOUNT_RECOVERY_STATUS_PENDING = 'pending';
+const ACCOUNT_RECOVERY_POLICY_MANDATORY = "mandatory";
+const ACCOUNT_RECOVERY_POLICY_OPT_OUT = "opt-out";
+const ACCOUNT_RECOVERY_POLICY_DISABLED = 'disabled';
+const ACCOUNT_RECOVERY_STATUS_APPROVED = 'approved';
+/**
+ * The related context provider
+ */
+export class AccountRecoveryUserContextProvider extends React.Component {
+  /**
+   * Default constructor
+   * @param props The component props
+   */
+  constructor(props) {
+    super(props);
+    this.state = this.defaultState;
+  }
+
+  /**
+   * Returns the default component state
+   */
+  get defaultState() {
+    return {
+      accountRecoveryOrganizationPolicy: null, // The current organization policy
+      status: null, // The current account recovery user settings status
+      findAccountRecoveryPolicy: this.findAccountRecoveryPolicy.bind(this), // Whenever the account recovery policy is requested
+      getOrganizationPolicy: this.getOrganizationPolicy.bind(this), // The current organization account recovery policy details
+      getRequestor: this.getRequestor.bind(this), // The current organization account recovery policy requestor
+      getRequestedDate: this.getRequestedDate.bind(this), // The date at when the requestor asked for user to subscribe to the account recovery program
+      getPolicy: this.getPolicy.bind(this), // The current organization account recovery policy
+      getUserAccountRecoverySubscriptionStatus: this.getUserAccountRecoverySubscriptionStatus.bind(this), // The user account recovery program subscription status
+      setUserAccountRecoveryStatus: this.setUserAccountRecoveryStatus.bind(this), // Sets the status of the current user account recovery setting
+      isAccountRecoveryChoiceRequired: this.isAccountRecoveryChoiceRequired.bind(this), // Returns true if the user has to decide to participate or not for the account recovery program
+      isPolicyEnabled: this.isPolicyEnabled.bind(this), // Return true is the policy is enabled
+    };
+  }
+
+  /**
+   * Find the account recovery policy
+   */
+  async findAccountRecoveryPolicy() {
+    if (!this.props.context.siteSettings.canIUse('accountRecovery')) {
+      return;
+    }
+
+    if (this.state.accountRecoveryOrganizationPolicy !== null) {
+      return;
+    }
+
+    const loggedInUser = this.props.context.loggedInUser;
+    if (!loggedInUser) {
+      return;
+    }
+
+    const accountRecoveryOrganizationPolicy = await this.props.accountRecoveryUserService.getOrganizationAccountRecoverySettings();
+    const status = loggedInUser.account_recovery_user_setting?.status || AccountRecoveryUserContextProvider.STATUS_PENDING;
+    this.setState({
+      accountRecoveryOrganizationPolicy,
+      status
+    });
+  }
+
+  /**
+   * Returns the full organization policy settings.
+   * @returns {object}
+   */
+  getOrganizationPolicy() {
+    return this.state.accountRecoveryOrganizationPolicy;
+  }
+
+  /**
+   * Get the date at when an administrator asked users to set their account recovery policy setting.
+   * @returns {object}
+   */
+  getRequestedDate() {
+    return this.getOrganizationPolicy()?.modified;
+  }
+
+  /**
+   * Get the user that asked the account recovery policy settings to be set.
+   * @returns {object}
+   */
+  getRequestor() {
+    return this.getOrganizationPolicy()?.creator;
+  }
+
+  /**
+   * Get the organization policy.
+   * @returns {string}
+   */
+  getPolicy() {
+    return this.getOrganizationPolicy()?.policy;
+  }
+
+  /**
+   * Get the current user account recovery setting status.
+   * @returns {string}
+   */
+  getUserAccountRecoverySubscriptionStatus() {
+    return this.state.status;
+  }
+
+  /**
+   * Set the current user account recovery setting.
+   * @param {string} status
+   */
+  setUserAccountRecoveryStatus(status) {
+    this.setState({status: status});
+  }
+
+  /**
+   * Returns true if the current user has to choose for an account recovery setting.
+   * In that case, the organization account recovery setting has to be set with "mandatory" or "opt-out",
+   * plus the user shouldn't have made a choice yet.
+   * @returns {bool}
+   */
+  isAccountRecoveryChoiceRequired() {
+    if (this.getOrganizationPolicy() === null) {
+      return false;
+    }
+
+    const policy = this.getPolicy();
+    return this.state.status === AccountRecoveryUserContextProvider.STATUS_PENDING
+      && (policy === AccountRecoveryUserContextProvider.POLICY_MANDATORY || policy === AccountRecoveryUserContextProvider.POLICY_OPT_OUT);
+  }
+
+  /**
+   * Return true if the policy is not set to POLICY_DISABLED
+   * @returns {boolean}
+   */
+  isPolicyEnabled() {
+    const policy = this.getPolicy();
+    return policy && policy !== AccountRecoveryUserContextProvider.POLICY_DISABLED;
+  }
+
+  static get STATUS_PENDING() {
+    return ACCOUNT_RECOVERY_STATUS_PENDING;
+  }
+
+  static get POLICY_DISABLED() {
+    return ACCOUNT_RECOVERY_POLICY_DISABLED;
+  }
+
+  static get POLICY_MANDATORY() {
+    return ACCOUNT_RECOVERY_POLICY_MANDATORY;
+  }
+
+  static get POLICY_OPT_OUT() {
+    return ACCOUNT_RECOVERY_POLICY_OPT_OUT;
+  }
+
+  static get STATUS_APPROVED() {
+    return ACCOUNT_RECOVERY_STATUS_APPROVED;
+  }
+
+  /**
+   * Render the component
+   * @returns {JSX}
+   */
+  render() {
+    return (
+      <AccountRecoveryUserContext.Provider value={this.state}>
+        {this.props.children}
+      </AccountRecoveryUserContext.Provider>
+    );
+  }
+}
+
+AccountRecoveryUserContextProvider.propTypes = {
+  context: PropTypes.any.isRequired, // The application context
+  children: PropTypes.any, // The children components
+  accountRecoveryUserService: PropTypes.object.isRequired // The service responsible to fetch the account recovery user data
+};
+export default withAppContext(AccountRecoveryUserContextProvider);
+
+/**
+ * Resource Workspace Context Consumer HOC
+ * @param WrappedComponent
+ */
+export function withAccountRecovery(WrappedComponent) {
+  return class WithAccountRecovery extends React.Component {
+    render() {
+      return (
+        <AccountRecoveryUserContext.Consumer>
+          {
+            accountRecoveryContext => <WrappedComponent accountRecoveryContext={accountRecoveryContext} {...this.props} />
+          }
+        </AccountRecoveryUserContext.Consumer>
+      );
+    }
+  };
+}

package/src/react-extension/contexts/AccountRecoveryUserContext.test.data.js

@@ -0,0 +1,55 @@
+/**
+ * Passbolt ~ Open source password manager for teams
+ * Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ *
+ * Licensed under GNU Affero General Public License version 3 of the or any later version.
+ * For full copyright and license information, please see the LICENSE.txt
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ * @license       https://opensource.org/licenses/AGPL-3.0 AGPL License
+ * @link          https://www.passbolt.com Passbolt(tm)
+ * @since         3.6.0
+ */
+
+import {defaultAppContext} from "../contexts/ExtAppContext.test.data";
+
+export const defaultOrganizationAccountRecoveryPolicy = (data = {}) => {
+  const defaultData = {
+    policy: 'opt-out',
+    account_recovery_organization_public_key: {
+      armored_key: "-----BEGIN PGP PUBLIC KEY BLOCK-----\r\n\r\nmQINBFXHTB8BEADAaRMUn++WVatrw3kQK7\/6S6DvBauIYcBateuFjczhwEKXUD6T\r\nhLm7nOv5\/TKzCpnB5WkP+UZyfT\/+jCC2x4+pSgog46jIOuigWBL6Y9F6KkedApFK\r\nxnF6cydxsKxNf\/V70Nwagh9ZD4W5ujy+RCB6wYVARDKOlYJnHKWqco7anGhWYj8K\r\nKaDT+7yM7LGy+tCZ96HCw4AvcTb2nXF197Btu2RDWZ\/0MhO+DFuLMITXbhxgQC\/e\r\naA1CS6BNS7F91pty7s2hPQgYg3HUaDogTiIyth8R5Inn9DxlMs6WDXGc6IElSfhC\r\nnfcICao22AlM6X3vTxzdBJ0hm0RV3iU1df0J9GoM7Y7y8OieOJeTI22yFkZpCM8i\r\ntL+cMjWyiID06dINTRAvN2cHhaLQTfyD1S60GXTrpTMkJzJHlvjMk0wapNdDM1q3\r\njKZC+9HAFvyVf0UsU156JWtQBfkE1lqAYxFvMR\/ne+kI8+6ueIJNcAtScqh0LpA5\r\nuvPjiIjvlZygqPwQ\/LUMgxS0P7sPNzaKiWc9OpUNl4\/P3XTboMQ6wwrZ3wOmSYuh\r\nFN8ez51U8UpHPSsI8tcHWx66WsiiAWdAFctpeR\/ZuQcXMvgEad57pz\/jNN2JHycA\r\n+awesPIJieX5QmG44sfxkOvHqkB3l193yzxu\/awYRnWinH71ySW4GJepPQARAQAB\r\ntB9BZGEgTG92ZWxhY2UgPGFkYUBwYXNzYm9sdC5jb20+iQJOBBMBCgA4AhsDBQsJ\r\nCAcDBRUKCQgLBRYCAwEAAh4BAheAFiEEA\/YOlY9MspcjrN92E1O1sV2bBU8FAl0b\r\nmi8ACgkQE1O1sV2bBU+Okw\/\/b\/PRVTz0\/hgdagcVNYPn\/lclDFuwwqanyvYu6y6M\r\nAiLVn6CUtxfU7GH2aSwZSr7D\/46TSlBHvxVvNlYROMx7odbLgq47OJxfUDG5OPi7\r\nLZgsuE8zijCPURZTZu20m+ratsieV0ziri+xJV09xJrjdkXHdX2PrkU0YeJxhE50\r\nJuMR1rf7EHfCp45nWbXoM4H+LnadGC1zSHa1WhSJkeaYw9jp1gh93BKD8+kmUrm6\r\ncKEjxN54YpgjFwSdA60b+BZgXbMgA37gNQCnZYjk7toaQClUbqLMaQxHPIjETB+Z\r\njJNKOYn740N2LTRtCi3ioraQNgXQEU7tWsXGS0tuMMN7w4ya1I6sYV3fCtfiyXFw\r\nfuYnjjGzn5hXtTjiOLJ+2kdy5OmNZc9wpf6IpKv7\/F2RUwLsBUfH4ondNNXscdkB\r\n6Zoj1Hxt16TpkHnYrKsSWtoOs90JnlwYbHnki6R\/gekYRSRSpD\/ybScQDRASQ0aO\r\nhbi71WuyFbLZF92P1mEK5GInJeiFjKaifvJ8F+oagI9hiYcHgX6ghktaPrANa2De\r\nOjmesQ0WjIHirzFKx3avYIkOFwKp8v6KTzynAEQ8XUqZmqEhNjEgVKHH0g3sC+EC\r\nZ\/HGLHsRRIN1siYnJGahrrkNs7lFI5LTqByHh52bismY3ADLemxH6Voq+DokvQn4\r\nHxS5Ag0EVcdMHwEQAMFWZvlswoC+dEFISBhJLz0XpTR5M84MCn19s\/ILjp6dGPbC\r\nvlGcT5Ol\/wL43T3hML8bzq18MRGgkzhwsBkUXO+E7jVePjuGFvRwS5W+QYwCuAmw\r\nDijDdMhrev1mrdVK61v\/2U9kt5faETW8ZIYIvAWLaw\/lMHbVmKOa35ZCIJWcNsrv\r\noro2kGUklM6Nq1JQyU+puGPHuvm+1ywZzpAH5q55pMgfO+9JjMU3XFs+eqv6LVyA\r\n\/Y6T7ZK1H8inbUPm\/26sSvmYsT\/4xNVosC\/ha9lFEAasz\/rbVg7thffje4LWOXJB\r\no40iBTlHsNbCGs5BfNC0wl719JDA4V8mwhGInNtETCrGwg3mBlDrk5jYrDq5IMVk\r\nyX4Z6T8Fd2fLHmUr2kFc4vC96tGQGhNrbAa\/EeaAkWMeFyp\/YOW0Z3X2tz5A+lm+\r\nqevJZ3HcQd+7ca6mPTrYSVVXhclwSkyCLlhRJwEwSxrn+a2ZToYNotLs1uEy6tOL\r\nbIyhFBQNsR6mTa2ttkd\/89wJ+r9s7XYDOyibTQyUGgOXu\/0l1K0jTREKlC91wKkm\r\ndw\/lJkjZCIMc\/KTHiB1e7f5NdFtxwErToEZOLVumop0FjRqzHoXZIR9OCSMUzUmM\r\nspGHalE71GfwB9DkAlgvoJPohyiipJ\/Paw3pOytZnb\/7A\/PoRSjELgDNPJhxABEB\r\nAAGJAjYEGAEKACACGwwWIQQD9g6Vj0yylyOs33YTU7WxXZsFTwUCXRuaPgAKCRAT\r\nU7WxXZsFTxX0EADAN9lreHgEvsl4JK89JqwBLjvGeXGTNmHsfczCTLAutVde+Lf0\r\nqACAhKhG0J8Omru2jVkUqPhkRcaTfaPKopT2KU8GfjKuuAlJ+BzH7oUq\/wy70t2h\r\nsglAYByv4y0emwnGyFC8VNw2Fe+Wil2y5d8DI8XHGp0bAXehjT2S7\/v1lEypeiiE\r\nNbhAnGG94Zywwwim0RltyNKXOgGeT4mroYxAL0zeTaX99Lch+DqyaeDq94g4sfhA\r\nVvGT2KJDT85vR3oNbB0U5wlbKPa+bUl8CokEDjqrDmdZOOs\/UO2mc45V3X5RNRtp\r\nNZMBGPJsxOKQExEOZncOVsY7ZqLrecuR8UJBQnhPd1aoz3HCJppaPI02uINWyQLs\r\nCogTf+nQWnLyN9qLrToriahNcZlDfuJCRVKTQ1gw1lkSN3IZRSkBuRYRe05US+C6\r\n8JMKHP+1XMKMgQM2XR7r4noMJKLaVUzfLXuPIWH2xNdgYXcIOSRjiANkIv4O7lWM\r\nxX9vD6LklijrepMl55Omu0bhF5rRn2VAubfxKhJs0eQn69+NWaVUrNMQ078nF+8G\r\nKT6vH32q9i9fpV38XYlwM9qEa0il5wfrSwPuDd5vmGgk9AOlSEzY2vE1kvp7lEt1\r\nTdb3ZfAajPMO3Iov5dwvm0zhJDQHFo7SFi5jH0Pgk4bAd9HBmB8sioxL4Q==\r\n=Kwft\r\n-----END PGP PUBLIC KEY BLOCK-----"
+    },
+    creator: {
+      username: "ada@passbolt.com",
+      profile: {
+        first_name: "ada",
+        last_name: "lovelace"
+      },
+      gpgkey: {
+        user_id: "fa69d48f-1a3d-4f9f-b7a0-709dce039e96",
+        armored_key: "faked armored key",
+        fingerprint: "848E95CC7493129AD862583129B81CA8936023DD"
+      }
+    },
+    modified: "2022-01-13T13:19:04.661Z"
+  };
+
+  return Object.assign(defaultData, data);
+};
+
+/**
+ * Default context
+ * @param {Object} appContext The props to override
+ * @returns {object}
+ */
+export const defaultProps = (data = {}) => {
+  const defaultData = {
+    context: defaultAppContext(data?.context),
+    accountRecoveryUserService: {
+      getOrganizationAccountRecoverySettings: jest.fn(() => defaultOrganizationAccountRecoveryPolicy())
+    }
+  };
+  delete data.context;
+  return Object.assign(defaultData, data);
+};

package/src/react-extension/contexts/AccountRecoveryUserContext.test.js

@@ -0,0 +1,58 @@
+/**
+ * Passbolt ~ Open source password manager for teams
+ * Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ *
+ * Licensed under GNU Affero General Public License version 3 of the or any later version.
+ * For full copyright and license information, please see the LICENSE.txt
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ * @license       https://opensource.org/licenses/AGPL-3.0 AGPL License
+ * @link          https://www.passbolt.com Passbolt(tm)
+ * @since         3.6.0
+ */
+
+import React from "react";
+import {renderIntoDocument} from 'react-dom/test-utils';
+import {AccountRecoveryUserContextProvider} from "./AccountRecoveryUserContext";
+import {defaultOrganizationAccountRecoveryPolicy, defaultProps} from "./AccountRecoveryUserContext.test.data";
+
+describe("AccountRecoveryUser Context", () => {
+  const organizationAccountRecoveryPolicy = defaultOrganizationAccountRecoveryPolicy();
+
+  it('should called the given accountRecoveryUserService and be able to give back the data to the context consumers', async() => {
+    const props = defaultProps({
+      context: {
+        loggedInUser: {
+          account_recovery_user_setting: {
+            status: "rejected"
+          }
+        }
+      }
+    });
+
+    //Using renderIntoDocument allows us to call the component methods and the component to have a working (react) state
+    const component = renderIntoDocument(<AccountRecoveryUserContextProvider {...props}/>);
+    await component.findAccountRecoveryPolicy();
+
+    expect.assertions(6);
+    expect(props.accountRecoveryUserService.getOrganizationAccountRecoverySettings).toHaveBeenCalled();
+    expect(component.getRequestor()).toStrictEqual(organizationAccountRecoveryPolicy.creator);
+    expect(component.getRequestedDate()).toBe(organizationAccountRecoveryPolicy.modified);
+    expect(component.getPolicy()).toBe(organizationAccountRecoveryPolicy.policy);
+    expect(component.getOrganizationPolicy()).toStrictEqual(organizationAccountRecoveryPolicy);
+    expect(component.isAccountRecoveryChoiceRequired()).toBe(false);
+  });
+
+  it('should assume the account recovery user settings status is "pending" by default when the data is not set on the logged in user', async() => {
+    const props = defaultProps();
+
+    //Using renderIntoDocument allows us to call the component methods and the component to have a working (react) state
+    const component = renderIntoDocument(<AccountRecoveryUserContextProvider {...props}/>);
+    await component.findAccountRecoveryPolicy();
+
+    expect.assertions(2);
+    expect(component.getUserAccountRecoverySubscriptionStatus()).toBe("pending");
+    expect(component.isAccountRecoveryChoiceRequired()).toBe(true);
+  });
+});

package/src/react-extension/contexts/ActionFeedbackContext.test.data.js

@@ -0,0 +1,28 @@
+/**
+ * Passbolt ~ Open source password manager for teams
+ * Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ *
+ * Licensed under GNU Affero General Public License version 3 of the or any later version.
+ * For full copyright and license information, please see the LICENSE.txt
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ * @license       https://opensource.org/licenses/AGPL-3.0 AGPL License
+ * @link          https://www.passbolt.com Passbolt(tm)
+ * @since         3.6.0
+ */
+
+/**
+ * Returns the default action feedback context context for the unit test
+ * @param {object} [data] An override action feedback context context properties
+ * @returns {object}
+ */
+
+export function defaultActionFeedbackContextContext(data = {}) {
+  const defaultContext = {
+    displaySuccess: jest.fn(),
+    displayError: jest.fn(),
+    remove: jest.fn(),
+  };
+  return Object.assign(defaultContext, data);
+}

package/src/react-extension/contexts/AdminAccountRecoveryContext.js

@@ -0,0 +1,211 @@
+/**
+ * Passbolt ~ Open source password manager for teams
+ * Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ *
+ * Licensed under GNU Affero General Public License version 3 of the or any later version.
+ * For full copyright and license information, please see the LICENSE.txt
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ * @license       https://opensource.org/licenses/AGPL-3.0 AGPL License
+ * @link          https://www.passbolt.com Passbolt(tm)
+ * @since         3.6.0
+ */
+
+import React from "react";
+import PropTypes from "prop-types";
+import {withAppContext} from "./AppContext";
+
+export const AdminAccountRecoveryContext = React.createContext({
+  currentPolicy: null, // The current policy
+  policyChanges: {}, // The policy changes
+  findAccountRecoveryPolicy: () => {}, // Find the current policy and store it in the state
+  getKeyInfo: () => {}, // Request an amored key info
+  changePolicy: () => {}, // Change the policy type
+  changePublicKey: () => {}, // Change the policy public key
+  hasPolicyChanges: () => {}, // Check if the policy has changes
+  resetChanges: () => {}, // Reset the changes made on the policy
+  downloadPrivateKey: () => {}, // Download the generated new policy private key
+  save: () => {}, // Save the policy changes
+});
+
+/**
+ * The related context provider
+ */
+export class AdminAccountRecoveryContextProvider extends React.Component {
+  /**
+   * Default constructor
+   * @param props The component props
+   */
+  constructor(props) {
+    super(props);
+    this.state = this.defaultState;
+  }
+
+  /**
+   * Returns the default component state
+   */
+  get defaultState() {
+    return {
+      currentPolicy: null, // The current policy
+      policyChanges: {}, // The policy changes
+      findAccountRecoveryPolicy: this.findAccountRecoveryPolicy.bind(this), // Find the current policy and store it in the state
+      getKeyInfo: this.getKeyInfo.bind(this), // Request an amored key info
+      changePolicy: this.changePolicy.bind(this), // Change the policy type
+      changePublicKey: this.changePublicKey.bind(this), // Change the policy public key
+      hasPolicyChanges: this.hasPolicyChanges.bind(this), // Check if the policy has changes
+      resetChanges: this.resetChanges.bind(this), // Reset the changes made on the policy
+      downloadPrivateKey: this.downloadPrivateKey.bind(this), // Download the generated new policy private key
+      save: this.save.bind(this), // Save the policy changes
+    };
+  }
+
+  /**
+   * Find the account recovery policy
+   * @return {Promise<void>}
+   */
+  async findAccountRecoveryPolicy() {
+    if (!this.props.context.siteSettings.canIUse('accountRecovery')) {
+      return;
+    }
+    const currentPolicy = await this.props.context.port.request("passbolt.account-recovery.get-organization-policy");
+    this.setState({currentPolicy});
+  }
+
+  /**
+   * Change the policy
+   * @param {string} policy The new policy. Any of: mandatory, opt-out, opt-in, disable.
+   * @return {Promise<void>}
+   */
+  async changePolicy(policy) {
+    const policyChanges = this.state.policyChanges;
+
+    // If same policy than the current one, remove it from the changes if any.
+    if (policy === this.state.currentPolicy?.policy) {
+      delete policyChanges.policy;
+    } else {
+      policyChanges.policy = policy;
+    }
+
+    // If disabled policy, remove any public key change from the changes.
+    if (policy === "disabled") {
+      delete policyChanges.publicKey;
+    }
+
+    await this.setState({policyChanges});
+  }
+
+  /**
+   * Change the public key
+   * @param {string} publicKey The new public key in armored format.
+   * @returns {Promise<void>}
+   */
+  async changePublicKey(publicKey) {
+    const policyChanges = {...this.state.policyChanges, publicKey};
+    await this.setState({policyChanges});
+  }
+
+  /**
+   * Check if there are changes to apply
+   * @returns {Boolean}
+   */
+  hasPolicyChanges() {
+    return Boolean(this.state.policyChanges?.publicKey)
+      || Boolean(this.state.policyChanges?.policy);
+  }
+
+  /**
+   * Get the key info.
+   * @param {object} armoredKey The account recovery organization key
+   * @returns {Promise<object>} The key info dto
+   */
+  async getKeyInfo(armoredKey) {
+    if (!armoredKey) {
+      return null;
+    }
+
+    return this.props.context.port.request('passbolt.keyring.get-key-info', armoredKey);
+  }
+
+  /**
+   * Reset the policy changes
+   */
+  async resetChanges() {
+    const policyChanges = {};
+    await this.setState({policyChanges});
+  }
+
+  /**
+   * Whenever the user wants to download the newly generated organization private key
+   * @param {string} privateKey The organization private key
+   * @returns {Promise<void>}
+   */
+  async downloadPrivateKey(privateKey) {
+    await this.props.context.port.request("passbolt.account-recovery.download-organization-generated-key", privateKey);
+  }
+
+  /**
+   * Whenever the save has been requested
+   * @param {string} privateGpgKeyDto The current organization private key
+   */
+  async save(privateGpgKeyDto) {
+    const policySaveDto = this.buildPolicySaveDto();
+    const currentPolicy = await this.props.context.port.request('passbolt.account-recovery.save-organization-policy', policySaveDto, privateGpgKeyDto);
+    const policyChanges = {};
+    this.setState({currentPolicy, policyChanges});
+  }
+
+  /**
+   * Build the policy save dto.
+   * @returns {object}
+   */
+  buildPolicySaveDto() {
+    const policySaveDto = {};
+    if (this.state.policyChanges.policy) {
+      policySaveDto.policy = this.state.policyChanges.policy;
+    }
+    if (this.state.policyChanges.publicKey) {
+      policySaveDto.account_recovery_organization_public_key = {
+        armored_key: this.state.policyChanges.publicKey
+      };
+    }
+    return policySaveDto;
+  }
+
+  /**
+   * Render the component
+   * @returns {JSX}
+   */
+  render() {
+    return (
+      <AdminAccountRecoveryContext.Provider value={this.state}>
+        {this.props.children}
+      </AdminAccountRecoveryContext.Provider>
+    );
+  }
+}
+
+AdminAccountRecoveryContextProvider.propTypes = {
+  context: PropTypes.any, // The application context
+  children: PropTypes.any // The children components
+};
+export default withAppContext(AdminAccountRecoveryContextProvider);
+
+/**
+ * Resource Workspace Context Consumer HOC
+ * @param WrappedComponent
+ */
+export function withAdminAccountRecovery(WrappedComponent) {
+  return class WithAdminAccountRecovery extends React.Component {
+    render() {
+      return (
+        <AdminAccountRecoveryContext.Consumer>
+          {
+            adminAccountRecoveryContext => <WrappedComponent adminAccountRecoveryContext={adminAccountRecoveryContext} {...this.props} />
+          }
+        </AdminAccountRecoveryContext.Consumer>
+      );
+    }
+  };
+}
+

package/src/react-extension/contexts/AdminAccountRecoveryContext.test.data.js

@@ -0,0 +1,66 @@
+/**
+ * Passbolt ~ Open source password manager for teams
+ * Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ *
+ * Licensed under GNU Affero General Public License version 3 of the or any later version.
+ * For full copyright and license information, please see the LICENSE.txt
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) 2022 Passbolt SA (https://www.passbolt.com)
+ * @license       https://opensource.org/licenses/AGPL-3.0 AGPL License
+ * @link          https://www.passbolt.com Passbolt(tm)
+ * @since         3.6.0
+ */
+
+import {defaultAppContext} from "./ExtAppContext.test.data";
+
+/**
+ * Default context
+ * @param {Object} context The override
+ * @returns {object}
+ */
+export function defaultAdminAccountRecoveryContext(context = {}) {
+  const defaultKeyInfo = {
+    amored_key: "armored-key"
+  };
+  const defaultContext = {
+    currentPolicy: {policy: "disabled"},
+    policyChanges: {},
+    findAccountRecoveryPolicy: jest.fn(),
+    getKeyInfo: jest.fn(() => defaultKeyInfo),
+    hasPolicyChanges: jest.fn(),
+    changePolicy: jest.fn(),
+    changePublicKey: jest.fn(),
+    resetChanges: jest.fn(),
+    save: jest.fn()
+  };
+  return Object.assign(defaultContext, context);
+}
+
+/**
+ * Has policy changes context
+ * @param {Object} context The override
+ * @returns {object}
+ */
+export function hasPolicyChangesAdminAccountRecoveryContext(context = {}) {
+  const defaultContext = {
+    policyChanges: {
+      policy: "opt-in",
+      publicKey: "new-public-key"
+    },
+    hasPolicyChanges: jest.fn(() => true)
+  };
+  return defaultAdminAccountRecoveryContext(Object.assign(defaultContext, context));
+}
+
+/**
+ * Default props.
+ * @param {Object} props The props to override
+ * @returns {object}
+ */
+export function defaultProps(props = {}) {
+  const defaultProps = {
+    context: defaultAppContext(props?.appContext)
+  };
+  return Object.assign(defaultProps, props);
+}