Auth: Twitter

The instructions on this page are currently incomplete. Please see the content of the page for reasons why. If you believe you can help, please contact an admin or moderator via the Discord server.

In order to create an application for authentication using Twitter, you must first apply for a developer account.

Apply for a Developer Account

The developer account application portal can be accessed at https://developer.twitter.com/en/portal/petition/use-case.

1. Select "Hobbyist" and then "Exploring the API".
2. You will be asked for basic information about yourself. Fill this out as appropriate.
3. You will be asked to describe how you will use the Twitter API and/or data.
   • Following is a sample text explaining Lorekeeper's use case; you may want to paraphrase this.
   • "I want to allow my users to authenticate using Twitter through the Laravel Socialite system. My site uses social media to verify the identity of users and/or to display their identitie(s) on said social media to other users, and I would like to provide Twitter as an option for my users."
   • Uncheck all the options below.
4. Review your answers and make any necessary adjustments.
5. Review the developer agreement & policy. Agree as you feel appropriate. If/when you are ready, submit your application.
6. You may be asked to verify your email; do so and the application review will begin.
7. Wait for review. You may be asked for further details; provide these as appropriate.

Registering your Application

This section is incomplete pending more thorough documentation of the application registration process.

1. Make Project
2. Make App
   • Include the callback URL
3. Set up 3-legged OAuth
   • https://developer.twitter.com/en/docs/authentication/guides/log-in-with-twitter

Connecting to Lorekeeper

This section is incomplete pending more thorough documentation of the connection process.

In your .env file, add the lines:

TWITTER_CLIENT_ID=your_client_id_here
TWITTER_CLIENT_SECRET=your_client_secret_here

Replacing the client_id and client_secret with the ones from your application.