In this tutorial, you will learn how to configure your dApp and select, enable requisite Arcana SDK features using the Arcana Network developer dashboard. This is the very first thing you need to do before you can use any of the Arcana SDKs such as Auth or Storage.
You need to have one of the supported social OAuth accounts before you can log in and configure your dApp using our dashboard.
Step 1: Developer Dashboard Login
Visit Arcana Network Developer Dashboard:
Choose one of the social OAuth mechanisms displayed on the welcome screen to log into the dashboard.
Step 2: Configure dApp Settings
The very first login to the dashboard brings up 'create new dApp' wizard. Provide the following details to register your dApp:
- dApp name
- Storage Region
Storage region setting is a one time configuration.
You can register your dApp using the Arcana Developer Dashboard:
When you visit the portal for the first time and register your dApp, you will be asked to choose a storage region or keep the default setting. The only way to change the storage region is to delete the dApp from the dashboard and configure afresh.
Once you start using your dApp and users store some data in the Arcana Store, you can always reconfigure the dApp using the dashboard for user storage limit values or enabling / disabling social authentication providers. However, storage region, once set, cannot be altered.
Arcana Network aggregate your multiple social account login identities, meaning if one logs in through different social auth methods (Google, Twitter, Twitch) which all use the same underlying email, they will be treated as a single user. Therefore, in the case of the dashboard, if you want to create multiple apps you would have to log in through a social account which is registered with a different email ID (different to the one already used).
Subsequent logins into the dashboard will simply bring up your previously configured dApp. You can monitor dApp dashboard and view storage usage statistics.
To configure your dApp, check out various Arcana Network SDK settings grouped under tabs on the dashboard. Specify the field values in each tab as per your dApp use case or use defaults, as applicable.
- Auth SDK
- Application Branding / Logo customization
- Control to delete the dApp record from the Arcana blockchain
- Redirect URI: URL auto-generated by Arcana to complete OAth verification. It needs to be added in redirectUri for all the verifiers you want to support.
- Social Auth: Select dApp user onboarding experience and provide verifier specific data.
- Redirect URI - Specify the URL where users of this dApp will be redirected to, once a user clicks on the verification link received from Arcana via email. URL fragments, relative paths, wildcards, and public IP addresses are not supported.
- 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. We use frame-ancestor CSP to restrict domains.
- UI - Configure dApp user experience while signing blockchain transactions for storage operations by selecting the appropriate Arcana wallet UI mode.
- Storage Region: Displays selected region. Cannot be modified once selected.
- Limits: Per user storage and bandwidth limits configured for the dApp.
- Block chain type: (Optional)
Arcana dashboard allows dApp developers to manage the user experience for signing blockchain transactions pertaining to user data storage operations. This is controlled using the WALLET UI setting in the
Auth tab of the dashboard.
WALLET UI mode is set to Disabled. What this means is there will be no pop up UI that requires the user to sign every file storage access operation (share, delete, revoke access, change owner). In this case, the end user experience is very similar to the typical Web2 applications without losing on any security or benefits of blockchain.
Once the UI mode is enabled using the dashboard setting, it cannot be disabled later or reconfigured due to security reasons.
Besides the dashboard setting, there is another control that works in tandem with the dashboard setting to tweak the blockchain transaction signing behavior.
The dApp developer can choose
appMode during Auth SDK initialization function call. Once WALLET UI setting is enabled through the dashboard, the dApp developer can use
appMode in the dApp code when integrating with the Auth SDK. The appMode parameter in the Auth SDK initialization function controls the popup UI type configuration that shows up for dApp users.
Typically, once coded in the dApp it should not be changed. See wallet mode for details on how different
appMode choices can control popup UI behavior and user experience for blockchain transaction signing.
For step by step instructions see how to configure Wallet UI guide.
Once you have successfully configured your dApp using the Arcana Network dashboard, you can view dApp resource usage metrics in the dashboard.
If you have the same email ID associated with various social OAuth applications such as GitHub, Google etc., Arcana Network can identify you, irrespective of the mechanism used to login into the dashboard. By default, Arcana Network can aggregate your social OAuth into a single Arcana identity.
What this means is, if you have the same email ID associated with your Google and Discord accounts, then you can login into Arcana developer dashboard using one social OAuth, configure your dApp and later you can log into Arcana dashboard using a different social OAuth and you will see the same dashboard as your Arcana identity is associated with all your social OAuth. This works only if you your social OAuth uses the same email.
You can reconfigure dApp settings later anytime by visiting developer dashboard and clicking on the Configure menu item on the top right of the screen.
You can refer to dApp appID assigned as part of registration with Arcana Network on the top right of the dashboard.
You can setup social, passwordless or third-party wallet authentication after configuring your dApp. This will enable dApp users to associate with a unique Arcana identity that is based on distributed, secure keys and works for blockchain powered smart contract transaction signing.