Admins

This is a quickstart guide for Fordefi admins.

This page instructs youโ€”the organization administratorโ€”in successfully and securely setting up your organization's Fordefi account, including accessing the web console, installing the Fordefi mobile app, configuring your security policy and backup, and preparing the organization for trading.

Before you start

Two things before you get started:

  1. Have Fordefi Support send you an email invitation to join an organization.
  2. Ensure you have the latest version of Google Chrome. Currently, the Fordefi extension supports Chrome only. Note, also, that since our extension cannot be used in parallel with MetaMask in the same Chrome profile, you should either:
    • Disable MetaMask while using Fordefi, or
    • Proceed with these instructions in a new Chrome profile, which you will use especially for Fordefi.

There are several phases in the setup.

Join the organization

  1. Click Join organization in the email that you received from Fordefi Support.
  1. In the web page that opens in Chrome, create a new account using one of the following:

    • The predefined email and a password you choose.
    • A web authentication service: Google, Microsoft, or Apple.

    The Fordefi web page opens, displaying the following notification:

  2. Do not close this browser window. You'll come back to it later.

๐Ÿ“˜

Multiple organizations

If you are already a member of an existing organization in Fordefi, and you are setting up an additional organization, you can log in with the same credentials you use to access your existing Fordefi organization.

Install Fordefi mobile app and log in

Perform the next few instructions on your mobile device.

These steps accomplish two things:

  • Verify your mobile device to approve transactions that begin in the web console. Learn more about trusted devices.
  • Set up the Fordefi mobile app on your mobile device.
  1. Use the camera app in your mobile device to scan the QR code that is displayed in the previous step. The link should lead you to the Fordefi app entry either in Google's Play Store or Apple's App Store, depending on your device type.
  2. Install the Fordefi app from the store.
  3. Log in to the app. Either type in your email and password, or tap the authentication service provider you used to set up your account on the web (in step 2 of the previous section).
  4. Follow the instructions in the app. When you see the following screen, the mobile app has been successfully set up.

๐Ÿ“˜

Your private keys have been generated

As part of this process, your mobile app and Fordefi's servers run a Distributed Key Generation MPC protocol that creates your private keys.

Proceed to the Fordefi web console

  1. Return to the web browser window and click Click here after mobile activation.
  2. In the Fordefi web console that is displayed, perform the actions described in the following sections.

Enable 2FA for login

To add a second factor of authentication login for all users of the the organization, contact Fordefi support.

Invite additional admins

  1. Add at least one additional admin to your organization. In the web console, choose User Management > Add user.
  1. Specify the user's email address, select Admin in the Role list, then click Invite.

  2. Follow the stages as shown:

    • Wait for admin quorum approval.
    • Generate a security code on your mobile device to share with the new user.
    • Wait for the user to enter the security code, then activate the account.

    Instruct the new users to perform the steps needed on their side. Details are in Quickstart - Traders.

Back up your private keys

It is imperative that you back up your organization's private keys as soon as you activate your Fordefi account.

  1. Ensure that you have added at least one additional admin to your organization.
  2. Follow the instructions here.

๐Ÿ“˜

Back up within seven days

After you activate your organization, you are required to perform a backup of your private keys within seven days. If seven days have elapsed without a backup, your organization will be prevented from performing "create transaction" and "create vault" actions.

Raise the Admin Quorum number

๐Ÿ“˜

How many approvers should your admin quorum have?

We strongly recommend setting the Admin Quorum number to two or higher, to prevent any individual admin from being a single point of failure. We also recommend adding redundancy by having a higher number of admins in the organization than the number in the Admin Quorum. Practically: we recommend having three or more admins in the organization, then you can safely set your Admin Quorum to two.

  1. Add at least one additional approver to the Admin Quorum. Choose Settings > Admin Quorum > Change quorum.
  2. In the dialog that opens, increase the quorum to at least two. Click Save.

A notification is displayed, showing that the quorum modification is pending approval.

Modify the default policy

Your organization already has a built-in, default transaction policy, which allows all transactions, without approval. Consider modifying this default policy, as follows:

  1. In the web console, choose Policies > Edit policy > Create Rule. This dialog is displayed:
  1. Specify details for a policy rule that suits your organization, then click Save. In the dialog that appears, click Send for review.
  2. If you raised the admin quorum, a notification is displayed, showing that the policy modification is pending the approval of the quorum.

Learn more about setting policies by studying these best-practice samples.

Create your first vault and add funds

  1. Open the Fordefi web console and click Vaults in the side menu.
  2. Click Create a Vault in the upper right corner of the screen.
    The following dialog is displayed:
  1. Enter a name for the vault, choose the vault type from the list, and choose a vault group from the list.

    ๐Ÿ“˜

    Vault groups

    A vault must belong to a vault group and can belong to one vault group only. If you do not not assign the new vault to a vault group, it is assigned to the Default vault group.

  2. Click Create.
    The vault is added to the list of vaults.
  3. Copy the address of the newly created vault, and use it to transfer funds into the vault from an external source.

Install the browser extension

  1. Go to the Fordefi extension page in the Chrome Web Store.
  2. Click Add to Chrome.
  3. Click Extensions in the upper-right corner of Chrome.
    A list opens, displaying the extensions that are installed and enabled in Chrome.ย 
  1. Click the pushpin icon next to Fordefi to pin the extension in the toolbar.
  1. Open the extension.

Update the browser extension

The Fordefi browser extension must be updated on occasion. To ensure you have the latest version:

  1. Click Extensions in the upper-right corner of Chrome.
    A list opens, displaying the extensions that are installed and enabled.
  2. Click Manage Extensions.
    In the screen that is displayed, turn on Developer Mode in the upper-right corner.
  3. Click Update.
  4. Once the browser extension has been successfully updated, refresh all of the DApp tabs in the browser.

Transact

Using the extension, create a transaction to test that all parts of the system are set up and working.