Skip to content

Configure Application

In this tutorial, you will learn how to register and configure an application before integrating it with the Auth SDK.

Configure first, integrate later

The Arcana Developer Dashboard allows developers to customize the user onboarding experience and the blockchain transaction signing experience.

Developers can register and configure their app, and are given a unique identifier called an App Address. This is used to integrate an application with the Arcana Auth SDK.

Prerequisites

  • Developers must use the Arcana Developer Dashboard to configure the Auth SDK usage settings before integrating their application.

  • Log in to the Arcana Developer Dashboard using one of the social provider accounts listed below. Or use the password-free sign in option.

    • Google
    • GitHub
    • Twitch
    • Discord

Step 1: Developer Dashboard Login

Go to https://dashboard.arcana.network and select a login option on the welcome screen.

Welcome screen

Tip

The Arcana Network protocol aggregates multiple social account login identities of Web3 developers under a single user account, allowing them to access their dashboard application settings using any of their social logins.

Step 2: Register Application

Login to the dashboard, use the Create New App wizard and provide the following inputs to register your application with the Arcana Network.

create new app wizard icon

  • App Name: The name of your registered application

Register dApp

Click Create to register your application with the Arcana Testnet (default network).

Tip

After registration, you can change the application entry name by using the pen icon. Click Enter in the editable text field to save the new application entry name.

After a successful registration, you will see the application dashboard screen for 'Testnet' configuration profile (default).

New app dashboard

Application dashboard screen displays per application usage statistics. Use the LHS navigation and choose Configure to view and edit configuration settings. Refer to the next section for details.

Every registered application shows up as a card on the Arcana dashboard Manage Apps screen next to the Create New App wizard. You can view the list of all registered applications for a developer account in the form of cards.

New app card

Step 3: Configure Application

Click Configure in the LHS navigation of the Application dashboard screen. It has the following sections:

  • Branding
  • Social Auth
  • Arcana Wallet

Use defaults or provide inputs for the required settings as per your application use case. These settings control Auth SDK usage, user onboarding and blockchain transaction signing experience.

config details

Click on the tabs below to learn more about various configuration settings for branding, social authentication and Arcana wallet.

Use branding settings to manage the look and feel of the Arcana wallet that shows up in an application context. By default, Arcana wallet displays default branding logo logo and uses the dark theme.

Branding Settings:

  • Upload Logo: Upload light and dark theme branding/logo images and customize the wallet UI that shows up in the context of your application for any authenticated user. You can customize the logo mark that shows in a minimized wallet. You can also customize the horizontal logo that shows up in the top left of the Arcana wallet UI right before the registered application name.
  • Wallet Theme: Choose an appropriate wallet theme for your application. Dark theme is the default.

    Branding

Use the social authentication section to manage user onboarding experience by setting up requisite social login providers. Only the providers that are configured for an application will be enabled in the Auth SDK as options for users to onboard the application.

Example

For example, if you wish to enable Google and Discord login options for your application, make sure you provide the requisite inputs required for these providers in the settings below. You can leave other provider entries as blank.

By default, password-free login is always enabled in the Auth SDK.

Social Auth Settings:

  • Redirect URI: URL auto-generated by Arcana to complete OAuth verification. It needs to be added in the redirect URI for all the social authentication providers that are configured for the dApp.
  • Social Auth: Select dApp user onboarding experience and provide social authentication provider specific configuration details.

    Social OAuth

Use the Arcana wallet section to specify Arcana wallet additional security settings. (Optional)

Arcana Wallet Settings:

  • Wallet: Website Domain - Set our website domain here. It is used for security reasons by the server, to restrict Arcana wallet from loading anywhere else other than the domain you specify. Arcana uses frame-ancestor CSP for restricted domains.

    Social OAuth

Use the shared keyspace section to use default App-specific or Global Keys feature. Global keys allows an application user to have the same wallet address across different applications in the Arcana Network ecosystem. Learn more about App-specific and global keys and use the Arcana Developer Dashboard User Guide to configure shared keyspace.

Keyspace

  • App-Specific: Highly secure but an authenticated user will be assigned unique, different wallet address for every apps in the Arcana Network ecosystem.

  • Global Keys: Less secure but better user experience as an authenticated user will be assigned a unique address that remains the same whether user logs into any application in the Arcana Network ecosystem.

Mainnet Keyspace options

Note

Make sure you save the configuration settings before leaving the dashboard page in your browser.


That is all! ๐ŸŽ‰

You have successfully registered and configured your application.

What's next?

After registering and configuring the application, install the Auth SDK and then integrate it with the application to enable user authentication and signing of Web3 blockchain transactions.

Note

You can copy the assigned App Address once an application is registered and configured using the dashboard. It will be required when you integrate the application with the Auth SDK.

App Address

You can reconfigure application settings for Auth SDK usage later anytime by visiting the Arcana Developer Dashboard. Simply log in, select your app entry and double click on it to view the Configure screen.

See Also


Last update: January 19, 2023 by shaloo