The project is in a healthy, maintained state
OmniAuth Strategy for TikTok LoginKit
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

omniauth-tiktok-loginkit

rspec rubocop Gem Version

OmniAuth Strategy for TikTok LoginKit

Using TikTok Oauth API v2.

Config

gem "omniauth-tiktok-loginkit"

Configure with CLIENT_KEY and CLIENT_SECRET from TikTok Developers Portal (https://developers.tiktok.com/apps/). Note CLIENT_KEY is the value of "Client Key" field, not "App ID" on the portal.

TikTok requires apps to be approved by review before it can access any APIs, including the Oauth APIs. Also any configuration change to the app will cause it to be back in "Staging" status. So please configure all neccessary "Redirect URI" correctly before submitting a review.

TikTok also rejects any "Test App", so it's better to configure test / dev environment redirect URI on the production app.

Rails.application.config.middleware.use OmniAuth::Builder do
    provider(
        :tiktok_loginkit, 
        CLIENT_KEY, 
        CLIENT_SECRET,
        *options
    )
end

...Or with devise (https://github.com/heartcombo/devise#omniauth)

# config/initializers/devise.rb
config.omniauth(
    :tiktok_loginkit, 
    CLIENT_KEY, 
    CLIENT_SECRET, 
    ...options
)

Options

  • name: change endpoint to /auth/tiktok_another, /auth/tiktok_another/callback. default: "tiktok_login"
  • skip_info: skip User Info API call to retrieve info hash. default: false
  • scope: oauth scopes, seperated by comma. default: "user.info.basic"

Usage

Example of request.env["omniauth.auth"] can be found in the specs:

License

The gem is available as open source under the terms of the MIT License.