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.
- GitHub
- Twitch
- Discord
Step 1: Developer Dashboard Login
Go to https://dashboard.arcana.network and select a login option on the 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.
To register an app, log in to the dashboard, and click Create New App wizard.
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.
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.
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.
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 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.
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.
Use the Arcana wallet section to specify Arcana wallet's additional security settings. (Optional)
Arcana Wallet Settings:
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.
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.
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
- Configure wallet visibility mode
- Deleting Application Entry
- Managing Testnet and Mainnet Configurations
- Auth Quick Start Guide
- Auth SDK Usage Guide
- Auth SDK Reference Guide