> For the complete documentation index, see [llms.txt](https://docs-launchpad.energyweb.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-launchpad.energyweb.org/energy-solutions/digital-spine-by-energy-web/component-guides/ddhub-client-gateway/deployment-guide/preparing-to-set-up-a-client-gateway/acquiring-an-enterprise-user-role/request-role-using-switchboard.md).

# Request role using Switchboard

{% hint style="warning" %}
Before continuing with this section, please ensure that an [EWC Account](/energy-solutions/digital-spine-by-energy-web/component-guides/ddhub-client-gateway/deployment-guide/preparing-to-set-up-a-client-gateway/creating-and-funding-an-ewc-account.md) has been prepared and that it has enough [EWT to fund](/energy-solutions/digital-spine-by-energy-web/component-guides/ddhub-client-gateway/deployment-guide/preparing-to-set-up-a-client-gateway/creating-and-funding-an-ewc-account.md#funding-an-ewc-account) the on-chain transactions.
{% endhint %}

To acquire the application-level enterprise user roles, simply visit the [Switchboard](https://switchboard.energyweb.org/) web dApp and follow below steps:

1. Connect your EWC Account using [Metamask](https://metamask.io/)

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeg_zebR2slJ2JXZ1tzPg4A5WEusjUuDjiZU6UcCwP3iGDHTigTp-vkKsZ6cHfibJrUHF7Gucm9Vd57cCSVGypku_bcAlMvU0nrDT8hBfX82VZUYiekRtn1xzdfopy5QJ5-0OzN?key=mGFbmWWG1dkMmk1SuvbdKA" alt=""><figcaption></figcaption></figure>

2. Confirm the sign-in request

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdzwYdvyB6L9oQ26qNH7DjIlE9S_LOZ1h8IUW6ryyOWxXnTnjJffZTEeRw52HkCX4PiOTJrQBb6QtiV-A5J8n20xkPtYAz2jSGHRB-inif_5CzD3QUdng_e10svEMMISdycUrFJ?key=mGFbmWWG1dkMmk1SuvbdKA" alt=""><figcaption></figcaption></figure>

3. Confirm the signature request

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeYCZ0kayURtXKCITm2k5U3KwDLUHyD2-aVk5X6ZvLIkXKGjjwU0MNUkQD_f2KOnGLJ1XVyeP34EMC1HlHOoD-bkmjf6Oeocewv-DmO9Ive8EipaFTB5gnQOqbC2yeP2WsDKrSV?key=mGFbmWWG1dkMmk1SuvbdKA" alt=""><figcaption></figcaption></figure>

4. The screen redirects to the dashboard where the DID of the enterprise user is displayed as highlighted in the red box

   <figure><img src="/files/KqRGLYl3Bg6NrVbUMKew" alt=""><figcaption></figcaption></figure>

5. Search for the application namespace which contains the target role in the search bar provided. The search result will be displayed on a list. Click on the result item to view the application details including the list of available roles.\
   \
   :information\_source: :person\_tipping\_hand: \
   For this example, let's use the EW Digital Spine Message Broker application namespace (`dsmb.apps.ddhub.energyweb.auth.ewc`).\
   &#x20;&#x20;

   <figure><img src="/files/GcNBWpWICJEgrTwxEa7H" alt=""><figcaption></figcaption></figure>

6. The screen displays the application details including the list of available roles. Click on the "Enrol" icon as highlighted in the second screenshot below.\
   \
   :information\_source: :person\_tipping\_hand: \
   For this example, the EW Digital Spine Message Broker application has two available roles: `user` and `topiccreator`<br>

   <figure><img src="/files/E88VHbiTAdYuMojcPsYY" alt=""><figcaption></figcaption></figure>

   <figure><img src="/files/3T5y4MkOPmCQ89aHd7X9" alt=""><figcaption></figcaption></figure>

7. The enrolment screen will be displayed. Input the target values to the enrolment fields provided. Then, click "Submit Request" button.

   <figure><img src="/files/thRc2OnKCdZFVH2PxYKN" alt=""><figcaption></figcaption></figure>

8. Confirm the requested transactions

   <figure><img src="/files/ghP79x0SH935QUDxlcFL" alt=""><figcaption></figcaption></figure>

   <figure><img src="/files/eyeQjR8I467VXzOHhr6Y" alt=""><figcaption></figcaption></figure>

9. After successful confirmation of the enrolment request transactions, the screen redirects to "My Enrolments" page which shows the list of role requests together with their respective status.\
   \
   :information\_source: :person\_tipping\_hand: \
   Newly requested roles will have the <mark style="color:orange;">`Pending`</mark> status. This means that the role request is waiting for the approval from the verifiable credentials issuers who are typically the administrators of the application namespace.<br>

   <figure><img src="/files/tivguV6IpKPZepPHHMe2" alt=""><figcaption></figcaption></figure>

10. Once the status has changed to <mark style="color:green;">`Approved`</mark>, the role is now ready to be published as a [VC](/energy-solutions/digital-spine-by-energy-web/component-guides/ddhub-client-gateway/deployment-guide/self-hosted.md#self-sovereign-identities) in the DID Document of the enterprise user. Only the published VC is honoured in the Digital Spine ecosystem. To publish, simply click on the "Publish" icon as shown in the illustration below.<br>

    <figure><img src="/files/u0LjcRhUV446tDogIQT3" alt=""><figcaption></figcaption></figure>

11. Confirm the action

    <figure><img src="/files/Y7RAASOxMu5qmPWrBTgQ" alt=""><figcaption></figcaption></figure>

12. Confirm the transactions prompted in your wallet account

    <figure><img src="/files/Fz06seOTMcov6f4cuym6" alt=""><figcaption></figcaption></figure>

13. Once the transactions are confirmed, the "Publish" icon will disappear. This means that the VC has been published successfully.

    <figure><img src="/files/xSUbCQdkhqKkKWAVG7wD" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs-launchpad.energyweb.org/energy-solutions/digital-spine-by-energy-web/component-guides/ddhub-client-gateway/deployment-guide/preparing-to-set-up-a-client-gateway/acquiring-an-enterprise-user-role/request-role-using-switchboard.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.