This article explains the steps required to set up a Twitter Social Sign-On connection with Bevy.
Overview
A Twitter Developer account is required to set up this connection. There are multiple access levels for these accounts, and this set up requires a level of at least Elevated Access.
After you have your Twitter Developer account, you need to create a Project.
After you create a Project, you need to create an Application in the Project, and then configure the Application with your Bevy instance information.
Note: You need the final URL for your instance. The URL can change during implementation.
Create a Twitter Developer account
Sign up for a Twitter Developer account, and then fill out the Twitter developer profile.
To create an account:
- Go to https://developer.twitter.com/, and complete your profile.
- Validate your phone number and email address.
- After your account is created, go to the Twitter Developer Dashboard: https://developer.twitter.com/en/portal/dashboard.
Create a project
Create a project to contain your SSO Application.
- In the Twitter Developer Dashboard, create a new Project. We recommend naming your project Bevy Social Sign On.
- Save your Project.
Create an Application
You can create an Application after you create a Project.
To create an Application:
- After you create a Project, click the +Add App button.
- This screen usually displays automatically after you create a project, but you might need to navigate to your Project.
- Enter an App Name, and then click Next.
- Note: Your final Application should have the App Environment set to Production. This option might not be available until after your account has elevated access. If the App Environment tab doesn't display, the value is set to Development by default. You can test your Twitter SSO application configuration under this environment, but you should create a Production environment application for standard use. You might need to Apply for Elevated status.
- Copy the API Key and Secret Key. Sent these keys to the Bevy Onboarding team using a secure method like Keybase.
- To proceed, click Enable 3rd party authentication.
Configure the Application
After you create the application, complete the following configurations to set up user authentication settings.
To configure the application:
- On the Twitter Developer Dashboard, select the Project your Application belongs to, and then select the Application.
- Under User authentication settings, select Set up.
- Enable the toggle for OAuth 1.0a.
- Bevy only supports OAuth 1.0a.
- In the Callback URI / Redirect URL, field, enter your final Bevy instance URL. Include
/accounts/twitter/login/callback/. For example,https://bevy.com/accounts/twitter/login/callback/.
If you don't include the trailing slash in the Callback URI, the setup will not work. - In the Website URL field, enter your final Bevy instance URL.
- Note: You need the final URL for your instance. The URL can change during implementation.
- Save your changes.
Apply for Elevated Status
Your final Application should have the App Environment set to Production. This option might not be available until after your account has elevated access. If the App Environment tab doesn't display, the value is set to Development by default. You can test your Twitter SSO application configuration under this environment, but you should create a Production environment application for standard use.
To apply for elevated status, go to https://developer.twitter.com/en/portal/products/elevated.
Here's an example of how you could fill it out. Note that Bevy doesn't need any of the specifics toggles enabled.
Find your Application Keys
Application Keys are required to complete this set up. To find your Keys:
- Go to https://developer.twitter.com/en/portal/projects-and-apps.
- Find the Application you created, and then click the key icon.
- Copy the API Key and Secret.