Skip to content

Register & 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 apps using the dashboard. Each registered app is assigned a unique identifier called the Client ID. 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 passwordless 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. This enables developers to log into the dashboard using any of the supported social providers and access the same developer account in the Arcana Network.

Step 2: Register Application

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 displayed as cards.

New app card

To register an app, log in to the dashboard, and click Create New App wizard. create new app wizard icon

You will see a pop-up UI for registering apps. Specify the name of the app to be registered in the App Name field. When you click Create, the app is registered for using the Arcana Testnet by default.

Register dApp

Tip

The name of a registered app entry can be edited by using the pen icon. Click Enter in the editable text field to save app name changes.

After successful registration, the application dashboard screen is displayed. It shows the per-application usage statistics. Click Configure in the LHS menu to view and edit configuration settings. By default, every newly registered app is associated with the 'Testnet' configuration profile.

New app dashboard

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
  • Keyspace (Available only after the 'Mainnet' profile is created)

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 The 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. The 'dark' theme is the default.
    Branding

Use the social authentication section to manage the user onboarding experience by setting up requisite social 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 blank.

By default, passwordless login is always enabled in the Auth SDK.

Multiple Providers

You can enable multiple social providers for an app via the Arcana Developer Dashboard. See configuring social providers and enable user onboarding.

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 by configuring social providers.
    Social OAuth

Use the Arcana wallet section to specify Arcana wallet's 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

Available only for 'Mainnet' Configuration Profile

This tab is visible only if a developer chooses to create a 'Mainnet' configuration profile for the app.

Developers can choose to use App-Specific Keys (default) at the start and change to Global Keys later. However, transitioning between the two will mean that your user's wallet address will change.

Use the Keyspace section to select the App-specific (default) or Global Keys feature. Global keys allow app users 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 keyspace.

Mainnet Keyspace options

Keyspace Types

  • App-Specific: Highly secure but an authenticated user will be assigned a unique, different wallet address for every app 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 the user logs into any application in the Arcana Network ecosystem.

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 Client ID once an application is registered and configured using the dashboard. It will be required when you integrate the application with the Auth SDK.

App unique identifier

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: March 16, 2023 by shaloo, shalz