Introduction

Users can have multiple identities or DIDs on Polymesh, and multiple keys associated with each DID (although keys can only be associated with one DID). However, not all keys are of the same kind.

Users can optionally configure secondary keys to permit access to specific things on-chain. Like primary keys, a secondary key can sign transactions on behalf of an identity, but its permissions are limited to only certain actions, portfolios, or assets. Secondary keys can be added or removed by the primary key of its identity at any time. Learn more about secondary keys here.

Please note that onboarding to Polymesh with a new account is a different process.
To onboard to Polymesh, follow the process here: How to onboard to Polymesh Mainnet

Assign a Secondary Key on the Polymesh Portal

Step 1 - Primary key owner to create an authorization

With your primary key selected, open the Authorizations page on the Polymesh Portal and create a new authorization by clicking on the Create New Auth button:

A popup window will appear, fill in the data as per below:

• Authorization Type: Select Join Identity.
• Target Account: Enter the secondary key (on Polymesh Mainnet, the key begins with 2) you want to add.
• Expiry Date (Optional): This is an optional field if you want to enter an expiry date for this authorization.

Once all data are filled, click on the Create button and sign the transaction with your wallet.
Now you will see an outgoing authorization request:

Step 2 - Secondary key owner to accept incoming authorization

With the secondary key selected, open the Authorizations page on the Polymesh Portal and look for incoming authorizations, then click on the Approve button and sign the transaction with your wallet:

Remove a secondary key on the Polymesh Portal

Only the associated primary key can remove secondary keys.
In order to remove a secondary key, head over to the Details page on the Polymesh Portal then
click on the Details button under your DID:

You can remove a Secondary key by selecting it and clicking on the Remove Keys button:

If you have any questions or issues, feel free to open a conversation with our support team through the Polymesh Community page.