Twitch
In this guide you will learn how to configure your dApp for onboarding users via Twitch authentication.
Prerequisites
- Make sure you can access Arcana Developer Dashboard:
- Install the
@arcana/auth
package. For details, see Arcana Auth Quick Start Guide.
Basic Steps
At a high level, you need to perform these four steps for enabling Twitch OAuth authentication in your dApp. Some of these actions are performed using Twitch Developer Dashboard, others using Arcana Dashboard. Finally, you need to integrate the Arcana Auth SDK and trigger Twitch login for your dApp users.
Step 1: Choose Login Type: Twitch
Go to the Arcana Dashboard:
https://dashboard.beta.arcana.network
tip
If you have already registered your dApp using Arcana Dashboard and obtained an appID, you may skip this step.
Register your dApp by creating a new dApp, specifying a name and choosing your preferred
Storage Region
in the dashboard.You can choose to use defaults for other settings or change them as per your use case. Refer to the how to configure dApp guide for details.
Go to the
Auth
configuration section and copy the redirect URI value displayed there. This will be used in the next step to generate Twitch OAuth credentials.Do not close the dashboard browser tab. Open another tab and setup Twitch OAuth. Then revisit the Dashboard tab for completing dApp configuration settings.
Step 2: Use Twitch Developer Console for OAuth Credentials
- Go to the Twitch Developer Console and register your dApp as a new Twitch application.
- Enter the application name.
- Specify the Redirect URI copied from Arcana Dashboard in the previous step into the OAuth Redirect URL field of the Twitch Developer Console.
- Copy the ClientID and the secret for the newly registered application in the Twitch Developer Console. It will be required in the next step while completing the Arcana dashboard dApp configuration.
Step 3: Update Twitch OAuth Client ID and Secret in the Arcana Dashboard
- Revisit the dashboard
Auth
configuration tab. Refer to the "Twitch" field and paste the Client ID assigned by Twitch Developer Console, in the previous step, in the input text field. - Save the settings. Arcana Network assigns an appID to every registered and configured dApp. If you plan to integrate with Arcana Storage SDK, you need to save this appID.
tip
You can revisit Arcana Dashboard later to view and modify configuration settings. The appID is displayed on the top right of your dashboard.
Step 4: Integrate with Arcana Auth SDK and trigger Twitch login
Use instructions here to integrate with Arcana Auth SDK
Trigger social login for Twitch:
await auth.requestSocialLogin('twitch')
Check if a user is logged in:
const connected = await auth.isLoggedIn()
Log out an authenticated user:
await auth.logout()
That is all! 🎉
Your dApp is all set for onboarding users via Twitch OAuth authentication mechanism.
What's Next?
After enabling Twitch OAuth based user sign in, you can further integrate your dApp with Arcana Storage SDK. This will allow your application to store, retrieve or share files across users. All file store and access operations require file owners to sign blockchain transactions using a wallet provider.
Use the Arcana wallet Ethereum provider exposed by Auth SDK for enabling dApp users to sign file storage related transactions securely.