Skip to main content
Version: 3.1 (latest)

First Setup

A Group Administrator (Group Admin) manages 'groups' - groups of users in the marketplace instance. As a Group Admin, you can invite marketplace users into your group or fellow Group Admins.

There is no separate user interface for Group Admins. Instead, a separate 'Group' section will appear on the left panel of the marketplace for all Group Admin-related actions.

First Setup

A Group Owner is the first admin of the group. This account cannot be deleted by other Group Admins unless the Group Owner rights have been transferred to another Group Admin.

If the Instance enforces the use of both SSO and Group Wallet, no additional setup is required aside from setting up the Group Owner account - the first admin account for the group.

1. If the Instance Enforces the Use of Both SSO and Group Wallet

If the Instance enforces the use of both SSO and Group Wallet at the instance level, you must simply authenticate yourself using the SSO configured in the instance. A smart account wallet is then automatically created and assigned to your group without any additional configurations required.

  1. As the Group Owner, you will receive an email notification that your group has been invited to the marketplace instance.
  2. Authenticate using your Instance’s SSO.
  3. You can then start logging in to the marketplace.

2. If the Instance Does Not Enforce the Use of Either SSO or Group Wallet

If neither SSO nor Group Wallet is enabled at the instance level, you must make sure that your intent is communicated to the Instance Administrators on how you want your group to be configured. This depends on how the Instance Administrators set up the instance.

  • If the Instance does not enforce the use of SSO, you can also decide whether to enable this at the group level. If enabled, you can connect your group to your existing SSO identity provider. If not, local authentication will be used.
  • If the Instance does not enforce the use of Group Wallet, you can decide whether to enable this at the group level. If enabled, all users of the group will enjoy gas-free transactions and will use a shared wallet for any marketplace transactions. If not, individual wallets are required to be set up per user of the group.

The following scenarios are possible:

  • Set up the group with only SSO enabled.
  • Set up the group with only Group Wallet enabled.
  • Set up the group with both SSO and Group Wallet enabled.

a. Set up the Group with only SSO enabled

To set up the group with only SSO enabled:

  1. You will receive an email notification to complete the SSO setup.
  2. Copy the provided 'Redirect URL' into your identity provider.
  3. Retrieve the following information from your identity provider and paste it over the configuration screen:
    • Client ID
    • Client Secret
    • Authorization URL
    • Token URL
  4. Complete the setup and log in.

Note: You may need to log in twice to authenticate yourself as both the Group Owner user and a marketplace user.

b. Set up the Group with only Group Wallet enabled

To set up the group with only Group Wallet enabled:

  1. You will receive an email notification to set up your paymaster wallet for gas sponsorship.
  2. Complete your account setup on the marketplace instance by setting a password.
  3. Set up your account on Alchemy.
    • Create your paymaster.
    • Create your gas tank.
    • Optionally, top up your smart account.
  4. Retrieve the following information from Alchemy and paste it over the configuration screen:
    • Authorization Token
    • Paymaster API Key
    • Paymaster Setup Wallet
  5. Complete the setup and log in.

c. Set up the Group with both SSO and Group Wallet enabled

To set up the group with both SSO and Group Wallet enabled:

  1. Follow the same steps under "Set up the group with only SSO enabled."
  2. Log in using your SSO credentials.
  3. Follow the same steps under "Set up the group with only Group Wallet enabled."

Group Profile Management

As a Group Admin, you can update certain information in your group's profile, such as the company logo, description, industry, and business contact email.

To edit the group profile:

  1. Log in to the marketplace.
  2. Click on 'Profile' under the 'Group Settings' section section of the left panel of the screen.
  3. Click 'Edit' on the section that you wish to update.
  4. Once you have updated the relevant fields, click on 'Save Changes.'

Note: To maintain accurate information and representation of groups, Group Admins can only update a limited set of information within your profile. If you wish to update other fields, please contact your Instance Administrator to make the changes.