Skip to main content

Regenerate API keys for your transaction node

Each transaction node of your Quorum Blockchain Service (QBS) member has two API keys which enable you to control access to the node. Additionally, your QBS member has two API keys which provide access to all transaction nodes in your member. See API Keys in Data Security for more information.

Periodically rotating your API keys by regenerating new ones keeps access to your transaction nodes secure in the event that an API key is compromised.

caution

Regenerating the API keys of your transaction node requires you to udpate the connection string for any tools or applications that connect to your transaction node.

Retrieve your existing API keys​

You can use the QBS management API to view the existing API keys for the transaction nodes of your QBS member. Select Authorize on the API website to authorize running the APIs.

note

In this example, we retrieve and rotate the API keys for the transaction node. You can also retrieve and rotate the API keys for the QBS member using the QBS management API.

Authorize API

Once you authorize the API, select the GET request for List the API keys for the transaction node under the TransactionNodes section, and select Try it out.

Try it out

In the fields for the API request, fill out the following using your QBS member information:

  • subscriptionID - Your subscription ID, in the Overview tab for your QBS member, under the Essentials section.

  • resourceGroupName - The resource group to which your QBS member is deployed. Note this is NOT the Managed Application resource group.

  • blockchainMemberName - The name of your QBS member, also known as the name of your Managed Application, located in the upper-left corner of the Overview tab.

  • transactionNodeName - The name of the transaction node whose keys you want to regenerate. If you forgot your transaction node name, you can retrieve it following these steps.

Overview Page

Regenerate API keys​

Select the POST request for Regenerate the API keys for the transaction node under the TransactionNodes section, and select Try it out.

Get transaction node

View the Response body of the output of the API to retrieve the new keys listed in order to change your connection string for any tools or applications that connect to your transaction node.